Balances

Latest balances and historical balances.

Latest Balances

Allium's latest balance endpoint provides up to date balances of all native and fungible tokens (ERC20 tokens for EVM, SPL tokens for Solana) held by an address. We support passing in multiple (chain, address)pairs in a single request.

Latest Fungible Token Balances

Get the latest balances for a list of wallets.

post

/api/v1/developer/wallet/latest-balances

Authorizations

APIKeyBearerFirebaseAuthBearerAPIKeyBearerAPIKeyBearer

Body

chainstringrequired

addressstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-server-staging-xjpv5b26pq-uw.a.run.app/api/v1/developer/wallet/latest-balances' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "chain": "text",
      "address": "text"
    }
  ]'

200

422

200

{
  "items": [
    {
      "chain": "text",
      "address": "text",
      "token_address": "text",
      "raw_balance": 1,
      "token_metadata": {
        "price": 1,
        "token_name": "text",
        "token_decimals": 1,
        "symbol": "text"
      },
      "block_timestamp": "2025-03-11T13:40:12.851Z",
      "block_number": 1,
      "block_hash": "text"
    }
  ]
}

Successful Response

Historical Balances

Historical balances can provide the balance of any wallet+token_address pair across time.

Feel free to reach out to [e-mail] to get access to the endpoint.

Historical Fungible Token Balances

Get the historical balances for a list of wallets.

post

/api/v1/developer/wallet/historical-balances

Authorizations

APIKeyBearerFirebaseAuthBearerAPIKeyBearerAPIKeyBearer

Body

chainstringrequired

addressstringrequired

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api-server-staging-xjpv5b26pq-uw.a.run.app/api/v1/developer/wallet/historical-balances' \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '[
    {
      "chain": "text",
      "address": "text"
    }
  ]'

200

422

200

{
  "items": [
    {
      "chain": "text",
      "address": "text",
      "token_address": "text",
      "raw_balance": 1,
      "token_metadata": {
        "price": 1,
        "token_name": "text",
        "token_decimals": 1,
        "symbol": "text"
      },
      "block_timestamp": "2025-03-11T13:40:12.851Z",
      "block_number": 1,
      "block_hash": "text"
    }
  ]
}

Successful Response