Token prices by address

GET 
/v1/data/token/prices

Returns per-address USD prices for the given asset addresses on a chain.

How it works:

1. Resolves each address to its asset group via the token list
2. Looks up the latest USD price for each asset group
3. Returns a map of address → price

Query format:

• assets: Comma-separated list of EVM addresses (0x-prefixed, 40 hex chars)

Response Structure:

• items: Object mapping lowercase addresses to their USD price (0 if unknown)
• count: Number of resolved assets

Plain-text reference — GET /v1/data/token/prices

Parameters

Parameter	In	Type	Required	Description
chainId	query	string	yes	Chain ID See the ChainId schema for the full set of supported chains.
assets	query	string	yes	Comma-separated list of token addresses

Response 200

Field	Type	Description
success	True
data	object
data.chainId	string	EVM chain id, as a decimal string. See the ChainId schema.
data.count	integer	Number of resolved assets
data.items	object	Map of lowercase address → USD price
actions	null

Example response

{
  "success": true,
  "data": {
    "chainId": "1",
    "count": 1,
    "items": {
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": 1,
      "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 3500.12
    }
  }
}

Request

Responses

200

Per-address USD prices

400

Validation error

429

Rate limited. Unauthenticated callers share a per-IP budget; send an x-api-key header to lift it. Retry with exponential backoff.

500

Unexpected server error. Safe to retry with backoff.

502

An upstream data source or protocol origin failed (error.code is ORIGIN_FAILED). error.details carries the per-origin status. This is also what a missing or malformed required parameter currently returns, rather than a 400.