---
title: "USDT activity for an address (chain-agnostic)"
method: GET
path: "/usdt/address/{addr}"
tags: ["USDT"]
---

# USDT activity for an address (chain-agnostic)

`GET /usdt/address/{addr}`

## Request

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

Chain auto-detected from address format. ETH (0x + 40 hex) → looks up eth_entity_labels; Tron (T + 33 base58) → looks up tron_entity_labels. Returns inflow/outflow/net + tx counts + first/last seen + entity-label if present.

## Path parameters

- `addr` string, required

## Query parameters

- `hours` integer

## Response `200`

Per-address USDT activity stats with label

- UsdtAddressMetrics: Per-address USDT activity. Chain auto-detected from address format (0x… → eth, T… → tron).
  - `address` string
  - `chain` 'eth' | 'tron'
  - `first_seen` string, date-time, nullable
  - `hours` integer: Lookback window (1-8760)
  - `inflow_tx_count` integer
  - `inflow_usdt` number
  - `label` object, nullable: Lookup from eth_entity_labels OR tron_entity_labels
  - `last_seen` string, date-time, nullable
  - `net_usdt` number
  - `outflow_tx_count` integer
  - `outflow_usdt` number

## Other responses

- `400`: Invalid address format
- `401`: Authentication required or failed. Includes X-RateLimit-* headers when key was identified.

---

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