Get Stablecoin Top Holders
1. Overview & Typical Use
Returns the top 50 stablecoin holders with their USDT, USDC, USDD, TUSD, and USDJ balances.
- Typical use: display stablecoin whale rankings.
- When not to use: to query a single account, use an account endpoint.
2. Endpoint & Authentication
GET /api/stableCoin/holder/top
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
viewContract | integer | No | 1 | Whether to include contract data. 1: include, 2: exclude |
sort | string | No | USDT | Sort field: USDT, USDC, USDJ, USDD, or TUSD |
direction | integer | No | 2 | Sort direction. 1: ascending, 2: descending |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Number of records returned (fixed 50) | — |
data | array | Required | Holder list | — |
contractMap | object | Required | Address → whether the address is a contract | — |
refreshTimeInfo | object | Required | Data refresh info; contains type ("realtime") and lastUpdateTime (seconds timestamp) | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
address | string | Required | Holder address | — |
addressType | integer | Required | Address type | — |
accountTag | string | Required | Account label (empty string "" when no label) | — |
usdtAmount | number | Required | USDT holdings | USD |
tusdAmount | number | Optional | TUSD holdings (returned only for accounts with non-zero TUSD) | USD |
usddAmount | number | Optional | USDD holdings (returned only for accounts with non-zero USDD) | USD |
usdcoldAmount | number | Optional | USDC holdings (returned only for accounts with non-zero USDC; field name ends with old from historical contract naming) | USD |
usdjAmount | number | Optional | USDJ holdings (returned only for accounts with non-zero USDJ) | USD |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- General error handling rules apply; no special error scenarios.
Last updated on: