# Arkham Intelligence Entity Updates

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

Retrieves paginated updates to blockchain entity profiles (wallets, exchanges, hackers, etc.) with on-chain metrics and metadata changes since a given timestamp.

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/entities/updates
- Price: $6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-intelligence-entity-updates-437ce5d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GArq2ZuJaFN4gEo4I5nBw

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-intelligence-entity-updates-437ce5d8 -d '<json body>'
```

Example prompt: Pull the latest entity updates from Arkham Intelligence — give me everything that changed after January 1 2025, including hackers, exchanges, and any other labeled entities with their balances and volumes.

## When to prefer this

Use this endpoint when you need a chronological feed of changes to Arkham's labeled blockchain entity database — ideal for building pipelines that sync entity metadata, detect newly labeled wallets (especially threat actors), or track on-chain metric changes over time. Prefer this over point-lookup endpoints when you need bulk or delta updates across many entities rather than querying a single known address.

## Known failure modes

- Invalid or expired page token returns an error or resets pagination
- Missing required POST body fields may return 400 Bad Request
- Payment failure via x402 (insufficient USDC balance) blocks the request
- Rate limiting or authentication failure returns 401/402/429
- Requesting a diff_ts too far in the past may return empty results or a range error
- No updates available since the given timestamp returns an empty items array with hasMore false

## How this service works

Get Arkham entity intelligence updates. Provide at least one of: since, from. $6.00 per call.

## Output

A paginated JSON list of entity update records, each containing the entity's Arkham ID, human-readable name, type (e.g. hacker, cex), status (e.g. new), the timestamp of the change, sequence number, and on-chain metrics (last/first transaction timestamps, total volume in USD, current balance in USD, number of associated addresses). CEX and named entities may also include Twitter, website, and LinkedIn URLs. The response includes a hasMore flag, a pageToken for continuation, and the latest diff timestamp seen.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "to": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "End of time window (use with 'from', max 7-day window). Provide together with 'from' as an alternative to 'since'; mutu…"
  },
  "from": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Start of time window (use with 'to', max 7-day window). Provide together with 'to' as an alternative to 'since'; mutual…"
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum results to return (1-1000, default 100)."
  },
  "since": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Returns changes since this time. Required unless both 'from' and 'to' are provided; mutually exclusive with 'from'/'to'."
  },
  "status": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter by change status."
  },
  "orderBy": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
   
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "blockchain-bandit",
    "name": "Blockchain Bandit",
    "type": "hacker",
    "status": "new",
    "diff_ts": "2025-01-01T03:31:00Z",
    "metrics": {
     "last_tx": "2026-02-06T19:37:41Z",
     "first_tx": "2016-02-14T15:59:14Z",
     "volume_usd": 528350643.2299999,
     "balance_usd": 99992288.09,
     "address_count": 15
    },
    "diff_seq": 1
   },
   {
    "id": "cryptex-net",
    "name": "Cryptex",
    "type": "cex",
    "status": "new",
    "diff_ts": "2025-01-07T04:12:00Z",
    "metrics": {
     "last_tx": "2026-02-12T16:10:36Z",
     "first_tx": "2018-04-17T19:34:08Z",
     "volume_usd": 4594517787.85998,
     "balance_usd": 5078693.820000242,
     "address_count": 2096
    },
    "diff_seq": 1,
    "twitter_url": "https://x.com/cryptex_net",
    "website_url": "https://cryptex.net",
    "linkedin_url": "https://www.linkedin.com/company/cryptexnet/about"
   }
  ],
  "hasMore": true,
  "pageToken": "eyJkIjoiMjAyNS0wMS0xNFQwMzozNDowMFoiLCJxIjo5MH0=",
  "latest_diff_ts": "2025-01-14T03:34:00Z"
 }
}
```

## More

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