# Arkham Intelligence Address Updates

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

Returns paginated updates to Arkham's labeled blockchain address database, including new and changed wallet labels, entity associations, and token tags across chains.

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/addresses/updates
- Price: $20/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-intelligence-address-updates-2fa3dd27
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l1iOgGa1TkfxyaMWu8tLg

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-address-updates-2fa3dd27 -d '<json body>'
```

Example prompt: Pull the latest Arkham address label updates on Arbitrum One — give me newly labeled wallets and entity names that have changed since January 1, 2025, starting from the beginning of the feed.

## When to prefer this

Choose this endpoint when you need to incrementally sync or monitor Arkham's address intelligence database — specifically to detect newly labeled wallets, updated entity attributions, or new token/DEX tags across chains. Prefer it over static lookups when your use case requires staying current with Arkham's labeling as it evolves, or when building a local mirror of Arkham's address data. It is paginated and cursor-driven, making it suitable for bulk ingestion pipelines.

## Known failure modes

- Invalid or expired pageToken returns an error or resets pagination
- Missing or invalid API key / x402 payment returns 402 or 401
- Requesting an unsupported chain returns empty results or an error
- Payment of less than $20 USDC rejected by x402 facilitator
- Rate limiting if too many requests are sent in quick succession
- Network timeout on large paginated result sets

## How this service works

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

## Output

A paginated JSON response containing a list of address update items, each with: chain, address, label, status (new/updated), diff timestamp, diff sequence number, entity ID/name/type, service flag, populated tag objects (with rank, label, chain, tag params), deposit exchange ID, plus a hasMore flag, pageToken for next page, and latest_diff_ts for cursor advancement.

## 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…"
  },
  "chain": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Blockchain networks to filter by."
  },
  "label": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter by address label."
  },
  "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
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "chain": "arbitrum_one",
    "label": "Cortex (CX)",
    "status": "new",
    "address": "0x000000000000012DeF132E61759048bE5b5C6033",
    "diff_ts": "2025-01-01T00:00:00Z",
    "service": false,
    "diff_seq": 1,
    "entity_id": null,
    "entity_name": null,
    "entity_type": null,
    "populated_tags": [
     {
      "id": "token-label",
      "rank": 380,
      "chain": "arbitrum_one",
      "label": "%s",
      "tagParams": "Cortex (CX)",
      "disablePage": true,
      "excludeEntities": true
     },
     {
      "id": "token-standard",
      "rank": 300,
      "chain": "arbitrum_one",
      "label": "%s Token",
      "tagParams": "ERC20",
      "disablePage": true,
      "excludeEntities": true
     }
    ],
    "deposit_exchange_id": null
   },
   {
    "chain": "arbitrum_one",
    "label": "V3 Pool",
    "status": "new",
    "address": "0x000BAE686D6f10C9715593bD9d06cc03E7529c18",
    "diff_ts": "2025-01-01T00:00:00Z",
    "service": false,
    "diff_seq": 39,
    "entity_id": "uniswap",
    "entity_name": "Uniswap",
    "entity_type": "dex",
    "populated_tags": [
     {
      "id": "dex",
      "rank": 50,
      "chain": "arbitrum_one",
      "label": "Decentralized Exchange",
      "disablePage": false,
      "excludeEntities": false
     }
    ],
    "deposit_exchange_id": null
   }
  ],
  "hasMore": true,
  "pageToken": "eyJkIjoiMjAyNS0wMS0wMVQwMDowMDowMFoiLCJxIjoxMDB9",
  "latest_diff_ts": "2025-01-01T00:00:00Z"
 }
}
```

## More

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