Get Stablecoin Issuance Change
1. Overview & Typical Use
Returns daily supply records for stablecoins within a specified time range.
- Typical use: plotting issuance trends for individual stablecoins using their decimal-adjusted supplies.
- When not to use: to query the circulation trend for a single stablecoin, use “Get Stablecoin Circulation Trend”.
2. Endpoint & Authentication
GET /api/stableCoin/totalSupply/change
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
startTime | integer | No | — | Start of the statistics-date range (inclusive), matched against category[].date; Unix millisecond timestamp |
endTime | integer | No | Current time | End of the statistics-date range (inclusive), matched against category[].date; Unix millisecond timestamp |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
statistics | array | Required | Daily supply change list | — |
statistics[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | integer | Required | End boundary of the statistics day: 00:00 UTC on the day after category[].date; e.g. 2023-04-03 maps to 1680566400 (2023-04-04 00:00 UTC) | Seconds |
total | string | Required | Legacy sum of the raw category[].totalSupply values for the day. It mixes token decimal scales and must not be displayed directly as an aggregate supply, token quantity, or USD market value | Mixed precision; no common unit |
category | array | Required | Per-token supply details | — |
category[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
date | string | Required | Statistics date of this token supply record, used for date-range filtering; statistics[].date marks the next day’s UTC midnight | yyyy-MM-dd |
tokenName | string | Required | Token name | — |
address | string | Required | Token contract address | — |
decimal | integer | Required | Token decimals | — |
totalSupply | string | Required | Raw token supply. Token quantity = totalSupply / 10^decimal; USD value additionally requires multiplying by this token’s USD price for the same statistical date. Prices are not returned by this endpoint | This token’s smallest unit |
5. Errors
For HTTP status codes, see Common Errors. Key points for this endpoint:
- General error handling rules apply; no special error scenarios.