coins_list
[DISCOVERY] Coins List (ID Map) — This endpoint allows you to **query all the supported coins on CoinGecko with coins ID, name and symbol**
coins_top_gainers_losers
💼 Top Gainers & Losers — This endpoint allows you to **query the top 30 coins with largest price gain and loss by a specific time duration** Returns: { top_gainers: { id: string, symbol: string, name: string, image: string, market_cap_rank: number, usd: number, ... }[], top_losers: { id: string, symbol: string, name: string, image: string, market_cap_rank: number, usd: number, ... }[] }.
coins_list_new
💼 Recently Added Coins — This endpoint allows you to **query the latest 200 coins that recently listed on CoinGecko**
coins_markets
[DISCOVERY] Coins List with Market Data — This endpoint allows you to **query all the supported coins with price, market cap, volume and market related data**
coins_id
Coin Data by ID — This endpoint allows you to **query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin from the CoinGecko coin page based on a particular coin ID** Returns: { id: string, symbol: string, name: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_tickers
Coin Tickers by ID — This endpoint allows you to **query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID** Returns: { name: string, tickers: { base: string, target: string, market: { name: string, identifier: string, has_trading_incentive: boolean, logo: string }, last: number, volume: number, cost_to_move_up_usd: number, ... }[] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_history
Coin Historical Data by ID — This endpoint allows you to **query the historical data (price, market cap, 24hrs volume, ...) at a given date for a coin based on a particular coin ID** Returns: { id: string, symbol: string, name: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_market_chart
Coin Historical Chart Data by ID — This endpoint allows you to **get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID** Returns: { prices: number[][], market_caps: number[][], total_volumes: number[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_market_chart_range
Coin Historical Chart Data within Time Range by ID — This endpoint allows you to **get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hr volume based on particular coin ID** Returns: { prices: number[][], market_caps: number[][], total_volumes: number[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_ohlc
Coin OHLC Chart by ID — This endpoint allows you to **get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID**
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_ohlc_range
💼 Coin OHLC Chart within Time Range by ID — This endpoint allows you to **get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID**
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_contract_address
Coin Data by Token Address — This endpoint allows you to **query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin from the CoinGecko coin page based on an asset platform and a particular token contract address** Returns: { id: string, symbol: string, name: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
contract_address_market_chart
Coin Historical Chart Data by Token Address — This endpoint allows you to **get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address** Returns: { prices: number[][], market_caps: number[][], total_volumes: number[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
contract_address_market_chart_range
Coin Historical Chart Data within Time Range by Token Address — This endpoint allows you to **get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address** Returns: { prices: number[][], market_caps: number[][], total_volumes: number[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_circulating_supply_chart
👑 Circulating Supply Chart by ID — This endpoint allows you to **query historical circulating supply of a coin by number of days away from now based on provided coin ID** Returns: { circulating_supply: string[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_circulating_supply_chart_range
👑 Circulating Supply Chart within Time Range by ID — This endpoint allows you to **query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID** Returns: { circulating_supply: string[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_total_supply_chart
👑 Total Supply Chart by ID — This endpoint allows you to **query historical total supply of a coin by number of days away from now based on provided coin ID** Returns: { total_supply: string[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
coins_id_total_supply_chart_range
👑 Total Supply Chart within time range by ID — This endpoint allows you to **query historical total supply of a coin, within a range of timestamp based on the provided coin ID** Returns: { total_supply: string[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
asset_platforms_list
[DISCOVERY] Asset Platforms List (ID Map) — This endpoint allows you to **query all the asset platforms on CoinGecko**
token_lists
Token Lists by Asset Platform ID — This endpoint allows you to **get full list of tokens of a blockchain network (asset platform) that is supported by [Ethereum token list standard](https://tokenlists.org/)** Returns: { name: string, logoURI: string, keywords: string[], ... }.
coins_categories_list
[DISCOVERY] Coins Categories List (ID Map) — This endpoint allows you to **query all the coins categories on CoinGecko** Returns: { category_id: string, name: string }.
coins_categories
[DISCOVERY] Coins Categories List with Market Data — This endpoint allows you to **query all the coins categories with market data (market cap, volume, ...) on CoinGecko** Returns: { id: string, name: string, market_cap: number, ... }.
exchanges
[DISCOVERY] Exchanges List with Data — This endpoint allows you to **query all the supported exchanges with exchanges' data (ID, name, country, ...) that have active trading volumes on CoinGecko** Returns: { id: string, name: string, year_established: number, ... }.
exchanges_list
[DISCOVERY] Exchanges List (ID Map) — This endpoint allows you to **query all the exchanges with ID and name**
exchanges_id
Exchange Data by ID — This endpoint allows you to **query exchange's data (name, year established, country, ...), exchange volume in BTC and top 100 tickers based on exchange's ID** Returns: { name: string, year_established: number, country: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
exchanges_id_tickers
Exchange Tickers by ID — This endpoint allows you to **query exchange's tickers based on exchange's ID** Returns: { name: string, tickers: { base: string, target: string, market: { name: string, identifier: string, has_trading_incentive: boolean, logo: string }, last: number, volume: number, cost_to_move_up_usd: number, ... }[] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
exchanges_id_volume_chart
Exchange Volume Chart by ID — This endpoint allows you to **query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID**
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
exchanges_id_volume_chart_range
💼 Exchange Volume Chart within Time Range by ID — This endpoint allows you to **query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID**
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
derivatives_tickers
Derivatives Tickers List — This endpoint allows you to **query all the tickers from derivatives exchanges on CoinGecko** Returns: { market: string, symbol: string, index_id: string, ... }.
derivatives_exchanges
[DISCOVERY] Derivatives Exchanges List with Data — This endpoint allows you to **query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko** Returns: { name: string, id: string, open_interest_btc: number, ... }.
derivatives_exchanges_id
Derivatives Exchange Data by ID — This endpoint allows you to **query the derivatives exchange's related data (ID, name, open interest, ...) based on the exchanges' ID** Returns: { name: string, open_interest_btc: number, trade_volume_24h_btc: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
derivatives_exchanges_list
[DISCOVERY] Derivatives Exchanges List (ID Map) — This endpoint allows you to **query all the derivatives exchanges with ID and name on CoinGecko** Returns: { id: string, name: string }.
entities_list
[DISCOVERY] Entities List (ID Map) — This endpoint allows you to **query all the supported entities on CoinGecko with entities ID, name, symbol, and country**
companies_public_treasury
Crypto Treasury Holdings by Coin ID — This endpoint allows you **query public companies & governments' cryptocurrency holdings** by Coin ID
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
public_treasury_entity
Crypto Treasury Holdings by Entity ID — This endpoint allows you **query public companies & governments' cryptocurrency holdings** by Entity ID Returns: { name: string, id: string, type: string, ... }.
public_treasury_entity_chart
Crypto Treasury Holdings Historical Chart Data by ID — This endpoint allows you to **query historical cryptocurrency holdings chart of public companies & governments** by Entity ID and Coin ID Returns: { holdings: number[][], holding_value_in_usd: number[][] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
public_treasury_transaction_history
Crypto Treasury Transaction History by Entity ID — This endpoint allows you **query public companies & governments' cryptocurrency transaction history** by Entity ID Returns: { transactions: { date: number, source_url: string, coin_id: string, type: "buy" | "sell", holding_net_change: number, transaction_value_usd: number, ... }[] }.
nfts_list
[DISCOVERY] NFTs List (ID Map) — This endpoint allows you to **query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko** Returns: { id: string, contract_address: string, name: string, ... }.
nfts_id
NFTs Collection Data by ID — This endpoint allows you to **query all the NFT data (name, floor price, 24hr volume ...) based on the NFT collection ID** Returns: { id: string, web_slug: string, contract_address: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
nfts_contract_address
NFTs Collection Data by Contract Address — This endpoint allows you to **query all the NFT data (name, floor price, 24hr volume ...) based on the NFT collection contract address and respective asset platform** Returns: { id: string, web_slug: string, contract_address: string, ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
nfts_markets
[DISCOVERY] 💼 NFTs List with Market Data — This endpoint allows you to **query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko**
nfts_id_market_chart
💼 NFTs Collection Historical Chart Data by ID — This endpoint allows you **query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now** Returns: { floor_price_usd: number[][], floor_price_native: number[][], h24_volume_usd: number[][], ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
nfts_contract_address_market_chart
💼 NFTs Collection Historical Chart Data by Contract Address — This endpoint allows you **query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now based on the provided contract address** Returns: { floor_price_usd: number[][], floor_price_native: number[][], h24_volume_usd: number[][], ... }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
nfts_id_tickers
💼 NFTs Collection Tickers by ID — This endpoint allows you to **query the latest floor price and 24hr volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and LooksRare** Returns: { tickers: { floor_price_in_native_currency: number, h24_volume_in_native_currency: number, native_currency: string, native_currency_symbol: string, updated_at: string, nft_marketplace_id: string, ... }[] }.
PREREQUISITE: First call exchange info or symbol listing to discover valid trading pairs, then query market data.
exchange_rates
BTC-to-Currency Exchange Rates — This endpoint allows you to **query BTC exchange rates with other currencies** Returns: { rates: object }.
trending_search
[DISCOVERY] Trending Search List — This endpoint allows you **query trending search coins, NFTs and categories on CoinGecko in the last 24 hours** Returns: { coins: { id: string, coin_id: number, name: string, symbol: string, market_cap_rank: number, thumb: string, ... }[], nfts: { id: string, name: string, symbol: string, thumb: string, nft_contract_id: number, native_currency_symbol: string, ... }[], categories: { id: number, name: string, market_cap_1h_change: number, slug: string, coins_count: number, data: { market_cap: number, market_cap_btc: number, total_volume: number, total_volume_btc: number, m
news
💼 Crypto News — This endpoint allows you to **query the latest crypto news and guides on CoinGecko**
crypto_global
Crypto Global Market Data — This endpoint allows you **query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc** Returns: { data: { active_cryptocurrencies: number, upcoming_icos: number, ongoing_icos: number, ended_icos: number, markets: number, total_market_cap: { btc: number, eth: number }, ... } }.
global_de_fi
Global DeFi Market Data — This endpoint allows you **query top 100 cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume** Returns: { data: { defi_market_cap: string, eth_market_cap: string, defi_to_eth_ratio: string, trading_volume_24h: string, defi_dominance: string, top_coin_name: string, ... } }.
global_market_cap_chart
💼 Global Market Cap Chart Data — This endpoint allows you to **query historical global market cap and volume data by number of days away from now** Returns: { market_cap_chart: { market_cap: number[][], volume: number[][] } }.