Get Balances

List account balances

List account balances

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.

GEThttps://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/balances

Query parameters

Response

200400

OK

Body

application/json

timestampnullable TimestampNullable (string)

balancesarray of AccountBalance (object)

linksLinks (object)

Request

JavaScriptCurl

const response = await fetch('https://mainnet.hedera.validationcloud.io/v1/YOUR_API_KEY/api/v1/balances', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "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"
  }
}