GET/v1/balances

List balances

Returns every balance the account holds. Assets with a zero total are omitted unless include_zero=true.

Parameters

booleanOptionalDefault: false

When true, includes assets the account has interacted with even if every component is currently zero.

Returns

A list of Balance objects, one per asset.

Errors

Status	Code	Description
401	`authentication_error`	Missing or invalid API key.

List balances

curl https://api.aeses.io/v1/balances \
-H "x-api-key: sk_live_..."

Response

{
"object": "list",
"data": [
  {
    "object": "balance",
    "asset": "USDC",
    "available": "1250.75",
    "pending": "99.50",
    "locked": "150.00",
    "total": "1500.25",
    "updated_at": 1731600125
  },
  {
    "object": "balance",
    "asset": "BTC",
    "available": "0.02145000",
    "pending": "0.00000000",
    "locked": "0.00000000",
    "total": "0.02145000",
    "updated_at": 1731598000
  }
],
"has_more": false,
"next_cursor": null
}