Tokens
Get Token Top Holders
GET
Get Token Holders
Credit cost: 1 per request.
Parameters
- The base response includes the top 80 holders of the token. This is the same as the iFrame integrations. You can change the number of holders with the
limitparameter. - The
return_metadataquery parameter includes the labels and metadata of the holders in the response. - Data can be cached for performance, cache TTL depends on token age. Date of update can be found in the
X-Dt-Updateresponse header. If you need to force a refresh, you can use therefresh=truequery param. - History mode: to access the top holders of a token in a specific date in the past, use the
timestampparameter (unix timestamp)
Response
- All share values are in
[0, 1]format, meaning42%will be returned as0.42. - When
return_metadata=true, theis_paid_labelboolean indicates whether the label is a community-submitted label.
Authorizations
Path Parameters
Available options:
eth, base, solana, tron, bsc, sonic, ton, avalanche, polygon, monad, hyperevm, arbitrum, robinhood Query Parameters
Available options:
80, 250, 500 Get Token Holders