# Arkham x402 Transfers Histogram

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

Returns a time-bucketed histogram of on-chain transfer activity (USD volume and count) for a given wallet or entity over a specified time range.

## Facts

- Endpoint: POST https://api.arkm.com/x402/transfers/histogram
- Price: $0.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-x402-transfers-histogram-c5436728
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-2zMKbE3XhEYQqkNlX3I6

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-transfers-histogram-c5436728 -d '<json body>'
```

Example prompt: Pull the Arkham transfer histogram for wallet 0xabc...123 over the last 90 days — I want to see how USD volume and transaction count are distributed over time.

## When to prefer this

Use this endpoint when you need aggregated, time-series transfer data for a specific wallet or entity and want bucketed USD volume and count rather than individual transaction records. Prefer it for trend analysis, anomaly detection, and charting wallet activity cadence over time. It is ideal when you already have an address or Arkham entity ID and want to understand macro-level flow patterns rather than individual transfer details.

## Known failure modes

- Invalid or unresolvable wallet address returns empty array or 404
- Time range too broad may result in very large response payload or timeout
- Malformed request body (missing required fields) returns 400 Bad Request
- Insufficient USDC balance for x402 payment results in 402 Payment Required
- Rate limiting or quota exceeded returns 429 Too Many Requests
- Unknown entity identifier returns empty result set rather than explicit error

## How this service works

Get Arkham detailed transfer histogram. $0.80 per call.

## Output

Returns a JSON array of time-bucketed objects, each containing a UTC timestamp ('time'), the aggregate USD value of transfers in that bucket ('usd'), and the number of individual transfers ('count'). The array is ordered chronologically, allowing reconstruction of a volume-over-time histogram.

## 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…"
  },
  "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 value (e.g. 'ethereum,bsc'). If omitted, returns transfers across a
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": [
  {
   "usd": 1.23,
   "time": "2024-01-01T00:00:00Z",
   "count": 1
  }
 ]
}
```

## More

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