Get Stablecoin Holder Count Change
1. Overview & Typical Use
Returns how the number of holders for each stablecoin has changed over a specified date range, broken down by token category.
- Typical use: draw stablecoin holder count trend charts; compare USDT/USDC/USDD growth.
- When not to use: for balance distribution data use “Get Stablecoin Holder Balance Overview”.
2. Endpoint & Authentication
GET /api/stableCoin/holder/change
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startDay | string | No | 30 days ago | Start date (format: YYYY-MM-DD); earliest: 2020-12-11 |
endDay | string | No | Today (UTC) | End date (format: YYYY-MM-DD); must not be earlier than startDay |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
statistics | array | Required | Daily holder count by token | — |
latest | array | Required | Latest holder count snapshot by token | — |
totalHolder | string | Required | Total holder count across all stablecoins | — |
statistics[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | integer | Required | Date timestamp | Second timestamp |
aggrHolder | string | Required | Aggregate holder count for this date | — |
category | array | Required | Per-token breakdown | — |
statistics[].category[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenName | string | Required | Token name | — |
tokenAddress | string | Required | Token contract address | — |
holderNum | string | Required | Holder count for this token on this date | — |
date | string | Required | Date (format: YYYY-MM-DD) | — |
latest[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
tokenName | string | Required | Token name | — |
tokenAddress | string | Required | Token contract address | — |
holderNum | integer | Required | Current holder count | — |
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: