Get Stablecoin Holding Distribution Change
1. Overview & Typical Use
Returns how a stablecoin’s holding distribution across categories (exchanges, wallets, contracts) has changed over time.
- Typical use: draw stablecoin holding distribution change trend charts.
- When not to use: to query the current holding distribution snapshot use “Get Stablecoin Holder Distribution”.
2. Endpoint & Authentication
GET /api/stableCoin/distribution/change
For Base URL and authentication, see Common Network & Authentication.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
token | string | Yes | — | Stablecoin contract address |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
count | integer | Required | Number of data points | — |
data | array | Required | Distribution change list | — |
tokenName | string | Required | Token name | — |
tokenAbbr | string | Required | Token abbreviation | — |
tokenDecimal | integer | Required | Token decimal precision | — |
data[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
timestamp | integer | Required | Timestamp | milliseconds |
exchange | string | Required | Exchange holdings (raw minimum unit) | minimum unit (divide by 10^tokenDecimal) |
JustLend | string | Required | JustLend protocol holdings (raw minimum unit) | minimum unit (divide by 10^tokenDecimal) |
SunSwap | string | Required | SunSwap protocol holdings (raw minimum unit) | minimum unit (divide by 10^tokenDecimal) |
SunCurve | string | Required | SunCurve protocol holdings (raw minimum unit) | minimum unit (divide by 10^tokenDecimal) |
others | string | Required | Other address holdings (raw minimum unit) | minimum unit (divide by 10^tokenDecimal) |
top10Holders | array | Required | Top 10 holders list | — |
top10Holders[] element
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
address | string | Required | Holder address | — |
address_tag | string | Required | Address label | — |
balance | string | Required | Holdings (minimum unit) | — |
change | string | Required | Change amount | — |
percent | string | Required | Holding percentage | decimal |
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: