---
title: "Address metrics (whale-tracked only)"
method: GET
path: "/address/{addr}"
tags: ["BTC"]
---

# Address metrics (whale-tracked only)

`GET /address/{addr}`

## Request

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

## Path parameters

- `addr` string, required

## Response `200`

Aggregated address metrics

- AddressMetrics
  - `address` string
  - `balance_btc` number
  - `cluster_id` integer, nullable
  - `entity_label` string, nullable
  - `first_seen` string, date-time
  - `last_seen` string, date-time
  - `tx_count` integer
  - `volume_index_calibrated` number

## Other responses

- `401`: Authentication required or failed. Includes X-RateLimit-* headers when key was identified.
- `404`: Address not in whale-metrics cache — try /address/{addr}/lookup for any-address resolution

---

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