# Get cluster summary statistics

Returns summary statistics for the specified cluster, including:
- Total number of unique addresses in the cluster
- Total balance in USD
- Total transaction volume in USD
- First and last transaction timestamps

Data sources:
- For large clusters (>10 addresses): Returns precomputed data from cluster_page_summary table
- For small clusters (≤10 addresses): Calculates summary on the fly from raw data

Clusters are groups of addresses that have been linked together through on-chain heuristics
(e.g., Bitcoin input clustering).

Endpoint: GET /cluster/{id}/summary
Version: 1.0.4
Security: ApiKeyAuth

## Path parameters:

  - `id` (string, required)
    The cluster identifier (hash-based ID)
    Example: "29d502f1236dd5563fbb7799f30b39d80400555674757acb7869055cebdfc6da"

## Response 200 fields (application/json):

  - `clusterId` (string)
    The cluster identifier
    Example: "29d502f1236dd5563fbb7799f30b39d80400555674757acb7869055cebdfc6da"

  - `numAddresses` (integer)
    Total number of unique addresses in this cluster
    Example: 1523

  - `volumeUsd` (number)
    Total transaction volume in USD
    Example: 125000000.5

  - `balanceUsd` (number)
    Current balance in USD
    Example: 85000000.25

  - `firstTx` (string,null)
    Timestamp of first transaction
    Example: "2017-07-14T10:02:13Z"

  - `lastTx` (string,null)
    Timestamp of last transaction
    Example: "2025-10-29T14:23:45Z"

## Response 400 fields (application/json):

  - `error` (string)
    Example: "Bad request"

## Response 401 fields (application/json):

  - `error` (string)
    Example: "API key missing or invalid"

## Response 404 fields (application/json):

  - `error` (string)
    Example: "Not found"


## Response 500 fields