---
title: "Canonical cross-chain entity + activity for an address"
method: GET
path: "/entity/{chain}/{address}"
tags: ["Cross-chain"]
---

# Canonical cross-chain entity + activity for an address

`GET /entity/{chain}/{address}`

## Request

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

Resolves a single (chain, address) through the entity keystone into the canonical real-world entity, its cross-chain reach (which chains / how many addresses it spans), and a per-entity activity verdict (whale-move frequency vs the entity's OWN coverage-normalized weekly baseline → dormant_wakeup / elevated / routine / quiet). link_method distinguishes confirmed labels ('label_match') from co-spend-cluster inferences ('cluster', heuristic). Descriptive only — never predictive.

## Path parameters

- `chain` 'btc' | 'eth' | 'sol' | 'tron' | 'usdt', required
- `address` string, required

## Response `200`

Resolved entity + cross-chain activity (or resolved=false with optional plain label)

- EntityProfile
  - `activity` object, nullable
    - `classification` 'dormant_wakeup' | 'elevated' | 'routine' | 'quiet'
    - `last_move_at` string, date-time, nullable
    - `moves_window` integer
    - `phrase` string
    - `weekly_baseline` number
    - `window_volume_usd` number
  - `address` string
  - `chain` string
  - `entity` object, nullable
    - `address_count` integer
    - `canonical_name` string
    - `chain_count` integer
    - `chains` string
    - `link_confidence` number, nullable
    - `link_method` 'label_match' | 'cluster' | 'manual' | 'bridge_heuristic' | 'deposit_reuse' | 'timing': label_match = confirmed; cluster = inferred via common-input co-spend (heuristic).
    - `primary_type` string
    - `slug` string
  - `label` object, nullable: Plain per-address label when not linked to a canonical entity.
  - `resolved` boolean

## Other responses

- `401`: Authentication required or failed. Includes X-RateLimit-* headers when key was identified.
- `429`: Rate limit exceeded. Honour Retry-After header.

---

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