ETH

ETH address metrics (3-Tier MVRV-Doctrine)

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

get/eth/address/{addr}

Request

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

Path parameters

addrstring required

Response

Address with cluster, tier, MVRV

addressstring
balance_ethnumber
cluster_idstring 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_labelstring nullable
first_seenstring date-time
mvrv_rationumber 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_30dinteger

Example response

{
  "balance_eth": 4128.5,
  "mvrv_ratio": 1.34,
  "tx_count_30d": 7
}

Changes

No recorded changes to this operation across all 1 revision of this API.