Get Stablecoin Holder Balance Overview
1. Overview & Typical Use
Returns the balance distribution of all major stablecoins (USDT, USDC, TUSD, USDD, USDJ) across wallet and protocol categories.
- Typical use: display a cross-stablecoin balance breakdown grouped by category (Wallet, JustLend, SunSwap, SunCurve, Other).
- When not to use: to query a specific address’s holdings use “Get Holder Token Basic Info”.
2. Endpoint & Authentication
GET /api/stableCoin/holder/balance/overview
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
No request parameters.
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
data | array | Required | Stablecoin balance overview list | — |
refreshTimeInfo | object | Required | Cache refresh time metadata | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenAddress | string | Required | Stablecoin contract address | — |
tokenName | string | Required | Token name | — |
decimal | integer | Required | Token decimal precision | — |
statistic | array | Required | Balance breakdown by category | — |
data[].statistic[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
balance | string | Required | Balance (minimum unit) | minimum unit (divide by 10^decimal) |
tokenName | string | Required | Token name | — |
category | string | Required | Category: Wallet / JustLend / SunSwap / SunCurve / Other | — |
refreshTimeInfo object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
type | string | Required | Data refresh type, e.g. realtime | — |
lastUpdateTime | integer | Required | Last update time | Second timestamp |
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: