Get Stablecoin Circulation Trend Chart

1. Overview & Typical Use

Returns daily total supply, mint amount, and burn amount for a specified stablecoin. Supported stablecoins: USDD, USDC, USDJ, TUSD.

Typical use: individual stablecoin supply change analysis, mint/burn history tracking.
When not to use: to query supply changes for all stablecoins, use “Get All Stablecoin Issuance Change Chart”.

GET /api/stableCoin/tokenSupply/turnover

For Base URL and authentication, see Common Network & Authentication.

Parameter	Type	Required	Default	Description
`tokenAddress`	string	Yes	—	Stablecoin contract address; supports USDD, USDC, USDJ, TUSD
`startTime`	integer	No	—	Start time in seconds; earliest `2022-11-22`
`endTime`	integer	No	Current time	End time in seconds

Top-level

Field	Type	Required	Description	Unit/Precision
`statistics`	array	Required	Daily supply data array	—
`tokenDecimal`	integer	Required	Token decimals	—

statistics[] element

Field	Type	Required	Description	Unit/Precision
`date`	string	Required	Date string in `yyyy-MM-dd` format	—
`totalSupply`	string	Required	Daily total supply (raw integer in smallest unit, returned as string to prevent overflow)	See top-level `tokenDecimal`
`mintAmount`	number	Optional	Daily mint amount (minimum unit)	minimum unit
`burnAmount`	number	Optional	Daily burn amount (minimum unit)	minimum unit

For HTTP status codes, see Common Errors. Key points for this endpoint:

Unsupported token address: returns {"message":"some parameters are invalid or out of range"}.
Empty result is not an error: returns 200 + statistics: [] as a normal response.