# Arkham Entity Balance Changes

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

Returns current and previous USD/unit balances for a crypto entity (e.g. exchange, wallet) broken down by token, enabling detection of balance changes.

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/entity-balance-changes
- Price: $0.4/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-entity-balance-changes-1da0f072
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JjLXST3kDNBAUjpaT-_1S

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-balance-changes-1da0f072 -d '<json body>'
```

Example prompt: Pull the current and previous balance breakdown for Binance from Arkham — I want to see how their Bitcoin and Ethereum holdings have changed, in both USD and native units.

## When to prefer this

Use this endpoint when you need to track balance changes for a named, labeled crypto entity (exchange, fund, whale wallet) identified by Arkham's intelligence graph — particularly when you want per-token USD and unit breakdowns with historical comparison. Prefer this over generic block explorers when you need entity-level attribution (e.g. 'Binance' rather than a raw address) and pre-computed USD valuations.

## Known failure modes

- Unknown or invalid entity ID returns empty array or 404
- Payment failure via x402 results in 402 response and no data
- Rate limiting if too many requests in short period
- Stale data if on-chain indexing is lagged
- Entity with no tracked balances returns empty token balances array

## How this service works

Get Arkham entity balance changes. $0.40 per call.

## Output

An array of entity balance objects, each containing the entity ID, name, type (e.g. 'cex'), current total balance in USD and native units, previous balance in USD and native units, and a nested array of per-token balances (token ID, symbol, current and previous USD and unit balances).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Number of results to return per page. Required; must be between 1 and 100."
  },
  "chains": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "List of chains to filter by."
  },
  "offset": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Number of results to skip from the beginning."
  },
  "orderBy": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Field to sort results by. One of: balanceUsd, balanceUsdChange, balanceUsdPctChange, balanceUnit, balanceUnitChange, ba…"
  },
  "interval": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time interval for balance change calculation. One of '7d', '14d', or '30d'."
  },
  "orderDir": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "typ
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "entityId": "binance",
   "balanceUsd": 128882055209.1815,
   "entityName": "Binance",
   "entityType": "cex",
   "balanceUnit": 2.588710860077077e+30,
   "tokenBalances": [
    {
     "tokenId": "bitcoin",
     "balanceUsd": 42777592075.57917,
     "balanceUnit": 665902.74090254,
     "tokenSymbol": "btc",
     "prevBalanceUsd": 43238665627.32252,
     "prevBalanceUnit": 671251.50395595
    },
    {
     "tokenId": "ethereum",
     "balanceUsd": 7084063789.738129,
     "balanceUnit": 4073033.238123183,
     "tokenSymbol": "eth",
     "prevBalanceUsd": 6660434374.533453,
     "prevBalanceUnit": 3964473.476386405
    }
   ],
   "prevBalanceUsd": 128959949999.76,
   "prevBalanceUnit": 2.588710860077077e+30
  }
 ]
}
```

## More

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