Skip to main content

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:

Address Format Flexibility

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