# Allium Wallet Token Balances

> Allium Wallet Token Balances is a paid API for AI agents from agents.allium.so, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns current token balances for a given blockchain wallet address

## Facts

- Endpoint: POST https://agents.allium.so/api/v1/developer/wallet/balances
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agents-allium-so-e65b7b5d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2ax-8nkVu2e-fzCBuzBXx

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-allium-so-e65b7b5d -d '<json body>'
```

Example prompt: What tokens does wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 currently hold, and what are the balances for each?

## When to prefer this

Use this endpoint when you need real-time, current token balances for a specific wallet address on supported blockchains. Prefer this over transaction history endpoints when you only need the current state of holdings, not historical activity. Best for portfolio snapshots, DeFi position checks, and balance verification tasks.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain returns no results or error
- Wallet with no token holdings returns an empty list
- Payment failure (x402) if USDC balance is insufficient
- Rate limiting if too many requests are made

## How this service works

Get current wallet token balances

## Output

A list of token balances for the specified wallet address, including token symbols, amounts, and likely USD-denominated values for each holding across supported chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body",
    "method"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "chain",
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network (e.g. ethereum, solana, base)"
      },
      "address": {
       "type": "string",
       "description": "Wallet address"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "chain": "ethereum",
    "token": {
     "info": {
      "name": "Wrapped Ether",
      "symbol": "WETH"
     },
     "type": "evm_erc20",
     "chain": "ethereum",
     "price": 2500.5,
     "object": "token",
     "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
     "decimals": 18
    },
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "raw_balance": 1500000000000000000,
    "block_number": 20000000,
    "block_timestamp": "2025-06-17T18:00:00Z",
    "raw_balance_str": "1500000000000000000"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-allium-so-e65b7b5d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.allium.so](https://www.zero.xyz/host/agents.allium.so/llms.txt)