# Arkham x402 Token Balance

> Arkham x402 Token Balance 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-15).

Returns the token balance, current price, and USD value for a specific crypto token in a wallet, billed per-request via x402.

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/balance
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-x402-token-balance-134e0ad4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OHcA7B9IRNJSSmJhzBqAP

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-token-balance-134e0ad4 -d '<json body>'
```

Example prompt: What's the USDC balance of wallet address 0xAbC...123 right now, and what's it worth in USD?

## When to prefer this

Use this endpoint when you need real-time, per-token balance data tied to Arkham's wallet intelligence layer, especially when you want both the raw on-chain balance and a USD-denominated valuation in one call. Prefer this over generic blockchain RPC queries when you need price data alongside balance, or when building pay-as-you-go agent workflows using x402 micropayments.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported token symbol results in no data or error response
- Insufficient x402 payment causes request to be rejected
- Rate limiting if too many requests are made in quick succession
- Network or RPC issues may cause stale or unavailable balance data

## How this service works

Get Arkham token balance by pricing ID or chain/address. $0.20 per call.

## Output

A JSON object containing the token's name, symbol, current USD price, raw balance amount, and total USD value for the queried wallet and token. Example: {"usd": 0, "name": "USD Coin", "price": 0.99993, "symbol": "USDC", "balance": 0, "pricingID": "usd-coin"}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The CoinGecko pricing ID of the token."
  },
  "chain": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Blockchain network where the token is deployed."
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Addresses to query the balance for, passed as a single comma-separated string, e.g. '0x28C6…,0x21a3…' (not a JSON array…"
  },
  "entityID": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Entity ID to query the balance for. Provide either entityID or address; if both are given, address takes precedence and…"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "usd": 0,
  "name": "USD Coin",
  "price": 0.99993,
  "symbol": "USDC",
  "balance": 0,
  "pricingID": "usd-coin"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-token-balance-134e0ad4/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)