# Arkham Token Volume by Address

> Arkham Token Volume by Address 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-16).

Returns hourly time-series of token transfer volume (in USD and native token units) flowing into and out of a specific blockchain wallet address.

## Facts

- Endpoint: POST https://api.arkm.com/x402/token/volume/by-address
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-token-volume-by-address-ad8c9012
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qr3UWA62EOVic6QX9W92r

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-address-ad8c9012 -d '<json body>'
```

Example prompt: Pull the hourly token volume for wallet address 0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE on Arkham — I want to see inflows and outflows in both USD and native token value for the past 48 hours.

## When to prefer this

Use this endpoint when you need granular, time-series volume data (inflows and outflows) for a specific wallet address, denominated in both USD and native token units. Prefer Arkham's data when you need labeled, intelligence-enriched on-chain data rather than raw node queries. Best suited for whale tracking, due diligence, compliance screening, or DeFi flow analysis where hourly granularity and USD conversion are required.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Address with no token transfers returns an empty array
- Unsupported token or address type may return no data
- Requesting very long time ranges may result in timeout or truncated data
- Insufficient USDC balance (x402 payment failure) returns a 402 Payment Required error
- Rate limiting if too many concurrent requests are made

## How this service works

Get Arkham token volume by chain/address. $0.60 per call.

## Output

An array of hourly buckets, each containing a UTC timestamp and four volume metrics: inUSD (token inflows converted to USD), outUSD (token outflows converted to USD), inValue (native token inflow amount), and outValue (native token outflow amount). Each record represents one hour of aggregated transfer activity for the queried address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "Blockchain network where the token is deployed."
  },
  "address": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "number"
    },
    {
     "type": "boolean"
    },
    {
     "type": "array",
     "items": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "number"
       },
       {
        "type": "boolean"
       }
      ]
     }
    }
   ],
   "description": "The token contract address."
  },
  "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": 968891.0319822108,
   "outUSD": 1233415.546442032,
   "inValue": 968891.037339,
   "outValue": 1233415.563605
  },
  {
   "time": "2026-07-12T17:00:00Z",
   "inUSD": 1187226.478118926,
   "outUSD": 1275054.663351059,
   "inValue": 1187226.461162,
   "outValue": 1275054.650006
  }
 ]
}
```

## More

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