Get Stablecoin Overview
1. Overview & Typical Use
Returns market cap, holder count, total supply, 24-hour transfer count, and 24-hour liquidity data for a specified stablecoin.
- Typical use: stablecoin overview page data, market cap and activity metrics.
- When not to use: to query historical supply changes, use “Get All Stablecoin Issuance Change Chart”.
2. Endpoint & Authentication
GET /api/stableCoin/overview
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
tokenAddress | string | No | — | Stablecoin contract address; if omitted, returns aggregated data for all stablecoins |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
data | object | Required | Stablecoin statistics, see below | — |
refreshTimeInfo | object | Required | Data refresh info, contains type ("realtime") and lastUpdateTime (Unix timestamp in seconds) | — |
data object
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
marketCap | string | Required | Market cap | USD |
holderCnt | string | Required | Number of holders | — |
supply | string | Optional | Total supply (only present when tokenAddress is provided) | USD |
transferCntIn24h | string | Required | 24-hour transfer count | — |
transferCntIn24hChange | string | Required | 24-hour transfer count change rate | Decimal (positive = growth, negative = decline) |
liquidityIn24h | string | Required | 24-hour liquidity | USD |
liquidityIn24hChange | string | Required | 24-hour liquidity change rate | Decimal |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- Empty result is not an error: when no data exists, an empty
dataobject is returned as a normal response.
Last updated on: