AI 原生开放教材

外观

Vibe Coding CN课时教程·中英混排原文 ↗原件 ↓仓库 ↗

Entities List (ID Map) ​

Source: https://docs.coingecko.com/v3.0.1/reference/entities-list

v3.0.1/reference/api-reference/coingecko-demo.json get /entities/list This endpoint allows you to query all the supported entities on CoinGecko with entities ID, name, symbol, and country

Note ​

  • Cache / Update Frequency: every 5 minutes for all the API plans.

BTC-to-Currency Exchange Rates ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchange-rates

v3.0.1/reference/api-reference/coingecko-demo.json get /exchange_rates This endpoint allows you to query BTC exchange rates with other currencies

Tips ​

  • You may use this endpoint to convert the response data, which is originally in BTC, to other currencies.

Note ​

  • Cache / Update Frequency: every 5 minutes for all the API plans.

Exchanges List with data ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchanges

v3.0.1/reference/api-reference/coingecko-demo.json get /exchanges This endpoint allows you to query all the supported exchanges with exchanges' data (ID, name, country, ...) that have active trading volumes on CoinGecko

Tips ​

  • You may include values such as per_page and page to specify how many results you would like to show in the responses per page and which page of responses you would like to show.

Note ​

  • All the exchanges in the responses are the exchanges with active trading volume on CoinGecko, any inactive or deactivated exchanges will be removed from the list.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Exchange Data by ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchanges-id

