Balances

Latest balances and historical balances.

Latest Balances

Allium's latest balance endpoint provides up to date balances of all native and erc20 tokens held by an address. We support passing in multiple chain+address pairs in a single request.

Historical Balances

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

Last updated 23 days ago

Was this helpful?

Get Latest Balances

post

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

Authorizations

Body

chainChainrequired

addressAddressrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '/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

{
  "items": [
    {
      "id": "text",
      "chain": "text",
      "block_timestamp": "2025-02-20T19:08:31.801Z",
      "transaction_hash": "text",
      "transaction_labels": [],
      "asset_transfers": [
        {
          "amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          },
          "transfer_type": "sent",
          "from_address": "text",
          "to_address": "text",
          "from_token_account": "text",
          "to_token_account": "text",
          "asset": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          }
        }
      ],
      "block_number": 1,
      "block_hash": "text",
      "transaction_fee": {
        "raw_amount": "text",
        "amount_str": "text",
        "amount": 1
      },
      "within_block_order_key": 1,
      "activities": [
        {
          "asset_amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          },
          "currency_amount": {
            "raw_amount": "text",
            "amount_str": "text",
            "amount": 1
          },
          "type": "traded_nft",
          "side": "buyer",
          "asset": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          },
          "currency": {
            "type": "native",
            "name": "text",
            "symbol": "text",
            "decimals": 1,
            "token_id": "text",
            "address": "text"
          },
          "marketplace": "text",
          "protocol": "text"
        }
      ]
    }
  ]
}

Successful Response

Get Historical Balances