# Arkham Intelligence Address Tag Updates

> Arkham Intelligence Address Tag 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 a paginated list of changes (new/deleted) to on-chain address tags across supported blockchains, including tag names, categories, and associated entity metadata.

## Facts

- Endpoint: POST https://api.arkm.com/x402/intelligence/address-tags/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-tag-updates-7199fdf9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wgpl0j-klHamh_3U50BXK

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-tag-updates-7199fdf9 -d '<json body>'
```

Example prompt: Pull the latest address tag updates from Arkham for Arbitrum One — I want to see which wallet addresses have been newly labeled or had labels removed, starting from the most recent changes.

## When to prefer this

Use this endpoint when you need to track incremental changes to Arkham's address intelligence database — specifically which wallets have been newly tagged or had tags removed — rather than querying static tags for a known address. Prefer this for building surveillance pipelines, enriching watchlists with fresh labels, or detecting newly identified entities across supported blockchains.

## Known failure modes

- Invalid or expired page token returns an error or resets pagination
- Unsupported chain identifier results in empty results or 400 error
- Missing or invalid x402 payment header causes 402 Payment Required response
- Rate limiting or payment failure interrupts paginated streaming
- No updates available for the requested time window returns empty items array

## How this service works

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

## Output

A paginated JSON response containing a list of address tag change events, each with the blockchain address, chain, tag ID, tag name, tag category, status (new or deleted), timestamp of the change, optional entity name/type, and a pageToken for fetching the next page. A `hasMore` flag indicates whether additional pages exist.

## 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."
  },
  "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"
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "rank": 140,
    "chain": "arbitrum_one",
    "status": "new",
    "tag_id": "arbitrum-one-first-funder",
    "address": "0x000000000000000000000000000000000000800A",
    "diff_ts": "2025-01-01T02:52:00Z",
    "category": "Other",
    "diff_seq": 1,
    "tag_name": "Arbitrum One First Funder",
    "template": "Arbitrum One First Funder: %s",
    "tag_params": "0x35e14525280193cb71e8204cABafCf10F7e5Dc25"
   },
   {
    "rank": 540,
    "chain": "arbitrum_one",
    "label": "494119.eth",
    "status": "deleted",
    "tag_id": "early-token-holder",
    "address": "0x000072ba5D51098b904A927ddE54C22aD480B5B5",
    "diff_ts": "2025-01-01T02:52:00Z",
    "category": "Other",
    "diff_seq": 13,
    "tag_name": "Early Token Holder",
    "template": "Early %s Holder",
    "entity_id": "0xdyno",
    "tag_params": "GEM",
    "entity_name": "@0xDyno",
    "entity_type": "individual"
   }
  ],
  "hasMore": true,
  "pageToken": "eyJkIjoiMjAyNS0wMS0wMVQwMjo1MjowMFoiLCJxIjoxMDB9",
  "latest_diff_ts": "2025-01-01T02:52:00Z"
 }
}
```

## More

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