# Arkham Token Volume by ID

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

Returns time-series token transfer volume (inflow and outflow in USD and native units) for a specified token, bucketed by hour.

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/volume/by-id
- Price: $0.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-token-volume-by-id-7e6d110f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vfBN0xvgJJ0f9aQ069VGa

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-token-volume-by-id-7e6d110f -d '<json body>'
```

Example prompt: Pull the hourly on-chain transfer volume for the USDC token on Arkham — I want to see how much flowed in and out in USD over the past day.

## When to prefer this

Use this endpoint when you need granular hourly on-chain transfer volume (inflows and outflows) for a specific token, denominated in both USD and native units. Prefer this over generic market data APIs when you need wallet-level blockchain intelligence rather than exchange trade volume, or when you need Arkham's entity-resolved on-chain data. Best suited for on-chain flow analysis, anomaly detection, and DeFi research.

## Known failure modes

- Invalid or unknown token ID returns an empty array or 404-equivalent error
- Missing required token ID parameter causes a 400 bad request
- x402 payment failure (insufficient USDC balance or expired payment) blocks the request
- Rate limiting or payment processing delays may cause timeouts
- Time range outside available data history returns an empty result set

## How this service works

Get Arkham token volume by pricing ID. $0.60 per call.

## Output

An array of hourly time-series objects, each containing a UTC timestamp plus inflow and outflow quantities expressed both in USD and in native token units. Covers the requested time window at one-hour granularity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The CoinGecko pricing ID of the token."
  },
  "timeLast": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Time range to return, as a relative duration such as '24h', '7d', or '60d'. Under 30 days, results honor granularity; 3…"
  },
  "granularity": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Bucket size for the histogram. Use a whole number of hours, from 1h up to 7d (e.g. 1h, 2h, 6h, 12h, 1d, 2d, 3d, 7d); su…"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "time": "2026-07-12T16:00:00Z",
   "inUSD": 2399721.984146059,
   "outUSD": 6826024.15839386,
   "inValue": 37.44615725,
   "outValue": 106.51191897
  },
  {
   "time": "2026-07-12T17:00:00Z",
   "inUSD": 3211115.482628137,
   "outUSD": 4771902.633152008,
   "inValue": 50.12274685,
   "outValue": 74.42026910000001
  }
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-token-volume-by-id-7e6d110f/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)