Skip to main content
POST
/
api
/
v1
/
developer
/
wallet
/
balances
/
history
Historical Fungible Token Balances
curl --request POST \
  --url https://api.allium.so/api/v1/developer/wallet/balances/history \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "addresses": [
    {
      "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp",
      "chain": "solana"
    }
  ],
  "end_timestamp": "2025-04-01T13:00:00Z",
  "start_timestamp": "2025-04-01T12:00:00Z"
}
'
{
  "items": [
    {
      "chain": "<string>",
      "address": "<string>",
      "token": {
        "chain": "<string>",
        "address": "<string>",
        "object": "token",
        "type": "native",
        "price": 123,
        "decimals": 123,
        "info": {
          "name": "<string>",
          "symbol": "<string>"
        },
        "attributes": {
          "total_liquidity_usd": {
            "amount": 123,
            "details": "<string>"
          },
          "price_diff_1d": 123,
          "price_diff_pct_1d": 123,
          "price_diff_1h": 123,
          "price_diff_pct_1h": 123,
          "total_supply": 123,
          "fully_diluted_valuation_usd": 123,
          "volume_1h": 123,
          "volume_1d": 123,
          "volume_usd_1h": 123,
          "volume_usd_1d": 123,
          "volume_24h": 123,
          "volume_usd_24h": 123,
          "trade_count_1h": 123,
          "trade_count_1d": 123,
          "all_time_high": 123,
          "all_time_low": 123,
          "image_url": "<string>",
          "token_creation_time": "2023-11-07T05:31:56Z",
          "holders_count": 123
        }
      },
      "raw_balance": 123,
      "block_timestamp": "2023-11-07T05:31:56Z",
      "block_slot": 123,
      "txn_index": 123,
      "token_account": "<string>",
      "block_hash": "<string>",
      "txn_id": "<string>"
    }
  ],
  "cursor": "<string>"
}
Supported Chains

Authorizations

X-API-KEY
string
header
required

Query Parameters

limit
integer
default:1000

Max number of items returned. Default is 1000. Max number of items returned. Default is 1000.

cursor
string

Cursor to request the next page of results. Cursor to request the next page of results.

Body

application/json

List of wallet chain+address pairs and a start and end timestamp to fetch historical balances for.

start_timestamp
string<date-time>
required
end_timestamp
string<date-time>
required
addresses
PayloadAddress · object[]
required

Response

Successful Response

items
(SolanaBalances · object | BitcoinBalances · object | EVMWalletBalances · object | NearWalletBalances · object | LegacyEVMWalletBalances · object | LegacySolanaBalances · object)[]
required
  • SolanaBalances
  • BitcoinBalances
  • EVMWalletBalances
  • NearWalletBalances
  • LegacyEVMWalletBalances
  • LegacySolanaBalances
cursor
string | null