Get Stablecoin Holder Distribution

1. Overview & Typical Use

Returns the detailed holding distribution of a stablecoin across exchanges, wallets, and DeFi protocols (JustLend, SunSwap, SunCurve, etc.).

Typical use: display the current snapshot of stablecoin holder distribution.
When not to use: to view distribution changes over time use “Get Stablecoin Holding Distribution Change”.

GET /api/stableCoin/distribution

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

Parameter	Type	Required	Default	Description
`token`	string	Yes	—	Stablecoin contract address

Top-level

Field	Type	Required	Description	Unit/Precision
`addresses`	object	Required	Address category distribution (includes `exchange` / `otherAccount` sub-categories, plus aggregate `percent` / `value`)	—
`contract`	object	Required	Contract category distribution (includes `JustLend` / `SunSwap` / `SunCurve` / `otherContract` sub-categories, plus aggregate `percent` / `value`)	—
`tokenName`	string	Required	Token name	—
`tokenAbbr`	string	Required	Token abbreviation	—
`tokenDecimal`	integer	Required	Token decimal precision	—

addresses / contract top-level aggregate fields (sibling to sub-categories)

Field	Type	Required	Description	Unit/Precision
`percent`	string	Required	Total percentage for this category (addresses/contract)	decimal
`value`	string	Required	Total holdings for this category (minimum unit)	minimum unit (divide by 10^`tokenDecimal`)

addresses.exchange / addresses.otherAccount

Field	Type	Required	Description	Unit/Precision
`data`	array	Required	Per-address share details	—
`percent`	string	Required	Total percentage	decimal
`value`	string	Required	Total holdings (minimum unit)	minimum unit (divide by 10^`tokenDecimal`)

data[] element (address list)

Field	Type	Required	Description	Unit/Precision
`address`	string	Required	Address or exchange name	—
`percent`	string	Required	Percentage	decimal
`value`	string	Required	Holdings (minimum unit)	minimum unit (divide by 10^`tokenDecimal`)

contract.JustLend / contract.SunSwap / contract.SunCurve / contract.otherContract

Field	Type	Required	Description	Unit/Precision
`data`	array	Required	Per-contract address share details	—
`percent`	string	Required	Percentage	decimal
`value`	string	Required	Holdings (minimum unit)	minimum unit (divide by 10^`tokenDecimal`)

contract.*.data[] element

Field	Type	Required	Description	Unit/Precision
`address`	string	Required	Contract address	—
`percent`	string	Required	Percentage	decimal
`value`	string	Required	Holdings (minimum unit)	minimum unit (divide by 10^`tokenDecimal`)

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