---
title: "ETH cluster expansion (members + entity-label)"
method: GET
path: "/eth/cluster/{cluster_id}"
tags: ["ETH"]
---

# ETH cluster expansion (members + entity-label)

`GET /eth/cluster/{cluster_id}`

## Request

- Base URL: `https://swisswhaleintelligence.com/v1`
- URL: `https://swisswhaleintelligence.com/v1/eth/cluster/{cluster_id}`
- Auth: HTTP bearer

Returns cluster member-addresses with confidence-score. L1_label clusters = conf 0.95 (Etherscan/CEX-tagged). L3_graph clusters = conf 0.40 (Hybrid Option C, ADR-001 ACCEPTED).

## Path parameters

- `cluster_id` string, required

## Query parameters

- `limit` integer

## Response `200`

Cluster metadata + paginated members

- EthCluster
  - `cluster_id` string
  - `cluster_source` 'L1_label' | 'L3_graph'
  - `confidence` number
  - `entity_label` string, nullable
  - `member_count` integer
  - `members` string[]: Cluster member addresses (paginated, up to limit param)

## Other responses

- `401`: Authentication required or failed. Includes X-RateLimit-* headers when key was identified.
- `404`: Resource not found. Hint field may suggest corrective action.

---

[API](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api.md) · [All operations](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swisswhaleintelligence/apis/swiss-whale-intelligence-api/revisions/dcb44bc52418?raw)