Query Parameters

account.id

string

The account id or account alias with no shard realm or evm address with no shard realm

account.balance

string

The optional balance value to compare against

account.publickey

string

The account's public key to compare against

limit

integer

The maximum number of items to return

order

string

The order in which items are listed (asc or desc)

timestamp

array

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator

Returns

timestamp

string

The timestamp at which the balances are retrieved (in seconds.nanoseconds format)

balances

array

An array of objects, each representing the balance information for a specific account

account

string

The account ID for which the balance information is provided

balance

integer

The balance of the account in tinybars

tokens

array

An array of objects, each representing the token balance information for the account

token_id

string

The ID of the token

balance

integer

The balance of the token in the account

links

object

An object containing pagination links

next

string | null

The URL for the next set of results if available

Request

1
curl 'https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances'

1
curl 'https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances'

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
import requests
2

3
url = "https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
import requests
2

3
url = "https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.hedera-testnet.quiknode.pro/api/v1/balances")
5

6
https = Net::HTTP.new(url.host, url.port)
7
https.use_ssl = true
8

9
request = Net::HTTP::Get.new(url)
10

11
response = https.request(request)
12
puts response.read_body
13

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free