Common Use Cases
Below are some of the common use cases that might be useful to you.
Last updated
Was this helpful?
Below are some of the common use cases that might be useful to you.
Last updated
Was this helpful?
Use coins/{id} endpoint, e.g. . You can also use this endpoint to receive other metadata like: links, categories, contract address, community, description in different languages and more.
Use coins/simple endpoint. e.g. . This endpoint can also return market data like market cap, 24hour trading volume and 24hour price change %. Note: the data update frequency (or cache) for Pro API is around 30-40 seconds. Public API may take 2 minutes or more to update the last price.
Use coins/list/new endpoint, it is the fastest endpoint to that return the latest coins (ids and activated time) added on CoinGecko. This is an exclusive endpoint for Pro API users, subscribe to any to access it. Note: the data update frequency (or cache) this endpoint is around 30 seconds.
Use coins/{id}/tickers, e.g.
To get trading pairs of Uniswap from Binance only, you may use coins/{id}/tickers or /exchanges/{id}/tickers and insert the right param to filter. e.g.
Use /coins/markets and category parameter to filter. e.g. the links below help you to get all the coins that are tagged as 'stablecoins' and 'arbitrum ecosystem' on CoinGecko.com.
Once you have identified the chain ID, replace the correct ID in this link below https://tokens.coingecko.com/<ID>/all.json . e.g.
Alternatively, you may also use /coins/list endpoint with the parameter include_platform=true. This allows you to view all the coins listed on CoinGecko, and their respective blockchain networks.
You may flag 'sparkline' parameter with the /coins/{id} and /coins/markets endpoints, for example:
web_slug data can be obtained in the following endpoints:
/coins/{id}
/coins/{id}/contract/{contract_address}
To check if a price is stale, you may use one of the following methods:
use /coins/{id} endpoint , and look for 'last_updated' timestamp data.
use /simple/price endpoint, and insert the parameter include_last_updated_at=true to check the latest update time.
To check the historical exchange rate, you may use /coins/{id}/history (or /coins/{id}market_chart) endpoint to get the historical price of BTC in USD on a specific date.
Use to get the full list of exchanges (id) on CoinGecko.com
Use /exchanges/{id} to find out if an exchange is centralized (CEX) or not (DEX). Repeat the same for other exchanges. e.g.
Use . It will show the total (global) market cap, as well as dominance % of BTC, ETH and more.
Use , it will also return their 24hour percentage change, which can be useful to know which category or ecosystem is receiving traction. You may also compare this endpoint against global market cap data.
First, you would have to identify the ID for the chain you are looking for using the . Note: only coins that have contract address added by the CoinGecko team will be shown. (Learn more )
You may insert the API id with this URL format: www.coingecko.com/en/coins/{web_slug} For example:
To check if a coin is active or not, you may refer to the endpoint, only active coins will be shown here.
To check the current exchange rate, you may use the /exchange_rates endpoint ().