v3.0.1/reference/api-reference/coingecko-demo.json get /exchanges/{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

Notice ​

  • Please note that the trade_volume_24h_btc_normalized data field will no longer be supported by our API starting on June 15, 2025. Please refer to changelog for more details.

Note ​

  • The exchange volume in the response is provided in BTC. To convert it to other currencies, please use /exchange_rates endpoint.
  • For derivatives (e.g. bitmex, binance_futures), to get derivatives exchanges data, please go to /derivatives/exchange/\{id} endpoint.
  • Tickers are limited to 100 items, to get more tickers, please go to /exchanges/\{id}/tickers endpoint.
  • When dex_pair_format=symbol, the DEX pair base and target are displayed in symbol format (e.g. WETH, USDC) instead of as contract addresses.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Exchange Tickers by ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchanges-id-tickers

v3.0.1/reference/api-reference/coingecko-demo.json get /exchanges/{id}/tickers This endpoint allows you to query exchange's tickers based on exchange's ID

Note ​

  • Responses are paginated and limited to 100 tickers per page. You may specify the page number using the page params to retrieve the tickers accordingly.
  • order=base_target sorts tickers by base symbol, then target symbol, in lexicographical order (0 -> 9, followed by a -> z).
    This sorting method ensures stable pagination results, minimizing cases where cached responses might otherwise cause duplicate or missing tickers across paginated pages.
  • When dex_pair_format=symbol, the DEX pair base and target are displayed in symbol format (e.g. WETH, USDC) instead of as contract addresses.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Exchange Volume Chart by ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchanges-id-volume-chart

v3.0.1/reference/api-reference/coingecko-demo.json get /exchanges/{id}/volume_chart 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

Note ​

  • You can use this endpoint to query the historical volume chart data of derivatives exchanges as well.
  • The exchange volume in the response is provided in BTC. To convert it to other currencies, please use /exchange_rates endpoint.
  • Data granularity is automatic (cannot be adjusted):
    • 1 day = 10-minutely
    • 7, 14 days = hourly
    • 30 days & above = daily
  • Cache / Update Frequency: every 60 seconds for all the API plans.

Exchanges List (ID Map) ​

Source: https://docs.coingecko.com/v3.0.1/reference/exchanges-list

v3.0.1/reference/api-reference/coingecko-demo.json get /exchanges/list This endpoint allows you to query all the exchanges with ID and name

Tips ​

  • You may use this endpoint to query the list of exchanges including derivatives exchanges for other endpoints that contain params like id(exchange ID).

Note ​

  • There is no pagination required for this endpoint.
  • Cache / Update Frequency: every 5 minutes for all the API plans.

Global DeFi Market Data ​

Source: https://docs.coingecko.com/v3.0.1/reference/global-defi

v3.0.1/reference/api-reference/coingecko-demo.json get /global/decentralized_finance_defi This endpoint allows you query top 100 cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume

New Pools List ​

Source: https://docs.coingecko.com/v3.0.1/reference/latest-pools-list

v3.0.1/reference/api-reference/onchain-demo.json get /networks/new_pools This endpoint allows you to query all the latest pools across all networks on GeckoTerminal

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com/explore/new-crypto-pools

New Pools by Network ​

Source: https://docs.coingecko.com/v3.0.1/reference/latest-pools-network

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/new_pools This endpoint allows you to query all the latest pools based on provided network

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.

Note ​

  • This endpoint includes the newly created pools in the past 48 hours.
  • 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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com/explore/new-crypto-pools/solana

Supported Networks List (ID Map) ​

Source: https://docs.coingecko.com/v3.0.1/reference/networks-list

v3.0.1/reference/api-reference/onchain-demo.json get /networks This endpoint allows you to query all the supported networks on GeckoTerminal

Tips ​

  • You may use this endpoint to query the list of networks with network ID for other endpoints that contain params like network.
  • You may include values such as page to specify which page of responses you would like to show.

NFTs Collection Data by Contract Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/nfts-contract-address

v3.0.1/reference/api-reference/coingecko-demo.json get /nfts/{asset_platform_id}/contract/{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

Tips ​

  • You may also obtain the asset platform id and contract address through /nfts/list endpoint.

Note ​

  • Solana NFT & Art Blocks are not supported for this endpoint, please use /nfts/\{id} endpoint instead.
  • Cache / Update Frequency: every 60 seconds for all the API plans.

NFTs Collection Data by ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/nfts-id

v3.0.1/reference/api-reference/coingecko-demo.json get /nfts/{id} This endpoint allows you to query all the NFT data (name, floor price, 24hr volume ...) based on the NFT collection ID

Note ​

  • Cache / Update Frequency: every 60 seconds for all the API plans.

NFTs List (ID Map) ​

Source: https://docs.coingecko.com/v3.0.1/reference/nfts-list

v3.0.1/reference/api-reference/coingecko-demo.json get /nfts/list This endpoint allows you to query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko

Tips ​

  • You may use this endpoint to query the list of NFTs for other endpoints that contain params like id (NFT collection's id) as well as asset_platform_id and contract_address.
  • You may include values such as per_page and page to specify how many results you would like to show in the responses per page and which page of responses you would like to show.

Note ​

  • The responses are paginated to 100 items.
  • Cache / Update Frequency: every 5 minutes for all the API plans.

Token Price by Token Addresses ​

Source: https://docs.coingecko.com/v3.0.1/reference/onchain-simple-price

v3.0.1/reference/api-reference/onchain-demo.json get /simple/networks/{network}/token_price/{addresses} This endpoint allows you to get token price based on the provided token contract address on a network

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 parameter mcap_fdv_fallback=true.
  • The returned price currency is in USD.
  • Addresses not found in GeckoTerminal will be ignored.
  • This endpoint allows querying up to 30 contract addresses per request.
  • 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 60 seconds.

Check API server status ​

Source: https://docs.coingecko.com/v3.0.1/reference/ping-server

v3.0.1/reference/api-reference/coingecko-demo.json get /ping This endpoint allows you to check the API server status

Note ​

  • You can also go to status.coingecko.com to check the API server status and further maintenance notices.

Specific Pool Data by Pool Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/pool-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools/{address} This endpoint allows you to query the specific pool based on the provided network and pool address

Note ​

  • Address not found in GeckoTerminal will be ignored.
  • 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).
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain network.
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • locked_liquidity_percentage will be updated on daily basis.
  • Set include_composition=true to surface the balance and liquidity value of the pool's base and quote tokens.
  • Pools on a bonding curve (e.g. non-graduated pools from launchpads) will return launchpad_details object with their graduation status and migration details.
  • Cache/Update Frequency: every 60 seconds.

Pool OHLCV chart by Pool Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/pool-ohlcv-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools/{pool_address}/ohlcv/{timeframe} This endpoint allows you to get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network

Tips ​

  • You may use this endpoint to query the historical price and volume of a token.
  • You may select the timeframe with its respective aggregate to get the intended OHLCV data (e.g. minute?aggregate=15 for 15 minutes OHLCV).

Note ​

  • This endpoint uses epoch/unix format for its timestamp. Example: 1708850449.
  • Paid plan subscribers (Analyst plan & above) can access data from September 2021 to the present, depending on when the pool started tracking on GeckoTerminal.
    • If no earlier data is available, an empty response will be returned.
    • Each API call can only retrieve data for a maximum range of 6 months. To fetch older data, use the before_timestamp parameter to query in multiple requests.
  • Pools with more than 2 tokens are not yet supported for this endpoint.
  • Each OHLCV array (under "ohlcv_list") consists of 6 elements in the following order:
    • Timestamp: The epoch/unix timestamp representing the start of the time interval.
    • Open: The opening price of the asset at the beginning of the interval.
    • High: The highest price reached during the interval.
    • Low: The lowest price reached during the interval.
    • Close: The price of the asset at the end of the interval.
    • Volume: The total trading volume of the asset during the interval.
  • Skipped Intervals: To ensure concise and relevant data, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded from the response.
    • Higher granularity timeframes (e.g. 1 minute) are more likely to skip intervals due to periods of inactivity, while lower granularity timeframes (e.g. daily) are less affected.
  • For include_empty_intervals param:
    • When false (default): Only intervals with trade data are returned.
    • When true: All requested intervals are returned, those with no trade data are populated as follows:
      • OHLC (Open, High, Low, Close) are all set to the Close price of the previous interval.
        • O = H = L = C = previous Close
      • Volume (V) is set to 0, reflecting no trade activity.
  • Cache/Update frequency: every 60 seconds.

Pool Tokens Info by Pool Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/pool-token-info-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools/{pool_address}/info This endpoint allows you to query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network

Tips ​

  • If you would like to query pool data such as price, transactions, volume and etc. You can go to this endpoint /networks/\{network\}/pools/\{address\} instead.
  • Cache/Update frequency: every 60 seconds.
  • Learn more about GT score here.
  • Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by CoinGecko team, you may use the following endpoints:

Note ​

  • holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
    • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
    • distribution_percentage coverage:
      • Solana: top_10, 11_20, 21_40, rest
      • Other chains: top_10, 11_30, 31_50, rest
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.

Past 24 Hour Trades by Pool Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/pool-trades-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools/{pool_address}/trades This endpoint allows you to query the last 300 trades in the past 24 hours based on the provided pool address

Note ​

  • Cache/Update Frequency: every 60 seconds.

Multiple Pools Data by Pool Addresses ​

Source: https://docs.coingecko.com/v3.0.1/reference/pools-addresses

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools/multi/{addresses} This endpoint allows you to query multiple pools based on the provided network and pool address

Note ​

  • Addresses not found in GeckoTerminal will be ignored.
  • 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).
  • This endpoint allows querying up to 30 contract addresses per request.
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain network.
  • Attributes specified in the include params will be included under the "included" key at the top level.
  • locked_liquidity_percentage will be updated on daily basis.
  • Set include_composition=true to surface the balance and liquidity value of the pool's base and quote tokens.
  • Pools on a bonding curve (e.g. non-graduated pools from launchpads) will return launchpad_details object with their graduation status and migration details.
  • Cache/Update Frequency: every 60 seconds.

Crypto Treasury Holdings by Entity ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/public-treasury-entity

v3.0.1/reference/api-reference/coingecko-demo.json get /public_treasury/{entity_id} This endpoint allows you query public companies & governments' cryptocurrency holdings by Entity ID

Note ​

Search Queries ​

Source: https://docs.coingecko.com/v3.0.1/reference/search-data

v3.0.1/reference/api-reference/coingecko-demo.json get /search This endpoint allows you to search for coins, categories and markets listed on CoinGecko

Note ​

  • The responses are sorted in descending order by market cap.
  • Cache / Update Frequency: every 15 minutes for all the API plans.

Search Pools ​

Source: https://docs.coingecko.com/v3.0.1/reference/search-pools

v3.0.1/reference/api-reference/onchain-demo.json get /search/pools This endpoint allows you to search for pools on a network

Tips ​

  • You may use this endpoint to search for query such as pool contract address, token contract address or token symbol. The endpoint will return matching pools as response.
  • You may include values such as page to specify which page of responses you would like to show.

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.

Coin Price by IDs ​

Source: https://docs.coingecko.com/v3.0.1/reference/simple-price

v3.0.1/reference/api-reference/coingecko-demo.json get /simple/price This endpoint allows you to query the prices of one or more coins by using their unique Coin API IDs

Tips ​

  • You may obtain the coin ID (API ID) via several ways:
    • refers to respective coin page and find 'API ID'.
    • refers to /coins/list endpoint.
    • refers to Google Sheets here.
  • You can retrieve specific coins using their unique ids, names, or symbols.
  • You may flag to include more data such as market cap, 24hr volume, 24hr change, last updated time etc.
  • To verify if a price is stale, you may flag include_last_updated_at=true in your request to obtain the latest updated time. Alternatively, you may flag include_24hr_change=true to determine if it returns a null value.

Note ​

  • You may cross-check the price on CoinGecko and learn more about our price methodology here.
  • When multiple lookup params are provided, the following priority order is applied: ids (highest) > names > symbols (lowest).
  • When searching by name, you need to URL-encode any spaces (e.g. "Binance Coin" becomes "Binance%20Coin").
  • The include_tokens=all param is exclusively for use with the symbols lookup and is limited to maximum of 50 symbols per request.
  • Wildcard searches are not supported for lookup params (ids, names, symbols).
  • Cache/Update Frequency: every 60 seconds for Public API.
    • Every 20 seconds for Pro-API (Analyst, Lite, Pro, Enterprise).

Supported Currencies List ​

Source: https://docs.coingecko.com/v3.0.1/reference/simple-supported-currencies

v3.0.1/reference/api-reference/coingecko-demo.json get /simple/supported_vs_currencies This endpoint allows you to query all the supported currencies on CoinGecko

Tips ​

  • You may use this endpoint to query the list of currencies for other endpoints that contain params like vs_currencies.

Note ​

  • Cache/Update Frequency: every 60 seconds for Public API.

Coin Price by Token Addresses ​

Source: https://docs.coingecko.com/v3.0.1/reference/simple-token-price

v3.0.1/reference/api-reference/coingecko-demo.json get /simple/token_price/{id} This endpoint allows you to query one or more token prices using their token contract addresses

Tips ​

  • You may obtain the asset platform and contract address via several ways:
    • refers to respective coin page and find 'contract address'.
    • refers to /coins/list endpoint (include platform = true).
  • You may flag to include more data such as market cap, 24hr volume, 24hr change, last updated time etc.

Note ​

  • The endpoint returns the global average price of the coin that is aggregated across all active exchanges on CoinGecko.
  • You may cross-check the price on CoinGecko and learn more about our price methodology here.
  • Cache/Update Frequency: every 60 seconds for Public API.
    • Every 20 seconds for Pro-API (Analyst, Lite, Pro, Enterprise).

Token Data by Token Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/token-data-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/tokens/{address} This endpoint allows you to query specific token data based on the provided token contract address on a network

Tips ​

  • You may add values such as top_pools in the include param to include top pools along with the pools information.
  • If you would like to query token information such as socials, websites, description and etc. You can go to this endpoint /networks/\{network\}/tokens/\{address\}/info instead.

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).
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain network.
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • Set include_composition=true to surface the balance and liquidity value of the pool's base and quote tokens. (requires include=top_pools)
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.
  • Cache/Update frequency: every 60 seconds.

