# Arkham Cluster Summary

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

Returns aggregate wallet intelligence for a blockchain address cluster, including total balance, volume, address count, and transaction history range.

## Facts

- Endpoint: POST https://api.arkm.com/x402/cluster/summary
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/arkham-cluster-summary-22e17b24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__2IdEe30u8dIm7fEI4A1S

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-cluster-summary-22e17b24 -d '<json body>'
```

Example prompt: Pull up the Arkham cluster summary for cluster ID 00000002aae817c1a0d2ec3c91ede74c64c92c83658decdad52b591451948d75a9ca — I want to see the total balance, volume, number of addresses, and when it first and last transacted.

## When to prefer this

Use this endpoint when you need high-level aggregate financial intelligence about a known Arkham cluster — total balance, volume, and address count — rather than individual transaction records or address-level detail. Prefer this over building custom on-chain analytics when you already have a cluster ID from Arkham's intelligence graph and need a fast, pay-per-use summary without a subscription.

## Known failure modes

- Invalid or malformed cluster ID returns an error response
- Unknown cluster ID with no data returns empty or 404-style error
- Payment failure via x402 protocol if USDC balance is insufficient
- Rate limiting if requests exceed allowed frequency
- Network timeout on large or complex clusters

## How this service works

Get Arkham cluster summary statistics. $0.20 per call.

## Output

A JSON object containing the cluster's aggregate USD balance, total historical volume in USD, number of included addresses, the timestamp of the first transaction, and the timestamp of the most recent transaction, along with the cluster ID.

## 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 ID of the cluster to summarize."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "lastTx": "2026-07-20T23:50:05Z",
  "firstTx": "2018-11-12T14:22:37Z",
  "clusterId": "00000002aae817c1a0d2ec3c91ede74c64c92c83658decdad52b591451948d75a9ca",
  "volumeUsd": 1817156302729.24,
  "balanceUsd": 367192196.3600065,
  "numAddresses": 1908436
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/arkham-cluster-summary-22e17b24/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)