# Arkham Intelligence Tag Updates

> Arkham Intelligence Tag 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-14).

Returns a paginated feed of recently created or updated blockchain address tags from Arkham's wallet intelligence database.

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/tags/updates
- Price: $6/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-tag-updates-3e6f6a84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_11NOQWsZ9QUqMx0PdEY5U

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-tag-updates-3e6f6a84 -d '<json body>'
```

Example prompt: Pull the latest Arkham tag updates — I want to see any newly added or changed address classifications, including airdrop recipient clusters or brokerage tags, and page through them if there are more results.

## When to prefer this

Use this endpoint when you need to stay current with Arkham's evolving on-chain address classification system — specifically to detect newly created tags or updates to existing ones. Prefer this over static address lookup endpoints when your goal is change detection or syncing a local copy of Arkham's tag database. It is the right choice for building intelligence pipelines that react to new entity classifications like airdrop clusters, exchange wallets, or brokerage addresses.

## Known failure modes

- Invalid or expired page token returns an error or restarts pagination
- Payment failure via x402 protocol results in 402 response and no data returned
- Malformed POST body may result in 400 Bad Request
- Rate limiting if too many requests are made in rapid succession
- Empty result set if no tags have been updated since the last poll

## How this service works

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

## Output

Returns a JSON object containing a list of tag update items, each with fields including tag ID, name, category, description, rank, status (new or updated), diff timestamp, entity count, and address count. Also includes a hasMore boolean, a pageToken for pagination, and a latest_diff_ts timestamp indicating the most recent update 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'."
  },
  "tagId": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Tag IDs to filter by. Max 100."
  },
  "status": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": "pengu-airdrop-recipient-cluster",
    "rank": 53,
    "status": "new",
    "diff_ts": "2025-01-24T03:14:00Z",
    "category": "Airdrop",
    "diff_seq": 1,
    "tag_name": "Pengu Airdrop Recipient Cluster",
    "template": "Pengu Airdrop Recipient Cluster: %s",
    "description": "Addresses who received the $PENGU airdrop",
    "entity_count": 5963,
    "address_count": 336199
   },
   {
    "id": "brokerage",
    "rank": 5,
    "status": "updated",
    "diff_ts": "2025-01-26T06:50:00Z",
    "category": "Other",
    "diff_seq": 1,
    "tag_name": "Brokerage",
    "template": "Brokerage",
    "description": "Addresses associated with prime brokerage entities that offer a suite of services for institutional clients including lending, leveraged trade executions, OTC deals, and asset management",
    "entity_count": 0,
    "address_count": 1
   }
  ],
  "hasMore": true,
  "pageToken": "eyJkIjoiMjAyNS0xMi0xOVQwNTozMzowMFoiLCJxIjoyOX0=",
  "latest_diff_ts": "2025-12-19T05:33:00Z"
 }
}
```

## More

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