Token Info by Token Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/token-info-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/tokens/{address}/info This endpoint allows you to query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network

Tips ​

  • If you would like to query token data such as decimals, total supply, price and etc. You can go to this endpoint /networks/\{network\}/tokens/\{address\} instead.
  • Cache/Update frequency: every 60 seconds.
  • Learn more about GT score here.
  • Metadata (image, websites, description, socials) may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by CoinGecko team, you may use the following endpoints:

Note ​

  • holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
    • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
    • distribution_percentage coverage:
      • Solana: top_10, 11_20, 21_40, rest
      • Other chains: top_10, 11_30, 31_50, rest
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.

Token Lists by Asset Platform ID ​

Source: https://docs.coingecko.com/v3.0.1/reference/token-lists

v3.0.1/reference/api-reference/coingecko-demo.json get /token_lists/{asset_platform_id}/all.json This endpoint allows you to get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard

Note ​

  • Cache/Update Frequency: 5 minutes.
  • A token will only be included in the list if the contract address is added by CoinGecko team. If you identified any missing token, you may submit a request here.

Tokens Data by Token Addresses ​

Source: https://docs.coingecko.com/v3.0.1/reference/tokens-data-contract-addresses

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/tokens/multi/{addresses} This endpoint allows you to query multiple tokens data based on the provided token contract addresses on a network

Tips ​

  • You may add values such as top_pools in the include param to include top pools along with the pools information.
  • If you would like to query token information such as socials, websites, description and etc. You can go to this endpoint /networks/\{network\}/tokens/\{address\}/info instead.

Note ​

  • Addresses not found in GeckoTerminal.com will be ignored.
  • This endpoint allows querying up to 30 contract addresses per request.
  • The endpoint will only return the first top pool for each token.
  • 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).
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain network.
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • Set include_composition=true to surface the balance and liquidity value of the pool's base and quote tokens. (requires include=top_pools)
  • For tokens on a bonding curve (i.e. non-graduated tokens from launchpads), the response will include a launchpad_details object containing their graduation status and details.
  • Cache/Update frequency: every 60 seconds.

Most Recently Updated Tokens List ​

Source: https://docs.coingecko.com/v3.0.1/reference/tokens-info-recent-updated

v3.0.1/reference/api-reference/onchain-demo.json get /tokens/info_recently_updated This endpoint allows you to query 100 most recently updated tokens info of a specific network or across all networks on GeckoTerminal

Tips ​

  • You may add values such as network in the include param to include network along with the updated tokens list.

Note ​

  • Attributes specified in the include param will be returned under the top-level "included" key.
  • Cache/Update frequency: every 60 seconds.

