# Arkham Entity Predictions

> Arkham Entity Predictions 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 predicted entity labels and USD balances for blockchain addresses using Arkham's wallet intelligence model

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/entity-predictions
- 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-entity-predictions-f329f749
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xRmHsZVeHYAfAB-5JZM3F

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-predictions-f329f749 -d '<json body>'
```

Example prompt: Can you check Arkham's entity predictions for wallet address 0x28C6c06298d514Db089934071355E5743bf21d60 and tell me which organization it belongs to and its current USD balance?

## When to prefer this

Choose this endpoint when you need programmatic, pay-per-request blockchain address attribution powered by Arkham's proprietary intelligence graph. It is preferable to generic on-chain lookup tools when you need entity-level labels (exchange, fund, whale) rather than raw transaction data, and when you want USD-denominated balance context alongside the attribution. Best for agents performing due diligence, compliance checks, or counterparty analysis on crypto wallet addresses.

## Known failure modes

- Unknown or unattributed address returns empty entity prediction or null entityID
- Invalid address format causes 400 Bad Request
- Insufficient USDC balance for x402 pay-per-request triggers payment failure
- Rate limiting or API key authentication errors return 401/429
- Address with no on-chain activity may return zero USD balance with low-confidence prediction

## How this service works

Get Arkham predictions for an entity. $0.20 per call.

## Output

A JSON array where each element contains the queried wallet address, the predicted entityID (e.g. 'binance', 'coinbase'), and the current USD balance held by that address. Enables rapid attribution of on-chain addresses to known real-world entities.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "entity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The entity ID to retrieve address predictions for."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "address": "0x28C6c06298d514Db089934071355E5743bf21d60",
   "entityID": "binance",
   "usdBalance": 938079658.6
  }
 ]
}
```

## More

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