# Arkham x402 Swaps

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

Retrieves on-chain token swap transactions with Arkham entity/label intelligence, including sender/receiver wallet attribution and USD values.

## Facts

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

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-x402-swaps-76b0078d -d '<json body>'
```

Example prompt: Pull the latest swaps involving Wintermute on Ethereum from Arkham — I want to see which token pairs they've been trading, the USD values, and sender/receiver labels.

## When to prefer this

Use this endpoint when you need on-chain DEX swap data enriched with Arkham's proprietary entity and label intelligence — particularly when identifying which known funds, market makers, or labeled wallets are behind specific swaps. Prefer this over raw blockchain RPC calls or generic DEX APIs when entity attribution is important, or when you need USD-denominated swap values alongside wallet identity context.

## Known failure modes

- Insufficient USDC balance for x402 payment results in 402 Payment Required
- Invalid or unsupported chain identifier returns 400 Bad Request
- Wallet address not found in Arkham database returns empty swaps array
- Rate limiting or quota exceeded returns 429 Too Many Requests
- Malformed POST body or missing required filters returns 400 Bad Request
- Timestamp or block range too broad may return truncated results

## How this service works

Get Arkham DEX swap transactions. Priced per row: $0.40 × limit (default 20, max 1649); pass the smallest useful limit.

## Output

Returns a list of swap transactions with full Arkham intelligence enrichment: swap ID, chain, token pair (addresses, symbols, decimals), sender and receiver wallet info including Arkham labels and entity profiles (name, type, social links), USD value at time of swap, block number, block hash, and timestamp. Also returns a total count of matching swaps.

## 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 swaps where the base bought one of these tokens (token addresses or token IDs). Combine with 'from' for a spe…"
  },
  "base": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter by specific entity or address involved in the swap. Omitting it returns an empty list. Pass several as a single…"
  },
  "flow": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Swap direction relative to the base address. Valid values: 'in' (receiving token1), 'out' (sending token0), or 'all'. D…"
  },
  "from": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Filter to swaps where the base sold one of these tokens (token addresses or token IDs). Combine with 'to' for a specifi…"
  },
  "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: 1649."
  },
  "chains": {
   "anyOf": [
    {

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10000,
  "swaps": [
   {
    "id": "0xb62ab136f09349dd1d2f7c97e830a161c003e60509ff27cdf1f1769d18b963a8_2",
    "chain": "ethereum",
    "valid": true,
    "sender": {
     "chain": "ethereum",
     "address": "0x51C72848c68a965f66FA7a88855F9f7784502a7F",
     "contract": true,
     "arkhamLabel": {
      "name": "Market Maker",
      "address": "0x51C72848c68a965f66FA7a88855F9f7784502a7F",
      "chainType": "evm"
     },
     "arkhamEntity": {
      "id": "wintermute",
      "name": "Wintermute",
      "note": "",
      "type": "fund",
      "service": null,
      "twitter": "https://twitter.com/wintermute_t",
      "website": "https://www.wintermute.com/",
      "linkedin": "https://www.linkedin.com/company/wintermute-trading",
      "crunchbase": "https://www.crunchbase.com/organization/wintermute-trading"
     },
     "isUserAddress": false
    },
    "token0": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "token1": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "receiver": {
     "chain": "ethereum",
     "address": "0x51C72848c68a965f66FA7a88855F9f7784502a7F",
     "contract": true,
     "arkhamLabel": {
      "name": "Market Maker",
      "address": "0x51C72848c68a965f66FA7a88855F9f7784502a7F",
      "chainType": "evm"
     },
     "arkhamEntity": {
      "id": "wintermute",
      "name": "Wintermute",
      "note": "",
      "type": "fund",
      "service": null,
      "twitter": "https://twitter.com/wintermute_t",
      "website": "https://www.wintermute.com/",
      "linkedin": "https://www.linkedin.com/company/wintermute-trading",
      "crunchbase": "https://www.crunchbase.com/organization/wintermute-trading"
     },
     "isUserAddress": false
    },
    "token0Id": "usd-coin",
    "token1Id": "weth",
    "blockHash": "0x6e9f88a716532f88ca3e3154a4988dc82405fe7774bb2db1965880c02833a051",
    "token0Name": "USD Coin",
    "token1Name": "Wrapped Ether",
    "unitValue0": -9128487.881334,
    "unitValue1": 4263.136684788042,
    "blockNumber": 24643153,
    "token0Symbol": "USDC",
    "token1Symbol": "WETH",
    "historicalUSD": 9128487.881334,
    "blockTimestamp": "2026-03-12T18:23:47Z",
    "token0Decimals": 6,
    "token1Decimals": 18,
    "contractAddress": {
     "chain": "ethereum",
     "address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
     "contract": true,
     "arkhamLabel": {
      "name": "USDC 3",
      "address": "0x88e6A0c2dDD26FEEb64F039a2c41296FcB3f5640",
      "chainType"
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-swaps-76b0078d/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)