# Arkham Entity Balances

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

Returns on-chain token balances across multiple blockchains for a named entity (e.g. an exchange or wallet cluster) tracked by Arkham Intelligence.

## Facts

- Endpoint: POST https://api.arkm.com/x402/balances/entity
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-entity-balances-aa8a6e52
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4rQmYUEA9tMDIobdZhBtm

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-entity-balances-aa8a6e52 -d '<json body>'
```

Example prompt: Pull the current on-chain balances for Binance across all chains using Arkham — I want to see each token, its USD value, and how those holdings have changed in the last 24 hours.

## When to prefer this

Use this endpoint when you need comprehensive, multi-chain on-chain balance data for a named entity (exchange, protocol, institution) tracked by Arkham Intelligence. Prefer this over generic blockchain explorers when you want aggregated USD valuation across chains with a single call, or when you need the Arkham entity graph (name, type, social metadata) alongside the balance data. Best for institutional treasury monitoring, exchange reserve tracking, and on-chain due diligence on known crypto entities.

## Known failure modes

- Unknown or unrecognized entity ID returns an empty or error response
- Payment of $1 USDC not received or rejected causes 402 Payment Required
- Rate limiting or quota exceeded results in 429 Too Many Requests
- Entity exists but has no indexed balances on any chain — returns empty balance arrays
- Network or blockchain data lag may cause stale quote timestamps
- Malformed POST body causes 400 Bad Request

## How this service works

Get Arkham token balances for an entity. $1.00 per call.

## Output

A JSON object containing per-chain token balances (with token ID, name, symbol, USD value, raw balance, price, 24h price change, and quote timestamp), entity metadata (name, type, social links, description, tags), per-chain total balances, and a comparison of those totals from 24 hours ago.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cheap": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "If 'true', uses a faster but less real-time balance query (up to 24 hours delayed)."
  },
  "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…"
  },
  "entity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The entity ID to query balances for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "balances": {
   "bsc": [
    {
     "id": "binance-bitcoin",
     "usd": 2658419407.091193,
     "name": "Binance Bitcoin",
     "price": 65027,
     "symbol": "BTCB",
     "balance": 40881.77844727871,
     "quoteTime": "2026-06-22T13:23:37.62Z",
     "priceChange24h": 950,
     "priceChange24hPercent": 1.482591257393448
    }
   ],
   "ethereum": [
    {
     "id": "tether",
     "usd": 40046128192.73723,
     "name": "Tether",
     "price": 1,
     "symbol": "USDT",
     "balance": 40046128192.73723,
     "quoteTime": "2026-06-22T13:24:28.299Z",
     "priceChange24h": 0,
     "priceChange24hPercent": 0
    },
    {
     "id": "usd-coin",
     "usd": 7422685972.66057,
     "name": "USDC",
     "price": 1,
     "symbol": "USDC",
     "balance": 7422685972.66057,
     "quoteTime": "2026-06-22T13:24:30.156Z",
     "priceChange24h": 0,
     "priceChange24hPercent": 0
    }
   ]
  },
  "entities": {
   "binance": {
    "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",
    "description": "",
    "populatedTags": [
     {
      "id": "proof-of-reserves",
      "rank": 20,
      "label": "Binance Proof of Reserves",
      "tagParams": "Binance",
      "disablePage": false,
      "excludeEntities": false
     }
    ]
   }
  },
  "totalBalance": {
   "bsc": 11662208524.03351,
   "ethereum": 66276809360.97472
  },
  "totalBalance24hAgo": {
   "bsc": 11595187303.04529,
   "ethereum": 65932976474.17882
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-entity-balances-aa8a6e52/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)