Get Balances
List account balances.
This method will use 20
Compute Units.
Returns a timestamped list of account balances on the network, limited to at most 50 token balances per account as outlined in HIP-367. This includes both HBAR and token balances for accounts.
Query parameters
account.idstringOptionalExample:
Account id or account alias with no shard realm or evm address with no shard realm
{"value":"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"}
Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$
account.balancestringOptionalExample:
The optional balance value to compare against
{"summary":"--","value":""}
Pattern: ^((gte?|lte?|eq|ne)\:)?\d{1,10}$
account.publickeystringOptionalExample:
The account's public key to compare against
3c3d546321ff6f63d701d2ec5c277095874e19f4a235bee1e6bb19258bf362be
limitinteger · int32 · min: 1 · max: 100OptionalDefault:
The maximum number of items to return
25
Example: 2
orderundefined · enumOptionalDefault:
The order in which items are listed
desc
Example: asc
Possible values: timestampstring[]OptionalExample:
The consensus timestamp in seconds.nanoseconds format with an optional comparison operator
{"summary":"--","value":""}
Responses
200
OK
application/json
400
Invalid parameter
application/json
get
GET /v1/YOUR_API_KEY/api/v1/balances HTTP/1.1
Host: mainnet.hedera.validationcloud.io
Accept: */*
{
"timestamp": "1586567700.453054000",
"balances": [
{
"account": "0.15.10",
"balance": 80,
"tokens": [
{
"token_id": "0.0.200001",
"balance": 8
}
]
}
],
"links": {
"next": "/api/v1/transactions?timestamp=lt:1657598275.517984411"
}
}
Last updated
Was this helpful?