Get Token Holder Position Distribution

1. Overview & Typical Use

Returns the position distribution of token holders, with holdings and ratios aggregated by ranking interval.

Typical use: token concentration analysis, position distribution pie chart display.
When not to use: to query a specific list of holders, use the corresponding holder endpoint.

GET /api/tokens/position-distribution

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

Parameter	Type	Required	Default	Description
`tokenId`	string	Yes	—	Token contract address or TRC10 token ID

Field	Type	Required	Description	Unit/Precision
`expire`	integer	Required	Cache expiration time	Unix timestamp in milliseconds
`rank1-10`	string	Required	Total holdings of ranks 1–10	—
`rank1-10_ratio`	string	Required	Ratio for ranks 1–10	Decimal ratio
`rank11-50`	string	Required	Total holdings of ranks 11–50	—
`rank11-50_ratio`	string	Required	Ratio for ranks 11–50	Decimal ratio
`rank51-100`	string	Required	Total holdings of ranks 51–100	—
`rank51-100_ratio`	string	Required	Ratio for ranks 51–100	Decimal ratio
`rank101-500`	string	Required	Total holdings of ranks 101–500	—
`rank101-500_ratio`	string	Required	Ratio for ranks 101–500	Decimal ratio
`other`	string	Required	Total holdings of all others	—
`other_ratio`	string	Required	Ratio for all others	Decimal ratio

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