# Arkham Transfers API

> Arkham Transfers API is a paid API for AI agents from api.arkm.com, paid per call via x402, $8/call, status unknown (last checked 2026-09-16).

Fetches on-chain token transfer records filtered by address, entity, chain, and direction using Arkham's wallet intelligence data

## Facts

- Endpoint: POST https://api.arkm.com/x402/transfers
- Price: $8/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-transfers-api-12dad64c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KfKH4Hbr0NdUiUmEJW7N2

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-transfers-api-12dad64c -d '<json body>'
```

Example prompt: Pull the last 50 token transfers from Arkham involving the address 0x91F1D2c2165B17a1eD2dC3B73Ae77224E6e1410E on Polygon, showing both inflows and outflows with USD values and entity labels.

## When to prefer this

Choose this endpoint when you need detailed on-chain transfer history with Arkham's proprietary entity labeling (mapping raw addresses to named organizations, exchanges, or protocols). It is superior to raw blockchain explorers when you need to filter by entity name rather than raw address, or when you want USD-denominated historical values alongside transfer records across multiple chains in a single query.

## Known failure modes

- Invalid or unrecognized wallet address format returns empty results
- Unsupported chain identifier causes filter to return no matches
- Exceeding the 1650 result limit silently caps the response
- Insufficient USDC balance for x402 payment causes request rejection
- Malformed body schema returns a 400 error
- Unknown entity name in from/to filter returns zero results

## How this service works

Get Arkham transfers with filters. Priced per row: $0.40 × limit (default 20, max 1650); pass the smallest useful limit.

## Output

Returns a paginated list of on-chain transfer records including transaction hash, from/to addresses with Arkham entity labels, token name and symbol, USD value at time of transfer, block number and timestamp, chain, and total count of matching records.

## 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": "Filter to any of these addresses, entities, or deposit services. Prefix a value with '!' to exclude it, 'type:' to filt…"
  },
  "base": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter from or to any of these entities or addresses. Prefix a value with '!' to exclude it, or 'type:' to filter by en…"
  },
  "flow": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Transfer direction: 'in' (incoming), 'out' (outgoing), 'self' (self-transfers), or 'all'. Default: all."
  },
  "from": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter from any of these addresses, entities, or deposit services. Prefix a value with '!' to exclude it, 'type:' to fi…"
  },
  "limit": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum number of results to return. Default: 20. Max: 1650."
  },
  "chains": {
   "anyOf": [
    {
     "type": "st
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10000,
  "transfers": [
   {
    "id": "0x9658342c379a1c29022ccad9fa5f0daaebc6c4efddb61f8dceab81b21b6546c7_8",
    "type": "",
    "chain": "polygon",
    "tokenId": "polygon-pos-bridged-dai-polygon-pos",
    "blockHash": "0x7260059ed1619d4a6c6d632a15533c1e7bbc9dcc7c6aaac31bff9b6232c32e81",
    "toAddress": {
     "chain": "polygon",
     "address": "0x91F1D2c2165B17a1eD2dC3B73Ae77224E6e1410E",
     "contract": true,
     "arkhamEntity": {
      "id": "originworld",
      "name": "ORIGIN",
      "note": "",
      "type": "misc",
      "service": null,
      "twitter": "https://x.com/SaluteOrigin",
      "website": "https://originworld.org"
     },
     "isUserAddress": false
    },
    "tokenName": "(PoS) Dai Stablecoin",
    "unitValue": 0.3078786240074625,
    "blockNumber": 90635107,
    "fromAddress": {
     "chain": "polygon",
     "address": "0xA304823C775d13fc851379C75e2b6f300E223234",
     "contract": true,
     "arkhamLabel": {
      "name": "TransparentUpgradeableProxy",
      "address": "0xA304823C775d13fc851379C75e2b6f300E223234",
      "chainType": "evm"
     },
     "arkhamEntity": {
      "id": "originworld",
      "name": "ORIGIN",
      "note": "",
      "type": "misc",
      "service": null,
      "twitter": "https://x.com/SaluteOrigin",
      "website": "https://originworld.org"
     },
     "isUserAddress": false
    },
    "tokenSymbol": "DAI",
    "toIsContract": true,
    "tokenAddress": "0x8f3Cf7ad23Cd3CaDbD9735AFf958023239c6A063",
    "historicalUSD": 0.3078786240074625,
    "tokenDecimals": 18,
    "blockTimestamp": "2026-07-21T18:14:18Z",
    "fromIsContract": true,
    "transactionHash": "0x9658342c379a1c29022ccad9fa5f0daaebc6c4efddb61f8dceab81b21b6546c7"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-transfers-api-12dad64c/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)