Top Pools by Token Address ​

Source: https://docs.coingecko.com/v3.0.1/reference/top-pools-contract-address

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/tokens/{token_address}/pools This endpoint allows you to query top pools based on the provided token contract address on a network

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.

Note ​

  • The ranking of the top 20 pools is established by evaluating their liquidity and trading activity to identify the most liquid ones. This ranking is determined through a combination of two key factors: liquidity (reserve_in_usd) and 24-Hour Trading Volume (volume_usd).
  • 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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.

Top Pools by Dex ​

Source: https://docs.coingecko.com/v3.0.1/reference/top-pools-dex

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/dexes/{dex}/pools This endpoint allows you to query all the top pools based on the provided network and decentralized exchange (DEX)

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.
  • For more flexibility in retrieving an exact list of pools that match your specific needs, consider using the /pools/megafilter endpoint (available for Paid Plan subscribers [Analyst plan or above].)

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com/base/uniswap-v3-base/pools?sort=-24h_transactions

Top Pools by Network ​

Source: https://docs.coingecko.com/v3.0.1/reference/top-pools-network

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/pools This endpoint allows you to query all the top pools based on the provided network

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.
  • For more flexibility in retrieving an exact list of pools that match your specific needs, consider using the /pools/megafilter endpoint (available for Paid Plan subscribers [Analyst plan or above].)

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com/solana/pools?sort=-24h_transactions

Trending Pools List ​

Source: https://docs.coingecko.com/v3.0.1/reference/trending-pools-list

v3.0.1/reference/api-reference/onchain-demo.json get /networks/trending_pools This endpoint allows you to query all the trending pools across all networks on GeckoTerminal

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.
  • For more flexibility in retrieving an exact list of pools that match your specific needs, consider using the /pools/megafilter endpoint (available for Paid Plan subscribers [Analyst plan or above].)

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com

Trending Pools by Network ​

Source: https://docs.coingecko.com/v3.0.1/reference/trending-pools-network

v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/trending_pools This endpoint allows you to query the trending pools based on the provided network

Tips ​

  • You may include values such as page to specify which page of responses you would like to show.
  • For more flexibility in retrieving an exact list of pools that match your specific needs, consider using the /pools/megafilter endpoint (available for Paid Plan subscribers [Analyst plan or above].)

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).
  • Attributes specified in the include param will be returned under the top-level "included" key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.
  • GeckoTerminal equivalent page (example): https://www.geckoterminal.com/base/pools

Trending Search List ​

Source: https://docs.coingecko.com/v3.0.1/reference/trending-search

v3.0.1/reference/api-reference/coingecko-demo.json get /search/trending This endpoint allows you query trending search coins, NFTs and categories on CoinGecko in the last 24 hours

Note ​

  • The endpoint currently supports:
    • Top 15 trending coins (sorted by the most popular user searches)
    • Top 7 trending NFTs (sorted by the highest percentage change in floor prices)
    • Top 5 trending categories (sorted by the most popular user searches)
  • Cache / Update Frequency: every 10 minutes for all the API plans.

CGSimplePrice ​

Source: https://docs.coingecko.com/websocket/cgsimpleprice

Subscribe to receive real-time price updates for tokens, as seen on CoinGecko.com

This Websocket channel allows you to subscribe to real-time updates of price changes for token.

  • Lookup by Coin ID
  • It will return price & market data of the top pool of the specified token

Update Frequency: as fast as ~10s, for large cap and actively traded coins.

Data Payload ​

FieldTypeDescriptionExample
cchannel_typestringIndicates the type of channel subscribed to.C1
icoin_idstringIdentifier of the coins. Check full list of IDs here.ethereum, usd-coin
pusd_pricestringCurrent token price in USD.3639.78228844745
ppusd_price_24h_change_percentagefloatPercentage change in token price over the last 24 hours.3.566
musd_market_capfloatMarket capitalization in USD.123
vusd_24h_volfloat24-hour trading volume in USD.31233333.33
tlast_updated_atintegerTimestamp of the last data update in UNIX time.1709542750

Tips: The Websocket payload will use the value null when specific data is unavailable. Ensure your application is capable of handling null values for fields that may not always have data.