Skip to main content

/api/v1/tokens/{tokenId}/balances REST API Endpoint

Returns a list of token balances given the id. This represents the token supply distribution across the network

Updated on
Dec 18, 2024

/api/v1/tokens/{tokenId}/balances REST API Endpoint

Path Parameters

tokenId
string
REQUIRED
The network entity ID in the format of shard.realm.num

Query Parameters

account.balance
string
The optional balance value to compare against
account.id
string
The ID of the account to return information for
account.publickey
string
The account alias or account id or evm address
account.balance
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 when the balance information was retrieved
balances
array
An array of objects, each representing the balance of a specific account
account
string
The unique identifier of the account
balance
integer
The balance of the account
decimals
integer
The number of decimal places for the balance
links
object
An object containing pagination links
next
string
The URL for the next set of results if available
Request
1
curl 'https://docs-demo.hedera-testnet.quiknode.pro/api/v1/tokens/0.15.2/balances'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free