Skip to main content
POST
/
api
/
v1
/
developer
/
wallet
/
balances
Latest Fungible Token Balances
curl --request POST \
  --url https://api.allium.so/api/v1/developer/wallet/balances \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
[
  {
    "chain": "<string>",
    "address": "<string>"
  }
]
'
{
  "items": [
    {
      "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
      "block_hash": "0x1d8a87d3da939280fe80fff6b90d19ca629726a1e53849766cb82f57d3fdb836",
      "block_number": 23145508,
      "block_timestamp": "2025-08-15T09:22:23Z",
      "chain": "ethereum",
      "raw_balance": 1300000000000000000,
      "raw_balance_str": "1300000000000000000",
      "token": {
        "address": "0x0e7667a943b871835f7399e7a5adb14f70717c7e",
        "chain": "ethereum",
        "decimals": 18,
        "info": {
          "name": "ETH",
          "symbol": "ETH"
        },
        "object": "token",
        "type": "evm_erc20"
      }
    }
  ],
  "cursor": "<string>"
}
Supported Chains

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
with_liquidity_info
boolean
default:false

If true, returns total_liquidity_usd as well. See this page for more details.

Body

application/json
Required array length: 1 - 100 elements
​
chain
string
required

Lowercase chain name

​
address
string
required

Wallet address

Example:
{
  "chain": "ethereum",
  "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917"
}

Response

Successful Response

​
items
(EVMWalletBalances · object | SolanaBalances · object | BitcoinBalances · object | NearWalletBalances · object | SuiWalletLatestBalances · object)[]
required

Token balance entries

Example:
{
  "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
  "block_hash": "0x1d8a87d3da939280fe80fff6b90d19ca629726a1e53849766cb82f57d3fdb836",
  "block_number": 23145508,
  "block_timestamp": "2025-08-15T09:22:23Z",
  "chain": "ethereum",
  "raw_balance": 1300000000000000000,
  "raw_balance_str": "1300000000000000000",
  "token": {
    "address": "0x0e7667a943b871835f7399e7a5adb14f70717c7e",
    "chain": "ethereum",
    "decimals": 18,
    "info": { "name": "ETH", "symbol": "ETH" },
    "object": "token",
    "type": "evm_erc20"
  }
}
​
cursor
string | null

Pagination cursor for next page