# Arkham x402 Wallet Balances

> Arkham x402 Wallet Balances is a paid API for AI agents from api.arkm.com, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-16).

Returns token balances across multiple chains for one or more blockchain addresses, enriched with Arkham entity and label intelligence.

## Facts

- Endpoint: POST https://api.arkm.com/x402/balances/address
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-wallet-balances-7745fd79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Tzm3_Fmd8JiHZXJaLpeeO

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 arkham-x402-wallet-balances-7745fd79 -d '<json body>'
```

Example prompt: What tokens and USD balances does wallet 0x28C6c06298d514Db089934071355E5743bf21d60 hold on Ethereum and BSC right now, and which entity does Arkham say owns it?

## When to prefer this

Choose this endpoint when you need multi-chain token balances enriched with Arkham's proprietary entity intelligence (exchange labels, fund identifications, etc.) in a single call. Prefer it over generic blockchain RPC calls when entity attribution matters, or over block explorers when you need structured, USD-denominated data with price context. Best for on-chain research, compliance checks, and portfolio analysis where knowing who owns the wallet is as important as what it holds.

## Known failure modes

- Invalid or malformed address returns an error or empty balances
- Address with no on-chain activity returns empty balance arrays
- Unsupported chain not included in response
- Payment failure via x402 protocol results in 402 response with no data
- Rate limiting or quota exhaustion returns appropriate HTTP error
- Network or RPC latency may cause stale quote timestamps

## How this service works

Get Arkham token balances for an address. $0.20 per call.

## Output

A JSON object containing per-chain token balances (with USD value, raw balance, token price, 24h price change, quote timestamp, and Ethereum contract address), plus address-level metadata including Arkham entity identification (name, type, social links) and Arkham label (e.g. 'Hot Wallet').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chains": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Chains to filter by, as a single comma-separated value (e.g. 'ethereum,bsc'). If omitted, returns balances across all s…"
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The blockchain address to query balances for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "balances": {
   "bsc": [
    {
     "id": "binance-bridged-usdt-bnb-smart-chain",
     "usd": 3734.28585101,
     "name": "Tether USD",
     "price": 1,
     "symbol": "USDT",
     "balance": 3734.28585101,
     "quoteTime": "2026-07-06T08:56:06.003Z",
     "balanceExact": "3734285851010000000000",
     "priceChange24h": 0,
     "ethereumAddress": "0x55d398326f99059fF775485246999027B3197955",
     "priceChange24hPercent": 0
    }
   ],
   "ethereum": [
    {
     "id": "tether",
     "usd": 933180509.069545,
     "name": "Tether USD",
     "price": 1,
     "symbol": "USDT",
     "balance": 933180509.069545,
     "quoteTime": "2026-07-06T08:56:21.074Z",
     "balanceExact": "933180509069545",
     "priceChange24h": 0,
     "ethereumAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
     "priceChange24hPercent": 0
    },
    {
     "id": "ethereum",
     "usd": 466106814.4910013,
     "name": "Ethereum",
     "price": 1764.02,
     "symbol": "ETH",
     "balance": 264229.8922296807,
     "quoteTime": "2026-07-06T08:56:12.855Z",
     "balanceExact": "264229892229680683921876",
     "priceChange24h": -2.220000000000027,
     "priceChange24hPercent": -0.1256907328562385
    }
   ]
  },
  "addresses": {
   "bsc": {
    "0x28C6c06298d514Db089934071355E5743bf21d60": {
     "chain": "bsc",
     "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
     "contract": false,
     "arkhamLabel": {
      "name": "Hot Wallet",
      "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
      "chainType": "evm"
     },
     "arkhamEntity": {
      "id": "binance",
      "name": "Binance",
      "note": "",
      "type": "cex",
      "service": null,
      "twitter": "https://twitter.com/binance",
      "website": "https://binance.com",
      "linkedin": "https://www.linkedin.com/company/binance",
      "crunchbase": "https://www.crunchbase.com/organization/binance"
     },
     "isUserAddress": false
    }
   },
   "ethereum": {
    "0x28C6c06298d514Db089934071355E5743bf21d60": {
     "chain": "ethereum",
     "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
     "contract": false,
     "arkhamLabel": {
      "name": "Hot Wallet",
      "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
      "chainType": "evm"
     },
     "arkhamEntity": {
      "id": "binance",
      "name": "Binance",
      "note": "",
      "type": "cex",
      "service": null,
      "twitter": "https://twitter.com/binance",
      "website":
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-wallet-balances-7745fd79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.arkm.com](https://www.zero.xyz/host/api.arkm.com/llms.txt)