Skip to main content
GET
/
api
/
v1
/
balances
List account balances
curl --request GET \
  --url https://mainnet.mirrornode.hedera.com/api/v1/balances
{
  "timestamp": "1586567700.453054000",
  "balances": [
    {
      "account": "0.15.10",
      "balance": 80,
      "tokens": [
        {
          "token_id": "0.0.200001",
          "balance": 8
        }
      ]
    }
  ],
  "links": {
    "next": null
  }
}

Query Parameters

account.id
string

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
default:25

The maximum number of items to return

Required range: 1 <= x <= 100
order
enum<string>
default:desc

The order in which items are listed

Available options:
asc,
desc
timestamp
string[]

The consensus timestamp as a Unix timestamp in seconds.nanoseconds format with an optional comparison operator. See unixtimestamp.com for a simple way to convert a date to the 'seconds' part of the Unix time.

Response

OK

timestamp
string | null

A Unix timestamp in seconds.nanoseconds format

Example:

"1586567700.453054000"

balances
object[]