Skip to main content

/api/v1/balances REST API Endpoint

List account balances

Updated on
Aug 23, 2024

/api/v1/balances REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

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
object
An array of objects, each representing the token balance information for the account
token_id
integer
The ID of the token
balance
integer
The balance of the token in the account
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-mainnet.quiknode.pro/api/v1/balances'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free