---
title: "ETH address metrics (3-Tier MVRV-Doctrine)"
method: GET
path: "/eth/address/{addr}"
tags: ["ETH"]
---

# ETH address metrics (3-Tier MVRV-Doctrine)

`GET /eth/address/{addr}`

## Request

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

Returns cluster + MVRV per ADR-001 3-Tier-Doctrine. aggregator_wallet tier → mvrv_ratio=NULL (Hard-Invariant: aggregators have no meaningful cost-basis).

## Path parameters

- `addr` string, required

## Response `200`

Address with cluster, tier, MVRV

- EthAddressMetrics
  - `address` string
  - `balance_eth` number
  - `cluster_id` string, nullable
  - `cluster_source` 'L1_label' | 'L3_graph', nullable: L1_label=conf 0.95 (Etherscan/CEX-tagged), L3_graph=conf 0.40 (hybrid graph-detection)
  - `entity_label` string, nullable
  - `first_seen` string, date-time
  - `mvrv_ratio` number, nullable
  - `tier` 'whale_tier_only' | 'whale_tier_partial' | 'aggregator_wallet': 3-Tier MVRV-Doctrine per ADR-001. aggregator_wallet → mvrv_ratio=NULL (Hard-Doctrine-Invariant)
  - `tx_count_30d` integer

## 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)