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

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 | null

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 | null

The URL for the next set of results if available

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free