# Arkham x402 Token Top

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

Returns a ranked list of top crypto tokens with market cap, price, and CEX/DEX inflow/outflow volume data

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/top
- Price: $2/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-token-top-5086bbae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fl4990tP0fRJ4r_sIh7o2

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-token-top-5086bbae -d '<json body>'
```

Example prompt: Pull the top crypto tokens from Arkham right now — I want to see their market caps, current prices, and both CEX and DEX inflow and outflow volumes compared to the previous period.

## When to prefer this

Choose this endpoint when you need ranked token-level market data with both CEX and DEX flow breakdowns from Arkham Intelligence's proprietary wallet-tracking infrastructure. Prefer it over generic market data APIs when you need on-chain inflow/outflow intelligence alongside price and market cap, or when building dashboards that compare exchange vs decentralized venue activity. The pay-per-request x402 model makes it suitable for low-frequency or on-demand queries without a subscription commitment.

## Known failure modes

- Payment failure if USDC balance is insufficient for the $2 per-call fee
- Rate limiting or auth failure if x402 credentials are invalid
- Empty or partial token list if filters restrict results too aggressively
- Stale data if the underlying Arkham pipeline has a delay
- 500 server error if the Arkham backend is temporarily unavailable

## How this service works

Get Arkham top tokens by exchange activity. $2.00 per call.

## Output

Returns a JSON object containing the total number of tokens and an array of token entries, each with token metadata (ID, symbol, market cap), current period metrics (price, CEX inflow volume, DEX inflow volume, CEX outflow volume, DEX outflow volume), and previous period equivalents for comparison.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "from": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Pagination offset (starting index)."
  },
  "size": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Number of results to return per page."
  },
  "chains": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Chains to filter by, as a single comma-separated string, e.g. 'ethereum,bsc' (not a JSON array). If omitted, returns al…"
  },
  "tokenIds": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Comma-separated list of CoinGecko token IDs to filter results."
  },
  "maxVolume": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Maximum volume filter in USD."
  },
  "minVolume": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total": 8189,
  "tokens": [
   {
    "token": {
     "id": "usd-coin",
     "symbol": "USDC",
     "marketCap": 73340976893
    },
    "current": {
     "price": 0.999831,
     "inflowCexVolume": 181200000,
     "inflowDexVolume": 152300000,
     "outflowCexVolume": 179400000,
     "outflowDexVolume": 151800000
    },
    "previous": {
     "price": 0.999797,
     "inflowCexVolume": 176500000,
     "inflowDexVolume": 148100000,
     "outflowCexVolume": 175300000,
     "outflowDexVolume": 149200000
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-x402-token-top-5086bbae/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)