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, orgnosis - 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, or11155111 - 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:
Address Format Flexibility
Accepted formats include both checksummed and lowercase variations. The system normalizes addresses automatically.Caching Behavior
Price data responses implement caching. Examine theCache-Control header for cache duration details.