Endpoint overview
Fetch current USD prices for multiple token addresses in a single request.Usage
Pass thenetwork
path parameter and repeat the tokens
query parameter for each token address you want to price.
- Only tokens with available prices are returned (unknown/unpriced tokens are omitted).
- The order of results is not guaranteed.
- If all provided tokens are invalid or unpriced, the response is an empty array with HTTP 200.
- Duplicate input addresses may produce duplicate entries; dedupe client-side if needed.
- Comma-separated token lists are not supported; repeat the
tokens
parameter instead.
Response example
FAQs
How do I pass multiple tokens?
How do I pass multiple tokens?
tokens
query parameter for each address (e.g., ?tokens=0x...&tokens=0x...
).What happens to unknown tokens?
What happens to unknown tokens?
Is the result order guaranteed?
Is the result order guaranteed?
What if all tokens are invalid or unpriced?
What if all tokens are invalid or unpriced?
Are duplicate token addresses deduped?
Are duplicate token addresses deduped?
Can I send a comma-separated list in one tokens param?
Can I send a comma-separated list in one tokens param?
tokens
parameters; comma-separated lists are not supported.Path Parameters
Query Parameters
The token contract address. To query multiple tokens, repeat this parameter for each address.
For example: ?tokens=0xc02...ec7&tokens=0xda...1ec7
Response
Successful operation. Returns a list of prices.
An array of price objects. Tokens for which a price could not be found are omitted from the list.
The blockchain identifier.
"ethereum"
The unique identifier for the token.
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
The current price of the token in USD.
1850.75