Token Endpoints
Endpoints for retrieving token information including USD pricing and holder data across supported blockchain networks.
Get Token USD Price
Retrieve current USD pricing for any ERC-20 token.
Endpoint: GET /{chainId}/tokens/{tokenAddress}/usdPrice
Path Parameters
- chainId (required): Network identifier such as
1, mainnet, 100, or gnosis
- tokenAddress (required): Token contract address (checksummed or lowercase); use
- for native tokens
Response
Code Examples
Response Example
Error Response (404)
Get Token Top Holders
Retrieve the list of principal token holders.
Endpoint: GET /{chainId}/tokens/{tokenAddress}/topHolders
Path Parameters
- chainId (required): Network identifier like
1, 100, or 11155111
- tokenAddress (required): Token contract address in any standard format
Response
Returns an array of holder objects:
Code Examples
Response Example
Error Response (404)
Notes
Native Token Pricing
For native assets like ETH or xDAI, substitute - as the token address:
Accepted formats include both checksummed and lowercase variations. The system normalizes addresses automatically.
Caching Behavior
Price data responses implement caching. Examine the Cache-Control header for cache duration details.
Network Support
Available on all supported networks with varying data completeness:
Error Handling
Last modified on March 4, 2026