/api/v1/tokens/{tokenId}/balances REST API Endpoint
Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.
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
1curl 'https://docs-demo.hedera-mainnet.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