Sign in
BALANCES
DEVELOPER
WALLET

Historical Fungible Token Balances

Get the historical balances for a list of wallets.

post/api/v1/developer/wallet/balances/history

Query parameters

limitinteger

Max number of items returned. Default is 1000.

Max number of items returned. Default is 1000.

cursorstring

Cursor to request the next page of results.

Cursor to request the next page of results.

Request body

start_timestampstring date-time required

Start of time range (UTC ISO 8601)

end_timestampstring date-time required

End of time range (UTC ISO 8601)

Example request

{
  "addresses": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "chain": "solana"
    }
  ],
  "end_timestamp": "2025-04-01T13:00:00Z",
  "start_timestamp": "2025-04-01T12:00:00Z"
}

Response

Successful Response

cursorstring nullable

Pagination cursor for next page

Example response

{
  "items": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "block_hash": "GrW5zBwRrfTvLtdJHog7rUMcCPQ9K9AYrMKxDhfuD59A",
      "block_slot": 387297060,
      "block_timestamp": "2025-12-17T11:49:10Z",
      "chain": "solana",
      "raw_balance": 2985840,
      "raw_balance_str": "2985840",
      "token": {
        "address": "So11111111111111111111111111111111111111111",
        "chain": "solana",
        "decimals": 9,
        "object": "token",
        "type": "sol_spl"
      },
      "txn_id": "3dzNgD7ksFoZPeeA14rNN3qxvo5WxsDjTE9VVPj8yLm7y6svTatyrbVTmkJPJErSmhbKLVmJFto1oQsCSVbSeDUT",
      "txn_index": 714
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.