Note
- If the token’s market cap is not verified by the team, the API response will return
null
for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).- If you require
market_cap_usd
to return FDV value (as seen in GeckoTerminal.com) when market cap data is unavailable, please specify this parametermcap_fdv_fallback=true
.
- If you require
- The returned price currency is in USD.
- Addresses not found in GeckoTerminal will be ignored.
- This endpoint allows querying up to 100 contract addresses per request. This limit is exclusive for paid plan subscribers (Analyst plan & above).
- When using this endpoint, GeckoTerminal’s routing decides the best pool for token price. The price source may change based on liquidity and pool activity. For full control over the price, you may use
/networks/{network}/pools/{address}
endpoint by providing a specific pool address. - Cache/Update Frequency: every 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
Authorizations
Path Parameters
token contract address, comma-separated if more than one token contract address
Query Parameters
include market capitalization, default: false
return FDV if market cap is not available, default: false
include 24hr volume, default: false
include 24hr price change, default: false
include total reserve in USD, default: false
Response
200 - application/json
Get current USD prices of multiple tokens on a network