# Table of Contents
- [Introduction - CoinGecko API](#introduction-coingecko-api)
- [Authentication (Pro API) - CoinGecko API](#authentication-pro-api-coingecko-api)
- [Authentication (Public/Demo) - CoinGecko API](#authentication-public-demo-coingecko-api)
- [Setting Up Your API Key - CoinGecko API](#setting-up-your-api-key-coingecko-api)
- [Common Errors & Rate Limit - CoinGecko API](#common-errors-rate-limit-coingecko-api)
- [API Status - CoinGecko API](#api-status-coingecko-api)
- [CoinGecko SDK (Beta) - CoinGecko API](#coingecko-sdk-beta-coingecko-api)
- [WebSocket (Beta) - CoinGecko API](#websocket-beta-coingecko-api)
- [Tutorials (Beginner-friendly) - CoinGecko API](#tutorials-beginner-friendly-coingecko-api)
- [Useful Links - CoinGecko API](#useful-links-coingecko-api)
- [Clients - CoinGecko API](#clients-coingecko-api)
- [Building with AI - CoinGecko API](#building-with-ai-coingecko-api)
- [CoinGecko MCP Server (Beta) - CoinGecko API](#coingecko-mcp-server-beta-coingecko-api)
- [Best Practices - CoinGecko API](#best-practices-coingecko-api)
- [Endpoint Showcase - CoinGecko API](#endpoint-showcase-coingecko-api)
- [Common Use Cases - CoinGecko API](#common-use-cases-coingecko-api)
- [Changelog - CoinGecko API](#changelog-coingecko-api)
- [Check API server status - CoinGecko API](#check-api-server-status-coingecko-api)
- [Token Price by Token Addresses - CoinGecko API](#token-price-by-token-addresses-coingecko-api)
- [Check API server status - CoinGecko API](#check-api-server-status-coingecko-api)
- [Endpoint Overview - CoinGecko API](#endpoint-overview-coingecko-api)
- [Endpoint Overview - CoinGecko API](#endpoint-overview-coingecko-api)
- [CGSimplePrice - CoinGecko API](#cgsimpleprice-coingecko-api)
- [OnchainSimpleTokenPrice - CoinGecko API](#onchainsimpletokenprice-coingecko-api)
- [OnchainTrade - CoinGecko API](#onchaintrade-coingecko-api)
- [OnchainOHLCV - CoinGecko API](#onchainohlcv-coingecko-api)
- [Coins List (ID Map) - CoinGecko API](#coins-list-id-map-coingecko-api)
- [AI Prompts - CoinGecko API](#ai-prompts-coingecko-api)
- [Unknown](#unknown)
- [Crypto Global Market Data - CoinGecko API](#crypto-global-market-data-coingecko-api)
- [Trending Search List - CoinGecko API](#trending-search-list-coingecko-api)
- [Supported Currencies List - CoinGecko API](#supported-currencies-list-coingecko-api)
- [TypeScript AI Prompts - CoinGecko API](#typescript-ai-prompts-coingecko-api)
- [Python AI Prompts - CoinGecko API](#python-ai-prompts-coingecko-api)
- [Supported Networks List (ID Map) - CoinGecko API](#supported-networks-list-id-map-coingecko-api)
- [Asset Platforms List (ID Map) - CoinGecko API](#asset-platforms-list-id-map-coingecko-api)
- [Coins Categories List with Market Data - CoinGecko API](#coins-categories-list-with-market-data-coingecko-api)
- [Token Lists by Asset Platform ID - CoinGecko API](#token-lists-by-asset-platform-id-coingecko-api)
- [BTC-to-Currency Exchange Rates - CoinGecko API](#btc-to-currency-exchange-rates-coingecko-api)
- [Supported Dexes List by Network (ID Map) - CoinGecko API](#supported-dexes-list-by-network-id-map-coingecko-api)
- [Exchanges List (ID Map) - CoinGecko API](#exchanges-list-id-map-coingecko-api)
- [💼 Pools by Category ID - CoinGecko API](#-pools-by-category-id-coingecko-api)
- [Search Queries - CoinGecko API](#search-queries-coingecko-api)
- [Coin Price by IDs - CoinGecko API](#coin-price-by-ids-coingecko-api)
- [💼 NFTs Collection Historical Chart Data by ID - CoinGecko API](#-nfts-collection-historical-chart-data-by-id-coingecko-api)
- [💼 Categories List - CoinGecko API](#-categories-list-coingecko-api)
- [Coin Historical Chart Data by Token Address - CoinGecko API](#coin-historical-chart-data-by-token-address-coingecko-api)
- [Exchange Volume Chart by ID - CoinGecko API](#exchange-volume-chart-by-id-coingecko-api)
- [Coin Historical Chart Data within Time Range by Token Address - CoinGecko API](#coin-historical-chart-data-within-time-range-by-token-address-coingecko-api)
- [Page Not Found](#page-not-found)
- [Exchange Tickers by ID - CoinGecko API](#exchange-tickers-by-id-coingecko-api)
- [Pool OHLCV chart by Pool Address - CoinGecko API](#pool-ohlcv-chart-by-pool-address-coingecko-api)
- [Past 24 Hour Trades by Pool Address - CoinGecko API](#past-24-hour-trades-by-pool-address-coingecko-api)
- [💼 Token OHLCV chart by Token Address - CoinGecko API](#-token-ohlcv-chart-by-token-address-coingecko-api)
- [Exchange Data by ID - CoinGecko API](#exchange-data-by-id-coingecko-api)
- [NFTs Collection Data by ID - CoinGecko API](#nfts-collection-data-by-id-coingecko-api)
- [💼 NFTs Collection Tickers by ID - CoinGecko API](#-nfts-collection-tickers-by-id-coingecko-api)
- [Trending Pools List - CoinGecko API](#trending-pools-list-coingecko-api)
- [Token Info by Token Address - CoinGecko API](#token-info-by-token-address-coingecko-api)
- [Search Pools - CoinGecko API](#search-pools-coingecko-api)
- [New Pools List - CoinGecko API](#new-pools-list-coingecko-api)
- [Token Data by Token Address - CoinGecko API](#token-data-by-token-address-coingecko-api)
- [💼 Top Gainers & Losers - CoinGecko API](#-top-gainers-losers-coingecko-api)
- [Coins Categories List (ID Map) - CoinGecko API](#coins-categories-list-id-map-coingecko-api)
- [💼 API Usage - CoinGecko API](#-api-usage-coingecko-api)
- [💼 Recently Added Coins - CoinGecko API](#-recently-added-coins-coingecko-api)
- [💼 Past 24 Hour Trades by Token Address - CoinGecko API](#-past-24-hour-trades-by-token-address-coingecko-api)
- [Crypto Treasury Holdings by Coin ID - CoinGecko API](#crypto-treasury-holdings-by-coin-id-coingecko-api)
- [Derivatives Exchange Data by ID - CoinGecko API](#derivatives-exchange-data-by-id-coingecko-api)
- [💼 Trending Search Pools - CoinGecko API](#-trending-search-pools-coingecko-api)
- [Crypto Treasury Holdings by Entity ID - CoinGecko API](#crypto-treasury-holdings-by-entity-id-coingecko-api)
- [Coin Tickers by ID - CoinGecko API](#coin-tickers-by-id-coingecko-api)
- [Coin Historical Chart Data by ID - CoinGecko API](#coin-historical-chart-data-by-id-coingecko-api)
- [Crypto Treasury Holdings Historical Chart Data by ID - CoinGecko API](#crypto-treasury-holdings-historical-chart-data-by-id-coingecko-api)
- [Coin Price by Token Addresses - CoinGecko API](#coin-price-by-token-addresses-coingecko-api)
- [🔥 Megafilter for Pools - CoinGecko API](#-megafilter-for-pools-coingecko-api)
- [Entities List (ID Map) - CoinGecko API](#entities-list-id-map-coingecko-api)
- [Crypto Treasury Transaction History by Entity ID - CoinGecko API](#crypto-treasury-transaction-history-by-entity-id-coingecko-api)
- [New Pools by Network - CoinGecko API](#new-pools-by-network-coingecko-api)
- [💼 Global Market Cap Chart Data - CoinGecko API](#-global-market-cap-chart-data-coingecko-api)
- [Top Pools by Network - CoinGecko API](#top-pools-by-network-coingecko-api)
- [Top Pools by Token Address - CoinGecko API](#top-pools-by-token-address-coingecko-api)
- [Coin OHLC Chart by ID - CoinGecko API](#coin-ohlc-chart-by-id-coingecko-api)
- [Coin Historical Chart Data within Time Range by ID - CoinGecko API](#coin-historical-chart-data-within-time-range-by-id-coingecko-api)
- [Trending Pools by Network - CoinGecko API](#trending-pools-by-network-coingecko-api)
---
# Introduction - CoinGecko API
[Skip to main content](https://docs.coingecko.com/#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
Ctrl K
Search...
Navigation
Getting started
Introduction
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Started in 2014, CoinGecko is the world’s largest independent crypto data aggregator that is integrated with more than 1,000 crypto exchanges and lists more than 18,000 coins across 600+ categories. CoinGecko API offers the most comprehensive and reliable crypto market data through RESTful JSON endpoints. CoinGecko API now serves **onchain DEX data** across 250+ blockchain networks, 1,700+ decentralized exchanges (DEXes), and 15M+ tokens, powered by GeckoTerminal. Thousands of forward-thinking projects, Web3 developers, researchers, institutions, and enterprises use our API to obtain **price feeds, market data, metadata, and historical data of crypto assets, NFTs, and exchanges**. Here are some of the **common use cases** for clients who use CoinGecko API:
* Crypto Exchanges (CEX, DEX), Trading Apps
* Wallets (Hot, Cold)
* Data Aggregator, Crypto Screener, Analytics Dashboard
* AI Agents, DeFAI Apps
* Block Explorer, Portfolio Tracker
* DeFi Protocols, NFT Marketplaces, Digital Bank
* Backtesting Trading Strategy
* Accounting, Tax, Audit, HR Payroll
* Research & Analysis: Media, Institution, Academic, VC, Financial
* Oracles, Bots, Payments, E-commerce
🔥 New: [WebSocket API](https://docs.coingecko.com/websocket)
[](https://docs.coingecko.com/websocket)
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our [paid API plan](https://www.coingecko.com/en/api/pricing)
(Analyst plan & above) to access WebSocket and REST API data delivery methods.
[Setting Up Your API Key\
-----------------------\
\
Start by creating your CoinGecko API key](https://docs.coingecko.com/docs/setting-up-your-api-key)
[Building with AI\
----------------\
\
Bring CoinGecko data to your AI apps](https://docs.coingecko.com/docs/building-with-ai)
Was this page helpful?
YesNo
Ctrl+I
Cookie Settings
Assistant
Responses are generated using AI and may contain mistakes.
Opt out of sale of personal data and targeted advertising
---------------------------------------------------------
When you visit our website, we store cookies on your browser to collect information. The information collected might relate to you, your preferences or your device, and is mostly used to make the site work as you expect it to and to provide a more personalized web experience. However, you can choose not to allow certain types of cookies, which may impact your experience of the site and the services we are able to offer. Click on the different category headings to find out more and change our default settings according to your preference. You cannot opt-out of our First Party Strictly Necessary Cookies as they are deployed in order to ensure the proper functioning of our website (such as prompting the cookie banner and remembering your settings, to log into your account, to redirect you when you log out, etc.). For more information about the First and Third Party Cookies used please follow this link.
[More information](https://www.coingecko.com/en/privacy)
Allow All
### Manage Consent Preferences
#### Strictly Necessary Cookies
Always Active
These cookies are necessary for the website to function and cannot be switched off in our systems. They are usually only set in response to actions made by you which amount to a request for services, such as setting your privacy preferences, logging in or filling in forms. You can set your browser to block or alert you about these cookies, but some parts of the site will not then work. These cookies do not store any personally identifiable information.
#### Sale of Personal Data and Targeted Advertising
Sale of Personal Data and Targeted Advertising
Third party trackers collect information to use for analytics and to personalize your experience with targeted ads. Under the Colorado CPA, the Virginia CDPA, the Texas DPSA, the Oregon CPA, the Montana CDPA, and the Florida DBR, you have the right to opt-out of the sale of your personal data to third parties, of targeted advertising related processing, and of some types of profiling. You may exercise your rights by using the toggles below. If you opt out, the ads and content that you see may not be as relevant to you. Under the Colorado CPA, you have the right to opt back in to these categories at any time should you initially choose to opt out, and you may do so using the same toggles provided below. For more details on the data we process and how to exercise your rights, and to view information related to required opt-in disclosures, see our Privacy Policy
* ##### Performance Cookies
Switch Label label
These cookies allow us to count visits and traffic sources so we can measure and improve the performance of our site. They help us to know which pages are the most and least popular and see how visitors move around the site. All information these cookies collect is aggregated and therefore anonymous. If you do not allow these cookies we will not know when you have visited our site, and will not be able to monitor its performance.
* ##### Targeting Cookies
Switch Label label
These cookies may be set through our site by our advertising partners. They may be used by those companies to build a profile of your interests and show you relevant adverts on other sites. They do not store directly personal information, but are based on uniquely identifying your browser and internet device. If you do not allow these cookies, you will experience less targeted advertising.
Back Button
### Cookie List
Search Icon
Filter Icon
Clear
checkbox label label
Apply Cancel
Consent Leg.Interest
checkbox label label
checkbox label label
checkbox label label
Confirm My Choices
[](https://www.onetrust.com/products/cookie-consent/)
---
# Authentication (Pro API) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/authentication#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Overview
Authentication (Pro API)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Notes](https://docs.coingecko.com/reference/authentication#notes)
* [CoinGecko API Authentication Method](https://docs.coingecko.com/reference/authentication#coingecko-api-authentication-method)
* [🔥 Accessing Onchain DEX data](https://docs.coingecko.com/reference/authentication#%F0%9F%94%A5-accessing-onchain-dex-data)
* [Notes](https://docs.coingecko.com/reference/authentication#notes-2)
* [API Key Usage Credits](https://docs.coingecko.com/reference/authentication#api-key-usage-credits)
###
[](https://docs.coingecko.com/reference/authentication#notes)
**Notes**
* Pro API Key is only available for [CoinGecko API paid plan](https://www.coingecko.com/en/api/pricing)
subscribers, the root URL for CoinGecko Pro API must be `https://pro-api.coingecko.com/api/v3/`.
* You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL.
* It’s highly recommended to use the Headers method when making API requests for better security. Using query string parameters can risk exposing your API key.
[](https://docs.coingecko.com/reference/authentication#coingecko-api-authentication-method)
CoinGecko API Authentication Method
-----------------------------------------------------------------------------------------------------------------------------------
If this is your first time using the Pro API key, you can supply API Key to the root URL using one of these ways:
1. Header (Recommended): `x-cg-pro-api-key`
2. Query String Parameter: `x_cg_pro_api_key`
| Authentication Method | Example using [Ping](https://docs.coingecko.com/reference/ping-server)
Endpoint |
| --- | --- |
| Header (cURL) | `curl -X GET "https://pro-api.coingecko.com/api/v3/ping" -H "x-cg-pro-api-key: YOUR_API_KEY"` |
| Query String Parameter | `https://pro-api.coingecko.com/api/v3/ping?x_cg_pro_api_key=YOUR_API_KEY` |
[](https://docs.coingecko.com/reference/authentication#%F0%9F%94%A5-accessing-onchain-dex-data)
🔥 Accessing Onchain DEX data
---------------------------------------------------------------------------------------------------------------------------------
You can now use the Pro-API key (exclusive to any paid plan subscriber) to call onchain DEX data powered by [GeckoTerminal](https://www.geckoterminal.com/)
.
###
[](https://docs.coingecko.com/reference/authentication#notes-2)
**Notes**
* Authentication method for onchain endpoints is exactly same as other endpoints.
* When using the CG Pro API to access onchain DEX data, include the `/onchain` endpoint path in the request.
| Authentication Method | Example using [Simple Token Price](https://docs.coingecko.com/reference/onchain-simple-price)
Endpoint |
| --- | --- |
| Header (cURL) | `curl -X GET "" -H "x-cg-pro-api-key: YOUR_API_KEY"` |
| Query String Parameter | `https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2?x_cg_pro_api_key=YOUR_API_KEY` |
[](https://docs.coingecko.com/reference/authentication#api-key-usage-credits)
API Key Usage Credits
-------------------------------------------------------------------------------------------------------
* Each request made to any endpoint counts as a single call (1 call = 1 credit).
* Each successful API request (Status 200) will deduct 1 credit from your monthly credit allowance.
* Unsuccessful Requests (Status 4xx, 5xx, etc) will not count towards credit deduction.
* Regardless of the HTTP status code returned (including 4xx and 5xx errors), all API requests will count towards your **minute rate limit**.
* Your monthly credit & rate limit are determined by the paid plan to which you subscribe. For more details, please refer to this [page](https://www.coingecko.com/en/api/pricing)
.
* To check the API usage, please go to the [developer dashboard](https://www.coingecko.com/en/developers/dashboard)
or follow the guide [here](https://docs.coingecko.com/reference/setting-up-your-api-key#4-api-usage-report)
Was this page helpful?
YesNo
[Endpoint Overview](https://docs.coingecko.com/reference/endpoint-overview)
⌘I
---
# Authentication (Public/Demo) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/v3.0.1/reference/authentication#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Overview
Authentication (Public/Demo)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Notes](https://docs.coingecko.com/v3.0.1/reference/authentication#notes)
* [CoinGecko API Authentication Method](https://docs.coingecko.com/v3.0.1/reference/authentication#coingecko-api-authentication-method)
* [API Key Usage Credits](https://docs.coingecko.com/v3.0.1/reference/authentication#api-key-usage-credits)
###
[](https://docs.coingecko.com/v3.0.1/reference/authentication#notes)
**Notes**
* Demo API Key is only available for CoinGecko Public Demo API Plan, the root URL for CoinGecko Public Demo API must be `https://api.coingecko.com/api/v3/`.
* ⚠️ You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL.
* The authentication method below is for CoinGecko Public Demo API only. For **paid plan users with Pro-API key**, please refer to [this page](https://docs.coingecko.com/reference/authentication)
instead.
* User Guide: [How to sign up for CoinGecko Demo API and generate an API key?](https://support.coingecko.com/hc/en-us/articles/21880397454233)
* It’s highly recommended to use the **Headers method** when making API requests for better security. Using query string parameters can risk exposing your API key.
[](https://docs.coingecko.com/v3.0.1/reference/authentication#coingecko-api-authentication-method)
CoinGecko API Authentication Method
------------------------------------------------------------------------------------------------------------------------------------------
If this is your first time using the Demo API key, you can supply API Key to the root URL using one of these ways:
1. Header (Recommended): `x-cg-demo-api-key`
2. Query String Parameter: `x_cg_demo_api_key`
| Authentication Method | Example using [Ping](https://docs.coingecko.com/v3.0.1/reference/ping-server)
Endpoint |
| --- | --- |
| Header (cURL) | `curl -X GET "https://api.coingecko.com/api/v3/ping" -H "x-cg-demo-api-key: YOUR_API_KEY"` |
| Query String Parameter | `https://api.coingecko.com/api/v3/ping?x_cg_demo_api_key=YOUR_API_KEY` |
[](https://docs.coingecko.com/v3.0.1/reference/authentication#api-key-usage-credits)
API Key Usage Credits
--------------------------------------------------------------------------------------------------------------
* Each request made to any endpoint counts as a single call (1 call = 1 credit).
* Your monthly credit & rate limit are determined by the paid plan to which you subscribe. For more details, please refer to this [page](https://www.coingecko.com/en/api/pricing)
.
* To check the API usage, please go to the [developer dashboard](https://www.coingecko.com/en/developers/dashboard)
or follow the guide [here](https://docs.coingecko.com/v3.0.1/reference/setting-up-your-api-key#4-api-usage-report)
.
Was this page helpful?
YesNo
[Endpoint Overview](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview)
⌘I
---
# Setting Up Your API Key - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/setting-up-your-api-key#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Getting started
Setting Up Your API Key
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [1\. Creating a new API Key](https://docs.coingecko.com/docs/setting-up-your-api-key#1-creating-a-new-api-key)
* [2\. Making API Request](https://docs.coingecko.com/docs/setting-up-your-api-key#2-making-api-request)
* [3\. Edit or Delete API Key](https://docs.coingecko.com/docs/setting-up-your-api-key#3-edit-or-delete-api-key)
* [4\. API Usage Report](https://docs.coingecko.com/docs/setting-up-your-api-key#4-api-usage-report)
* [5\. Others](https://docs.coingecko.com/docs/setting-up-your-api-key#5-others)
* [Call Consumption Alerts](https://docs.coingecko.com/docs/setting-up-your-api-key#call-consumption-alerts)
* [Overage Option (Beta)](https://docs.coingecko.com/docs/setting-up-your-api-key#overage-option-beta)
👋 **New to CoinGecko API?** Sign up for an account [here](https://www.coingecko.com/en/api/pricing)
[](https://docs.coingecko.com/docs/setting-up-your-api-key#1-creating-a-new-api-key)
1\. Creating a new API Key
-------------------------------------------------------------------------------------------------------------------
* Once you have signed up and logged in to your CoinGecko account, go to [Developer Dashboard](https://www.coingecko.com/en/developers/dashboard)
:
* Click on **\+ Add New Key** button to create a new API key:
[](https://docs.coingecko.com/docs/setting-up-your-api-key#2-making-api-request)
2\. Making API Request
-----------------------------------------------------------------------------------------------------------
* **Root URLs:**
* Pro API: `https://pro-api.coingecko.com/api/v3/`, refer to [Pro API Authentication](https://docs.coingecko.com/reference/authentication)
.
* Demo API: `https://api.coingecko.com/api/v3/`, refer to [Demo API Authentication](https://docs.coingecko.com/v3.0.1/reference/authentication)
.
* **Example using the `/ping` endpoint:**
* Pro API: `https://pro-api.coingecko.com/api/v3/ping?x_cg_pro_api_key=YOUR_API_KEY`
* Demo API: `https://api.coingecko.com/api/v3/ping?x_cg_demo_api_key=YOUR_API_KEY`
[](https://docs.coingecko.com/docs/setting-up-your-api-key#3-edit-or-delete-api-key)
3\. Edit or Delete API Key
-------------------------------------------------------------------------------------------------------------------
* Go to Developer’s Dashboard and click “Edit” button on a specific API Key.
* In case the API Key is compromised, you may delete the API Key by clicking the “Delete” button.
* You may also update the label and save the changes by clicking “Save” button.
[](https://docs.coingecko.com/docs/setting-up-your-api-key#4-api-usage-report)
4\. API Usage Report
-------------------------------------------------------------------------------------------------------
* You can monitor your API usage in the Usage Report section, which provides details such as:
* Total Monthly API Calls.
* Remaining Monthly API Calls.
* Rate Limit (Request Per Minute) — maximum number of API requests allowed in one minute.
* Last Used — the timestamp of the last used instance.
* You can also check your full historical usage by specifying “API Keys”, “timeframe” or “date range”. You may export as CSV for more comprehensive view.
[](https://docs.coingecko.com/docs/setting-up-your-api-key#5-others)
5\. Others
-----------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/setting-up-your-api-key#call-consumption-alerts)
Call Consumption Alerts
You may enable or disable call consumption alerts in the tab below to receive emails when specific credit usage thresholds are reached.
###
[](https://docs.coingecko.com/docs/setting-up-your-api-key#overage-option-beta)
Overage Option (Beta)
* The overage option enables you to make API calls when your usage exceeds the monthly credits.
* You can activate the overage option by clicking the “Turn On Overage” button, ensuring uninterrupted service and allowing you to continue making API calls or vice versa.
Was this page helpful?
YesNo
[Introduction](https://docs.coingecko.com/)
[Common Errors & Rate Limit](https://docs.coingecko.com/docs/common-errors-rate-limit)
⌘I
---
# Common Errors & Rate Limit - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/common-errors-rate-limit#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Getting started
Common Errors & Rate Limit
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Common Errors](https://docs.coingecko.com/docs/common-errors-rate-limit#common-errors)
* [Rate Limit](https://docs.coingecko.com/docs/common-errors-rate-limit#rate-limit)
* [Notes](https://docs.coingecko.com/docs/common-errors-rate-limit#notes)
[](https://docs.coingecko.com/docs/common-errors-rate-limit#common-errors)
Common Errors
--------------------------------------------------------------------------------------------
The server responds to a user’s request by issuing status codes when the request is made to the server. Kindly refer to the table below to further understand the status codes when indicating the success or failure of an API call.
| Status Codes | Description |
| --- | --- |
| `400` (Bad Request) | This is due to an invalid request and the server could not process the user’s request |
| `401` (Unauthorized) | This is due to the lack of valid authentication credentials for the requested resource by the user |
| `403` (Forbidden) | This is likely indicating that your access is blocked by our server, and we’re unable to authorize your request |
| `408` (Timeout) | This error indicates that our server did not receive your complete request within our allowed time frame. This is usually caused by a slow network connection on your end or network latency. Please check your connection and try sending the request again. |
| `429` (Too many requests) | This is likely indicating that the rate limit has reached. The user should reduce the number of calls made, or consider scaling their service plan that has much higher rate limits and call credits |
| `500` (Internal Server Error) | This is a generic error response indicating that the server has encountered an unexpected issue that prevented it from fulfilling the request |
| `503` (Service Unavailable) | The service is currently unavailable. Please check the API status and updates on [https://status.coingecko.com](https://status.coingecko.com/) |
| `1020` (Access Denied) | This is due to violation of CDN firewall rule |
| `10005` | You may not have access to this endpoint. e.g. ‘This request is limited Pro API subscribers’. You may wanna subscribe to a paid plan [here](https://www.coingecko.com/en/api/pricing) |
| `10002` (Missing API Key) | API Key Missing. Please make sure you’re using the right authentication method.
For Pro API, ensure you pass in `x_cg_pro_api_key` parameter with a Pro Key.
For Demo API, ensure you pass in `x_cg_demo_api_key` parameter with a Demo Key. |
| `10010` (Invalid API Key) | You have provided incorrect API key credentials. If you are using Pro API key, please change your root URL from `api.coingecko.com` to `pro-api.coingecko.com` |
| `10011` (Invalid API Key) | You have provided incorrect API key credentials. If you are using Demo API key, please change your root URL from `pro-api.coingecko.com` to `api.coingecko.com` |
| CORS error | Occurs when the server doesn’t return the CORS headers required. You may learn more and attempt the recommended solutions [here](https://www.bannerbear.com/blog/what-is-a-cors-error-and-how-to-fix-it-3-ways/#how-to-fix-a-cors-error) |
[](https://docs.coingecko.com/docs/common-errors-rate-limit#rate-limit)
Rate Limit
--------------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/common-errors-rate-limit#notes)
**Notes**
* If you’re using the Public API with Google Sheet and got hit with error, this is due to the IP sharing among Google Sheet users, and we have no control over this.
* If you need reliable performance, please **register for a demo account** or **subscribe to a paid plan** that comes with dedicated infra (API key) to prevent rate limit issues.
* For more details, please go to the page [here](https://www.coingecko.com/en/api/pricing)
.
* For Public API user (Demo plan), the rate limit is ~30 calls per minutes and it varies depending on the traffic size.
* If you’re Pro API user (any paid plan), the rate limit is depending on the paid plan that you’re subscribed to.
* Regardless of the HTTP status code returned (including `4xx` and `5xx` errors), all API requests will count towards your **minute rate limit**.
Was this page helpful?
YesNo
[Setting Up Your API Key](https://docs.coingecko.com/docs/setting-up-your-api-key)
[API Status](https://docs.coingecko.com/docs/api-status)
⌘I
---
# API Status - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/api-status#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Getting started
API Status
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Tips](https://docs.coingecko.com/docs/api-status#tips)
###
[](https://docs.coingecko.com/docs/api-status#tips)
**Tips**
* You can view our live updates, and subscribe to updates via Email, Slack and Discord.
* Instead of subscribing to all updates, you may click on ‘Select services’ to subscribe to either Public or Pro API updates.
* CoinGecko API Status — [https://status.coingecko.com](https://status.coingecko.com/)
* Incident & Maintenance History — [https://status.coingecko.com/incidents](https://status.coingecko.com/incidents)
* Uptime Calendar — [https://status.coingecko.com/incidents/uptime-calendar](https://status.coingecko.com/incidents/uptime-calendar)
Was this page helpful?
YesNo
[Common Errors & Rate Limit](https://docs.coingecko.com/docs/common-errors-rate-limit)
[CoinGecko SDK (Beta)](https://docs.coingecko.com/docs/sdk)
⌘I
---
# CoinGecko SDK (Beta) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/sdk#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Getting started
CoinGecko SDK (Beta)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Unlock the Power of CoinGecko API with Unprecedented Ease](https://docs.coingecko.com/docs/sdk#unlock-the-power-of-coingecko-api-with-unprecedented-ease)
* [Designed to make your life easier: Common Benefits of Our SDKs](https://docs.coingecko.com/docs/sdk#designed-to-make-your-life-easier%3A-common-benefits-of-our-sdks)
* [🟦 CoinGecko TypeScript SDK](https://docs.coingecko.com/docs/sdk#%F0%9F%9F%A6-coingecko-typescript-sdk)
* [Install via npm](https://docs.coingecko.com/docs/sdk#install-via-npm)
* [Resources](https://docs.coingecko.com/docs/sdk#resources)
* [🐍 CoinGecko Python SDK](https://docs.coingecko.com/docs/sdk#%F0%9F%90%8D-coingecko-python-sdk)
* [Install via pip](https://docs.coingecko.com/docs/sdk#install-via-pip)
* [Resources](https://docs.coingecko.com/docs/sdk#resources-2)
[](https://docs.coingecko.com/docs/sdk#unlock-the-power-of-coingecko-api-with-unprecedented-ease)
Unlock the Power of CoinGecko API with Unprecedented Ease
===============================================================================================================================================================
The official CoinGecko Typescript and Python SDK are now available for all developers! These SDKs dramatically streamline your integration process, enabling you to build powerful crypto applications faster and more reliably than ever before, regardless of your preferred language.
###
[](https://docs.coingecko.com/docs/sdk#designed-to-make-your-life-easier:-common-benefits-of-our-sdks)
Designed to make your life easier: Common Benefits of Our SDKs
* **Official Support**: Both SDKs are maintained by the CoinGecko team, ensuring up-to-date features, reliable access, and dedicated support.
* **Reduced Boilerplate**: Say goodbye to manual request construction and parsing. Our SDKs handle the complexities, allowing you to focus on your application logic.
* **Faster Development**: Build and iterate quicker with intuitive methods, clear documentation, and pre-built functionalities tailored for each language.
* **Seamless Integration**: Effortlessly incorporate CoinGecko data into your existing Python or TypeScript projects.
[](https://docs.coingecko.com/docs/sdk#%F0%9F%9F%A6-coingecko-typescript-sdk)
🟦 CoinGecko TypeScript SDK
=============================================================================================================
Purpose-built to unlock the full capabilities of TypeScript for seamless integration with CoinGecko’s API.
* **Full Type Safety**: Catch errors at compile time and write cleaner, more predictable code with strict TypeScript support.
* **Developer-Centric Design**: Enjoy a streamlined developer experience with intuitive interfaces, strong typings, and structured classes.
[](https://docs.coingecko.com/docs/sdk#install-via-npm)
Install via `npm`
-----------------------------------------------------------------------------
Bash
Copy
npm install @coingecko/coingecko-typescript
###
[](https://docs.coingecko.com/docs/sdk#resources)
Resources
* **GitHub** — [github.com/coingecko/coingecko-typescript](https://github.com/coingecko/coingecko-typescript)
* **npm** — [npmjs.com/package/@coingecko/coingecko-typescript](https://www.npmjs.com/package/@coingecko/coingecko-typescript)
Notice something off or missing? Let us know by opening an [Issue here](https://github.com/coingecko/coingecko-typescript/issues)
.
[](https://docs.coingecko.com/docs/sdk#%F0%9F%90%8D-coingecko-python-sdk)
🐍 CoinGecko Python SDK
=====================================================================================================
Built to seamlessly integrate with the Python ecosystem, enabling fast and intuitive access to CoinGecko’s API.
* **Pythonic Simplicity**: Leverage idiomatic Python to interact with the API effortlessly—ideal for data analysis, prototyping, or production use.
* **Streamlined Development**: Clean and consistent interface designed to accelerate workflows and reduce boilerplate in your Python projects.
[](https://docs.coingecko.com/docs/sdk#install-via-pip)
Install via `pip`
-----------------------------------------------------------------------------
Bash
Copy
pip install coingecko-sdk
###
[](https://docs.coingecko.com/docs/sdk#resources-2)
Resources
* **GitHub** — [github.com/coingecko/coingecko-python](https://github.com/coingecko/coingecko-python)
* **PyPI** — [pypi.org/project/coingecko-sdk/](https://pypi.org/project/coingecko-sdk/)
Notice something off or missing? Let us know by opening an [Issue here](https://github.com/coingecko/coingecko-python/issues)
.
* * *
CoinGecko SDK is powered by [Stainless](https://www.stainless.com/)
✱ Have feedback, a cool idea, or need help? Reach out to `soonaik@coingecko[dot]com`
Was this page helpful?
YesNo
[API Status](https://docs.coingecko.com/docs/api-status)
[CoinGecko MCP Server (Beta)](https://docs.coingecko.com/docs/mcp-server)
⌘I
---
# WebSocket (Beta) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/websocket#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Websocket (Beta)
WebSocket (Beta)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Access Real-Time Crypto Data Instantly with CoinGecko WebSockets](https://docs.coingecko.com/websocket#access-real-time-crypto-data-instantly-with-coingecko-websockets)
* [Channel & Data Support](https://docs.coingecko.com/websocket#channel-%26-data-support)
* [Notes](https://docs.coingecko.com/websocket#notes)
* [Connection Handling](https://docs.coingecko.com/websocket#connection-handling)
[](https://docs.coingecko.com/websocket#access-real-time-crypto-data-instantly-with-coingecko-websockets)
Access Real-Time Crypto Data Instantly with CoinGecko WebSockets
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
In the fast-paced world of cryptocurrency, speed matters. Our official CoinGecko WebSocket API provides a dedicated, persistent connection for real-time data streaming, ensuring you receive critical market updates the moment they happen. Move beyond traditional polling and embrace the power of instant data delivery for your trading bots, dashboards, and analytical applications.
CoinGecko Websocket (Beta) is now available for [paid plan](https://www.coingecko.com/en/api/pricing)
customers (Analyst plan & above)!
* For Analyst, Lite, Pro, and Pro+ self-serve customers, you will be eligible to access the following features, and stream real-time data by utilising your monthly API plan credits:
* Max connections: 10 concurrent socket connections
* Max subscriptions: 100 token or pool data subscription per channel, per socket
* Channel Access: all 4 channels
* Credit charge: 0.1 credit per response returned, deducting from monthly API plan credits
We will gradually improve the Websocket and expand the feature limits. Please share your feedback and suggestion via this [survey form](https://forms.gle/gNE1Txc9FCV55s7ZA)
, or email soonaik@coingecko\[dot\]com
* For existing **Enterprise plan** clients who wish to unlock higher limits (max connections, max subscriptions, and lower credit charge), please contact your Customer Success Manager.
###
[](https://docs.coingecko.com/websocket#channel-&-data-support)
Channel & Data Support
| Websocket Channel | Channel Code | Details |
| --- | --- | --- |
| [OnchainSimpleTokenPrice](https://docs.coingecko.com/websocket/onchainsimpletokenprice) | G1 | Subscribe to receive real-time price updates for tokens, as seen on GeckoTerminal.com |
| [CGSimplePrice](https://docs.coingecko.com/websocket/cgsimpleprice) | C1 | Subscribe to receive real-time price updates for tokens, as seen on CoinGecko.com |
| [OnchainTrade](https://docs.coingecko.com/websocket/wss-onchain-trade) | G2 | Subscribe to receive real-time transaction updates for pools, as seen on GeckoTerminal.com |
| [OnchainOHLCV](https://docs.coingecko.com/websocket/wssonchainohlcv) | G3 | Subscribe to receive real-time OHLCV (Open, High, Low, Close, Volume) for pools, as seen on GeckoTerminal.com |
| (More coming soon!) | | |
###
[](https://docs.coingecko.com/websocket#notes)
**Notes**
* **Real-Time Data**: Once subscribed, you will start receiving real-time data updates based on your subscriptions. The received data will be in JSON format and will contain the relevant information for the subscribed event.
* **Close Connection:** When you’re done receiving updates or want to close the WebSocket connection, you can gracefully close the connection.
* **Security Considerations:** Ensure that you keep your Pro-API key secure and do not expose it publicly in your code or any public repositories.
###
[](https://docs.coingecko.com/websocket#connection-handling)
Connection Handling
To provide you with the most reliable and efficient experience, please be aware of the following regarding our WebSocket connections:
1. **Connection Liveliness (Ping/Pong Mechanism):**
* To ensure your connection remains active and healthy, we send a **“ping” signal every 10 seconds**.
* If we **do not receive a “pong” response from your client within 20 seconds** of sending a ping, we will automatically disconnect the connection.
* **Action Required (Client-Side)**: Your WebSocket client must be configured to respond to our ping messages with a pong. Most WebSocket libraries handle this automatically, but please verify your implementation to ensure it’s sending pong responses. This is critical for maintaining your connection.
2. **Planned Disconnections (Deployments & Reboots):**
* **Purpose**: From time to time, we will perform system reboots or deploy new versions of our service to implement updates, bug fixes, and improvements. These actions require a graceful restart of our servers.
* **Impact**: During these periods, your active WebSocket connections might be temporarily disconnected.
* **Action Required (Client-Side)**: It is essential that your application is designed to automatically attempt to re-establish the WebSocket connection if it detects a disconnection. Implementing an exponential backoff strategy for reconnection attempts is highly recommended to avoid overwhelming our servers during a widespread disconnection event.
Was this page helpful?
YesNo
[CGSimplePrice](https://docs.coingecko.com/websocket/cgsimpleprice)
⌘I
---
# Tutorials (Beginner-friendly) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/tutorials-beginner-friendly#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Tutorials (Beginner-friendly)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [🔤 No Code](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%94%A4-no-code)
* [💻 Low Code](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%92%BB-low-code)
* [👨💻 Code](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%91%A8%E2%80%8D%F0%9F%92%BB-code)
[](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%94%A4-no-code)
🔤 No Code
---------------------------------------------------------------------------------------------------
* [Import Crypto Prices in Google Sheets](https://www.coingecko.com/learn/import-crypto-prices-google-sheets)
[](https://www.coingecko.com/learn/import-crypto-prices-google-sheets)
* [Import Crypto Prices in Microsoft Excel](https://www.coingecko.com/learn/import-crypto-prices-excel)
[](https://www.coingecko.com/learn/import-crypto-prices-excel)
[](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%92%BB-low-code)
💻 Low Code
-----------------------------------------------------------------------------------------------------
* [Create Portfolio Tracker in Microsoft Excel](https://www.coingecko.com/learn/crypto-portfolio-tracker-google-sheets)
[](https://www.coingecko.com/learn/crypto-portfolio-tracker-google-sheets)
[](https://docs.coingecko.com/docs/tutorials-beginner-friendly#%F0%9F%91%A8%E2%80%8D%F0%9F%92%BB-code)
👨💻 Code
---------------------------------------------------------------------------------------------------------------------
* [Fetch Crypto Data Using Python](https://www.coingecko.com/learn/python-query-coingecko-api)
[](https://www.coingecko.com/learn/python-query-coingecko-api)
Was this page helpful?
YesNo
[Endpoint Showcase](https://docs.coingecko.com/docs/endpoint-showcase)
[Building with AI](https://docs.coingecko.com/docs/building-with-ai)
⌘I
---
# Useful Links - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/useful-links#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Useful Links
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Pricing Page and Top FAQs](https://docs.coingecko.com/docs/useful-links#pricing-page-and-top-faqs)
* [CoinGecko API Status](https://docs.coingecko.com/docs/useful-links#coingecko-api-status)
* [CoinGecko API ID List](https://docs.coingecko.com/docs/useful-links#coingecko-api-id-list)
* [Pro Swagger JSON (OAS)](https://docs.coingecko.com/docs/useful-links#pro-swagger-json-oas)
* [Public/Demo Swagger JSON (OAS)](https://docs.coingecko.com/docs/useful-links#public%2Fdemo-swagger-json-oas)
* [Subscribe CoinGecko API newsletter update](https://docs.coingecko.com/docs/useful-links#subscribe-coingecko-api-newsletter-update)
* [CoinGecko Methodologies (Price, Volume, Trust Score, etc.)](https://docs.coingecko.com/docs/useful-links#coingecko-methodologies-price%2C-volume%2C-trust-score%2C-etc)
* [Using llms.txt for AI use cases](https://docs.coingecko.com/docs/useful-links#using-llms-txt-for-ai-use-cases)
* [Attributing CoinGecko Brand](https://docs.coingecko.com/docs/useful-links#attributing-coingecko-brand)
####
[](https://docs.coingecko.com/docs/useful-links#pricing-page-and-top-faqs)
Pricing Page and Top FAQs
* [https://www.coingecko.com/en/api/pricing#general](https://www.coingecko.com/en/api/pricing#general)
####
[](https://docs.coingecko.com/docs/useful-links#coingecko-api-status)
CoinGecko API Status
* [https://status.coingecko.com/](https://status.coingecko.com/)
####
[](https://docs.coingecko.com/docs/useful-links#coingecko-api-id-list)
CoinGecko API ID List
* [Google Sheets](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU)
####
[](https://docs.coingecko.com/docs/useful-links#pro-swagger-json-oas)
[Pro Swagger JSON (OAS)](https://docs.coingecko.com/reference/endpoint-overview)
* CoinGecko Pro API — [coingecko-pro.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-pro.json)
* GeckoTerminal Onchain API (Pro) — [onchain-pro.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-pro.json)
####
[](https://docs.coingecko.com/docs/useful-links#public/demo-swagger-json-oas)
[Public/Demo Swagger JSON (OAS)](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview)
* CoinGecko Public/Demo API — [coingecko-demo.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-demo.json)
* GeckoTerminal Onchain API (Demo) — [onchain-demo.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-demo.json)
####
[](https://docs.coingecko.com/docs/useful-links#subscribe-coingecko-api-newsletter-update)
Subscribe CoinGecko API newsletter update
* [https://newsletter.coingecko.com/landing/api\_updates\_subscribe](https://newsletter.coingecko.com/landing/api_updates_subscribe)
####
[](https://docs.coingecko.com/docs/useful-links#coingecko-methodologies-price,-volume,-trust-score,-etc)
CoinGecko Methodologies (Price, Volume, Trust Score, etc.)
* [https://www.coingecko.com/en/methodology](https://www.coingecko.com/en/methodology)
####
[](https://docs.coingecko.com/docs/useful-links#using-llms-txt-for-ai-use-cases)
Using `llms.txt` for AI use cases
* [/llms-full.txt](https://docs.coingecko.com/llms-full.txt)
####
[](https://docs.coingecko.com/docs/useful-links#attributing-coingecko-brand)
Attributing CoinGecko Brand
* [https://brand.coingecko.com/resources/attribution-guide](https://brand.coingecko.com/resources/attribution-guide)
Was this page helpful?
YesNo
[Clients](https://docs.coingecko.com/docs/clients)
⌘I
---
# Clients - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/clients#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Clients
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [API Swagger JSON (OAS)](https://docs.coingecko.com/docs/clients#api-swagger-json-oas)
* [Official CoinGecko API SDK](https://docs.coingecko.com/docs/clients#official-coingecko-api-sdk)
[](https://docs.coingecko.com/docs/clients#api-swagger-json-oas)
API Swagger JSON (OAS)
-------------------------------------------------------------------------------------------
[](https://github.com/coingecko/coingecko-api-oas)
* [CoinGecko Pro OAS](https://docs.coingecko.com/reference/endpoint-overview)
* CoinGecko Pro API — [coingecko-pro.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-pro.json)
* GeckoTerminal Onchain API (Pro) — [onchain-pro.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-pro.json)
* [CoinGecko Public/Demo OAS](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview)
* CoinGecko Public/Demo API — [coingecko-demo.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-demo.json)
* GeckoTerminal Onchain API (Demo) — [onchain-demo.json](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-demo.json)
* * *
[](https://docs.coingecko.com/docs/clients#official-coingecko-api-sdk)
Official CoinGecko API SDK
-----------------------------------------------------------------------------------------------------
Here are the official API SDKs maintained by us.
* [🐍 coingecko-python (Python)](https://github.com/coingecko/coingecko-python)
* [🟦 coingecko-typescript (Typescript)](https://github.com/coingecko/coingecko-typescript)
Want us to support your favorite programming language? Let us know [here](https://forms.gle/JJLH3SXiL2eJaGzBA)
! **Not a developer?** Fred not, check our no-code tutorial for beginners here: [Tutorials (Beginner-friendly)](https://docs.coingecko.com/docs/tutorials-beginner-friendly)
Was this page helpful?
YesNo
[TypeScript AI Prompts](https://docs.coingecko.com/docs/typescript-ai-prompts)
[Useful Links](https://docs.coingecko.com/docs/useful-links)
⌘I
---
# Building with AI - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/building-with-ai#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
AI Integration
Building with AI
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Using llms.txt](https://docs.coingecko.com/docs/building-with-ai#using-llms-txt)
* [CoinGecko MCP Server](https://docs.coingecko.com/docs/building-with-ai#coingecko-mcp-server)
* [Tools for Your Workflow](https://docs.coingecko.com/docs/building-with-ai#tools-for-your-workflow)
CoinGecko provides a powerful suite of AI-native tools to help you integrate real-time, historical, and onchain market data into your applications. Whether you’re building a sophisticated trading bot, a market analysis tool, or a simple portfolio tracker, our AI toolkit is here to accelerate your development.
[](https://docs.coingecko.com/docs/building-with-ai#using-llms-txt)
Using `llms.txt`
----------------------------------------------------------------------------------------
To help AI models interact with CoinGecko data effectively, we provide an `llms.txt` file at [/llms-full.txt](https://docs.coingecko.com/llms-full.txt)
. This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations of MCP and AI applications.
[](https://docs.coingecko.com/docs/building-with-ai#coingecko-mcp-server)
CoinGecko MCP Server
--------------------------------------------------------------------------------------------------
The **MCP (Model-Context-Protocol)** Server is your gateway for connecting AI agents and large language models, like Claude and Gemini, directly to CoinGecko’s live data streams. It’s ideal for building conversational applications that can perform complex, real-time crypto analysis and answer user queries with up-to-the-minute information. Learn how to connect your AI agent by checking out [CoinGecko MCP Server](https://docs.coingecko.com/docs/mcp-server)
[](https://docs.coingecko.com/docs/building-with-ai#tools-for-your-workflow)
Tools for Your Workflow
--------------------------------------------------------------------------------------------------------
We’ve integrated AI assistance directly into our documentation to help you find answers and ship faster.
1. Use the **‘Copy page’** button to copy endpoint-specific markdown prompts. You can take these prompts to your favorite LLM chat interface to explore use cases or generate boilerplate code.
2. Stuck on a problem? Click the **‘AI Support’** button anywhere in our docs to chat with our AI Assistant. It’s trained to resolve your inquiries instantly.
Was this page helpful?
YesNo
[Tutorials (Beginner-friendly)](https://docs.coingecko.com/docs/tutorials-beginner-friendly)
[AI Prompts](https://docs.coingecko.com/docs/ai-prompts)
⌘I
---
# CoinGecko MCP Server (Beta) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/mcp-server#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Getting started
CoinGecko MCP Server (Beta)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Welcome to the CoinGecko MCP Server!](https://docs.coingecko.com/docs/mcp-server#welcome-to-the-coingecko-mcp-server)
* [📕 Overview](https://docs.coingecko.com/docs/mcp-server#%F0%9F%93%95-overview)
* [🔥 Getting Started](https://docs.coingecko.com/docs/mcp-server#%F0%9F%94%A5-getting-started)
* [Prerequisites](https://docs.coingecko.com/docs/mcp-server#prerequisites)
* [Which MCP Server Should You Use?](https://docs.coingecko.com/docs/mcp-server#which-mcp-server-should-you-use)
* [🔗 Endpoint Options](https://docs.coingecko.com/docs/mcp-server#%F0%9F%94%97-endpoint-options)
* [Primary Endpoint (HTTP Streaming)](https://docs.coingecko.com/docs/mcp-server#primary-endpoint-http-streaming)
* [Alternative Endpoint (SSE — Server-Sent Events)](https://docs.coingecko.com/docs/mcp-server#alternative-endpoint-sse-%E2%80%94-server-sent-events)
* [Remote Server (Public, Keyless)](https://docs.coingecko.com/docs/mcp-server#remote-server-public%2C-keyless)
* [Client-Specific Config](https://docs.coingecko.com/docs/mcp-server#client-specific-config)
* [Remote Server (Authenticated)](https://docs.coingecko.com/docs/mcp-server#remote-server-authenticated)
* [Step 1: Add the configuration](https://docs.coingecko.com/docs/mcp-server#step-1%3A-add-the-configuration)
* [Step 2: Authorize your MCP access](https://docs.coingecko.com/docs/mcp-server#step-2%3A-authorize-your-mcp-access)
* [Local Server (API Key Required)](https://docs.coingecko.com/docs/mcp-server#local-server-api-key-required)
* [🚀 Connecting with Claude](https://docs.coingecko.com/docs/mcp-server#%F0%9F%9A%80-connecting-with-claude)
* [For Claude Free Users (via Claude Desktop)](https://docs.coingecko.com/docs/mcp-server#for-claude-free-users-via-claude-desktop)
* [For Claude Pro Users](https://docs.coingecko.com/docs/mcp-server#for-claude-pro-users)
* [Tips](https://docs.coingecko.com/docs/mcp-server#tips)
* [🚀 Connecting with ChatGPT](https://docs.coingecko.com/docs/mcp-server#%F0%9F%9A%80-connecting-with-chatgpt)
* [💡 Example Prompts](https://docs.coingecko.com/docs/mcp-server#%F0%9F%92%A1-example-prompts)
* [Simple Queries](https://docs.coingecko.com/docs/mcp-server#simple-queries)
* [Advanced Queries](https://docs.coingecko.com/docs/mcp-server#advanced-queries)
* [Creative and Fun Ideas](https://docs.coingecko.com/docs/mcp-server#creative-and-fun-ideas)
* [⚙️ Tips](https://docs.coingecko.com/docs/mcp-server#%E2%9A%99%EF%B8%8F-tips)
* [API Key Differences (Demo vs. Pro)](https://docs.coingecko.com/docs/mcp-server#api-key-differences-demo-vs-pro)
* [Dynamic vs. Static Tools](https://docs.coingecko.com/docs/mcp-server#dynamic-vs-static-tools)
* [Using llms.txt](https://docs.coingecko.com/docs/mcp-server#using-llms-txt)
###
[](https://docs.coingecko.com/docs/mcp-server#welcome-to-the-coingecko-mcp-server)
Welcome to the CoinGecko MCP Server!
**CoinGecko MCP Server is currently in Beta.** We’re constantly improving, and your feedback is crucial. Please share any thoughts or suggestions via [this feedback form](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform)
.
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%93%95-overview)
📕 Overview
====================================================================================
The official CoinGecko MCP Server is now live, making CoinGecko data readily available to your AI models and applications. With the CoinGecko MCP, you can empower your agents to:
* **Access real-time market data**: Get aggregated prices, market cap, and trading volume for over 15k+ coins on CoinGecko, integrated across 1,000+ exchanges.
* **Dive into onchain analytics**: Query onchain DEX price and liquidity data for more than 8M tokens across 200+ networks via GeckoTerminal.
* **Discover market trends**: Instantly find trending coins, new token listings, top gainers/losers, and popular NFT collections.
* **Retrieve rich metadata**: Pull essential details like project descriptions, logos, social links, contract addresses, security info, and more.
* **Analyze historical performance**: Access historical price, market data, and OHLCV for any cryptocurrency.
* **Explore crypto categories**: Effortlessly list coins within specific sectors like Meme, DeFi, Layer 1, AI agent, and more.
MCP Demo with Claude Desktop
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%94%A5-getting-started)
🔥 Getting Started
==================================================================================================
Connecting your AI to CoinGecko is simple. We offer several MCP server options to fit your needs, from keyless access for testing to authenticated connections for production applications. Most MCP-compatible clients, like Claude Desktop, Gemini CLI, and Cursor, can be configured using a simple JSON file (e.g., `claude_desktop_config.json`)
###
[](https://docs.coingecko.com/docs/mcp-server#prerequisites)
Prerequisites
* Make sure your device has `node` installed. You can download it from [nodejs.org/download](https://nodejs.org/en/download)
[](https://docs.coingecko.com/docs/mcp-server#which-mcp-server-should-you-use)
Which MCP Server Should You Use?
-------------------------------------------------------------------------------------------------------------------
Here’s a breakdown of the available options to help you choose the right one:
| MCP Server Type | Best For | Endpoints | Status | Setup Details |
| --- | --- | --- | --- | --- |
| Remote Server (Public, Keyless) | \- First-time users, quick tests, and basic queries
\- Connect instantly without any registration
\- Subject to shared rate limits, not for heavy use | Primary: `/mcp`
Alternative: `/sse` | Public Beta | [mcp.api.coingecko.com](https://mcp.api.coingecko.com/) |
| Remote Server (Authenticated) | \- Scalable apps, AI agent integrations
\- Unlocks 76+ tools available under your Demo/Pro plan
\- Higher, reliable rate limits with 24/7 uptime. Get your API key [here](https://www.coingecko.com/en/api/pricing) | Primary: `/mcp`
Alternative: `/sse` | Public Beta | [mcp.pro-api.coingecko.com](https://mcp.pro-api.coingecko.com/) |
| Local Server | \- Ideal for local development, desktop AI apps
\- Build/test your AI app even without an active internet connection
\- Demo/Pro API key to access more tools. Get your API key [here](https://www.coingecko.com/en/api/pricing) | Local server instance | Beta | [npmjs/coingecko-mcp](https://www.npmjs.com/package/@coingecko/coingecko-mcp) |
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%94%97-endpoint-options)
🔗 Endpoint Options
----------------------------------------------------------------------------------------------------
Each remote server offers two connection methods to ensure compatibility with various MCP clients:
###
[](https://docs.coingecko.com/docs/mcp-server#primary-endpoint-http-streaming)
Primary Endpoint (HTTP Streaming)
* **Public Server**: `https://mcp.api.coingecko.com/mcp`
* **Pro Server**: `https://mcp.pro-api.coingecko.com/mcp`
* Uses HTTP streaming protocol for real-time data transfer.
* Recommended for most modern MCP clients.
###
[](https://docs.coingecko.com/docs/mcp-server#alternative-endpoint-sse-%E2%80%94-server-sent-events)
Alternative Endpoint (SSE — Server-Sent Events)
* **Public Server**: `https://mcp.api.coingecko.com/sse`
* **Pro Server**: `https://mcp.pro-api.coingecko.com/sse`
* Uses Server-Sent Events for compatibility.
* Use this if you encounter connection issues with the primary endpoint.
Most clients work with either endpoint. The configuration examples below use the SSE endpoint by default for maximum compatibility.
[](https://docs.coingecko.com/docs/mcp-server#remote-server-public,-keyless)
Remote Server (Public, Keyless)
----------------------------------------------------------------------------------------------------------------
The easiest way to get started. Just add the following to your client’s `mcp_config.json` file.
###
[](https://docs.coingecko.com/docs/mcp-server#client-specific-config)
Client-Specific Config
The file name and location depend on your client. Find your config file here: [modelcontextprotocol.io/quickstart](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server)
Add the following configuration to your `mcp_config.json`:
JSON
Copy
{
"mcpServers": {
"coingecko_mcp": {
"command": "npx",
"args": [\
"mcp-remote",\
"https://mcp.api.coingecko.com/mcp"\
]
}
}
}
Here’s a quick 2-minute tutorial for setting up the public server with Claude Desktop:
[](https://docs.coingecko.com/docs/mcp-server#remote-server-authenticated)
Remote Server (Authenticated)
------------------------------------------------------------------------------------------------------------
To access more tools and higher rate limits, use your CoinGecko API key with our hosted “Bring Your Own Key” (BYOK) server. Get your API key [here](https://www.coingecko.com/en/api/pricing)
###
[](https://docs.coingecko.com/docs/mcp-server#step-1:-add-the-configuration)
Step 1: Add the configuration
Add the following configuration to your `mcp_config.json`:
JSON
Copy
{
"mcpServers": {
"coingecko_mcp": {
"command": "npx",
"args": [\
"mcp-remote",\
"https://mcp.pro-api.coingecko.com/mcp"\
]
}
}
}
###
[](https://docs.coingecko.com/docs/mcp-server#step-2:-authorize-your-mcp-access)
Step 2: Authorize your MCP access
After adding the config, the first time your client tries to use the CoinGecko MCP, a new browser tab will open, redirecting you to our authentication page: 
* Simply paste in your CoinGecko API key, and authorize to link your key to the MCP session. ✨ Don’t have an API key yet? Upgrade to Pro today! Read more [here](https://www.coingecko.com/en/api/pricing)
.
* You can also toggle between dynamic/static tools here. Learn more about [Dynamic Tools](https://docs.coingecko.com/docs/mcp-server#dynamic-vs-static-tools)
.
[](https://docs.coingecko.com/docs/mcp-server#local-server-api-key-required)
Local Server (API Key Required)
----------------------------------------------------------------------------------------------------------------
For local development and maximum control, run the MCP server directly on your machine. This method offers the rate limits based on your API plan.
JSON
Copy
{
"mcpServers": {
"coingecko_mcp_local": {
"command": "npx",
"args": [\
"-y",\
"@coingecko/coingecko-mcp"\
],
"env": {
"COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
"COINGECKO_ENVIRONMENT": "pro"
}
}
}
}
✨ Don’t have an API key yet? Get your free Demo key or upgrade to Pro! Read more [here](https://www.coingecko.com/en/api/pricing)
.
* Configure the `env` based on your API key tier:
* Pro API access:
JSON
Copy
...
"env": {
"COINGECKO_PRO_API_KEY": "YOUR_PRO_API_KEY",
"COINGECKO_ENVIRONMENT": "pro"
}
...
* Demo API access:
JSON
Copy
...
"env": {
"COINGECKO_DEMO_API_KEY": "YOUR_DEMO_API_KEY",
"COINGECKO_ENVIRONMENT": "demo"
}
...
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%9A%80-connecting-with-claude)
🚀 Connecting with Claude
================================================================================================================
Connecting CoinGecko MCP to Claude is straightforward. The method varies slightly depending on your Claude plan.
[](https://docs.coingecko.com/docs/mcp-server#for-claude-free-users-via-claude-desktop)
For Claude Free Users (via Claude Desktop)
--------------------------------------------------------------------------------------------------------------------------------------
You **must use the Claude Desktop app** and modify the configuration file.
1. **Locate`claude_desktop_config.json`**: Follow the instructions [here](https://modelcontextprotocol.io/quickstart/user)
to find the file on your system.
2. **Add a server config**: Copy and paste one of the server configs above that matches your use case.
3. **Restart Claude Desktop**: Close and reopen the app for the changes to take effect.
[](https://docs.coingecko.com/docs/mcp-server#for-claude-pro-users)
For Claude Pro Users
--------------------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/mcp-server#tips)
Tips
You can also follow the same steps as the Free users by modifying the `claude_desktop_config.json` file.
1. In Claude ([claude.ai](https://claude.ai/)
or the Desktop app), click on ‘Add connectors’ in your chat. 
2. Click on ‘Add custom connector’ 
3. Remote MCP server URL:
* Keyless access: `https://mcp.api.coingecko.com/mcp`
* Authenticated access (BYOK): `https://mcp.pro-api.coingecko.com/mcp`
4. Click on ‘Add’, and you’re ready to go!
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%9A%80-connecting-with-chatgpt)
🚀 Connecting with ChatGPT
==================================================================================================================
OpenAI ChatGPT have just launched an MCP connector, but requires [developer mode](https://platform.openai.com/docs/guides/developer-mode)
toggle turned on.
1. Open your profile > Connectors > Advanced Settings > Toggle Developer Mode On
2. In the Connectors modal, choose “Create” and enter the CoinGecko MCP server info
3. Before prompting, choose ”+” > More > Developer Mode > CoinGecko MCP tool must be turned on
[](https://docs.coingecko.com/docs/mcp-server#%F0%9F%92%A1-example-prompts)
💡 Example Prompts
==================================================================================================
Tap into the full potential of CoinGecko data — use these prompts to kickstart your next AI build.
###
[](https://docs.coingecko.com/docs/mcp-server#simple-queries)
Simple Queries
> * What is the current price of Bitcoin in USD?
> * What is the market cap of Ethereum?
> * What are the top 3 trending coins on CoinGecko right now?
> * What are the top AI coins on GeckoTerminal now?
> * What is the floor price of the Pudgy Penguins NFT collection?
###
[](https://docs.coingecko.com/docs/mcp-server#advanced-queries)
Advanced Queries
> * Show me the current top 10 cryptocurrencies by market cap. Include their price, 24h change, and total volume. Display this in an interactive table. 
> * Generate a 30-day price chart for Ethereum (ETH) against USD, showing both price and trading volume. 
###
[](https://docs.coingecko.com/docs/mcp-server#creative-and-fun-ideas)
Creative and Fun Ideas
> * Create a quiz to tell me which cryptocurrency I am based on my personality.  Try it here: [claude.ai/public/artifacts](https://claude.ai/public/artifacts/586275b9-9ff8-4d9f-9b43-0c080f6e9c80)
>
> * Build a Wordle-style game where the answer is a crypto asset’s name or symbol, like ‘BITCOIN’ or ‘SHIBA’.  Try it here: [claude.ai/public/artifacts](https://claude.ai/public/artifacts/41efabb7-76b9-43c7-8349-cbbe1d52a022)
>
[](https://docs.coingecko.com/docs/mcp-server#%E2%9A%99%EF%B8%8F-tips)
⚙️ Tips
==================================================================================
[](https://docs.coingecko.com/docs/mcp-server#api-key-differences-demo-vs-pro)
API Key Differences (Demo vs. Pro)
---------------------------------------------------------------------------------------------------------------------
Choosing between a Demo and Pro key for your MCP server impacts your access to data and tools.
| Feature | Demo ([Guide here](https://support.coingecko.com/hc/en-us/articles/21880397454233-User-Guide-How-to-sign-up-for-CoinGecko-Demo-API-and-generate-an-API-key)
) | Pro |
| --- | --- | --- |
| **Rate Limit** | 30 calls/min | Starts at 500 calls/min |
| **Monthly Credits** | 10,000 | Starts at 500,000 |
| **Historical Data** | Past 1 year | From 2013 until now |
| **MCP Tools** | Limited access | Full access, including exclusive tools:
\- [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
\- [NFTs Collection Historical Chart](https://docs.coingecko.com/reference/nfts-id-market-chart)
\- [🔥 Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)
\- [Pools by Category ID](https://docs.coingecko.com/reference/pools-category) |
🔥 Ready to upgrade? Explore [our API plans](https://www.coingecko.com/en/api/pricing)
.
[](https://docs.coingecko.com/docs/mcp-server#dynamic-vs-static-tools)
Dynamic vs. Static Tools
---------------------------------------------------------------------------------------------------
When running our CoinGecko MCP server, you can choose how the LLM client discovers tools.
* **Static (Default)**: The AI is given a complete list of tools and their functions upfront. This is faster for specific, known tasks.
* **Dynamic**: The AI first asks the server for available tools based on a keyword search, then learns how to use them. This is flexible but can be slower.
For a deeper dive, read the [official documentation](https://www.stainless.com/changelog/mcp-dynamic-tools)
from Stainless.
[](https://docs.coingecko.com/docs/mcp-server#using-llms-txt)
Using `llms.txt`
----------------------------------------------------------------------------------
To help AI models interact with CoinGecko data effectively, we provide an `llms.txt` file at [/llms-full.txt](https://docs.coingecko.com/llms-full.txt)
. This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations.
* * *
CoinGecko MCP Server is powered by [Stainless](https://www.stainless.com/)
✱ Have feedback, a cool idea, or need help? Reach out to `soonaik@coingecko[dot]com` or fill in [this feedback form](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform)
.
Was this page helpful?
YesNo
[CoinGecko SDK (Beta)](https://docs.coingecko.com/docs/sdk)
[Best Practices](https://docs.coingecko.com/docs/best-practices)
⌘I
---
# Best Practices - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/best-practices#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Best Practices
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [User Journey for CoinGecko API Endpoints](https://docs.coingecko.com/docs/best-practices#user-journey-for-coingecko-api-endpoints)
* [”Discovery/Navigational Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddiscovery%2Fnavigational-endpoints%E2%80%9D)
* [”Supporting Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Dsupporting-endpoints%E2%80%9D)
* [”Data Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddata-endpoints%E2%80%9D)
* [User Journey for Onchain DEX API Endpoints (GeckoTerminal data)](https://docs.coingecko.com/docs/best-practices#user-journey-for-onchain-dex-api-endpoints-geckoterminal-data)
* [“Discovery/Navigational Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Cdiscovery%2Fnavigational-endpoints%E2%80%9D)
* [”Supporting Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Dsupporting-endpoints%E2%80%9D-2)
* [”Data Endpoints”](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddata-endpoints%E2%80%9D-2)
[](https://docs.coingecko.com/docs/best-practices#user-journey-for-coingecko-api-endpoints)
User Journey for CoinGecko API Endpoints
----------------------------------------------------------------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddiscovery/navigational-endpoints%E2%80%9D)
”Discovery/Navigational Endpoints”
**Examples:**
* [/coins/list](https://docs.coingecko.com/reference/coins-list)
— can be used to query all the supported coins on CoinGecko with names, symbols and coin IDs that can be used in other endpoints.
* [/search/trending](https://docs.coingecko.com/reference/trending-search)
— can be used to query trending search coins, categories and NFTs on CoinGecko.
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Dsupporting-endpoints%E2%80%9D)
”Supporting Endpoints”
**Examples:**
* [/simple/supported\_vs\_currencies](https://docs.coingecko.com/reference/simple-supported-currencies)
— can be used to query the list of currencies for other endpoints that include parameters like `vs_currencies`, allowing to obtain the corresponding data for those currencies.
* [/asset\_platforms](https://docs.coingecko.com/reference/asset-platforms-list)
— can be used to query the list of asset platforms for other endpoints that contain parameters like `id` or `ids` (asset platforms), allowing the retrieval of corresponding data for these asset platforms.
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddata-endpoints%E2%80%9D)
”Data Endpoints”
**Examples:**
* [/simple/price](https://docs.coingecko.com/reference/simple-price)
— can be used to query the prices of coins using the unique coin IDs that can be obtained from the “Discovery/Navigational Endpoints” mentioned above.
* [/coins/{id}](https://docs.coingecko.com/reference/coins-id)
— can be used to query the coin data using the unique coin IDs that can be obtained from the “Discovery/Navigational Endpoints” mentioned above.
[](https://docs.coingecko.com/docs/best-practices#user-journey-for-onchain-dex-api-endpoints-geckoterminal-data)
User Journey for Onchain DEX API Endpoints (GeckoTerminal data)
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Cdiscovery/navigational-endpoints%E2%80%9D)
“Discovery/Navigational Endpoints”
**Examples:**
* [/onchain/trending\_pools](https://docs.coingecko.com/reference/trending-pools-list)
- can be used to query trending pools across all networks on GeckoTerminal.
* [/onchain/search/pools](https://docs.coingecko.com/reference/search-pools)
- can be used to search for any pools on GeckoTerminal.
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Dsupporting-endpoints%E2%80%9D-2)
”Supporting Endpoints”
**Examples:**
* [/onchain/networks-list](https://docs.coingecko.com/reference/networks-list)
- can be used to query all the supported networks on GeckoTerminal.
* [/onchain/networks/{network}/dexes](https://docs.coingecko.com/reference/dexes-list)
- can be used to query all the supported decentralized exchanges (DEXs/`dexes`) on GeckoTerminal based on network id that can be obtained from the endpoint mentioned above.
###
[](https://docs.coingecko.com/docs/best-practices#%E2%80%9Ddata-endpoints%E2%80%9D-2)
”Data Endpoints”
**Examples:**
* [/onchain/simple/networks/{network}/token\_price/{addresses}](https://docs.coingecko.com/reference/onchain-simple-price)
- can be used to query any token price using the token address and network id that can be obtained from the “Discovery/Navigational Endpoints” and “Supporting Endpoints” mentioned above.
* [/onchain/networks/{network}/pools/{address}](https://docs.coingecko.com/reference/pool-address)
- can be used to query the data of a specific pool based on the pool address and network id that can be obtained from the “Discovery/Navigational Endpoints” and “Supporting Endpoints” mentioned above.
Was this page helpful?
YesNo
[CoinGecko MCP Server (Beta)](https://docs.coingecko.com/docs/mcp-server)
[Common Use Cases](https://docs.coingecko.com/docs/common-use-cases)
⌘I
---
# Endpoint Showcase - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/endpoint-showcase#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Endpoint Showcase
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [CoinGecko](https://docs.coingecko.com/docs/endpoint-showcase#coingecko)
* [Home Page](https://docs.coingecko.com/docs/endpoint-showcase#home-page)
* [Coin Page](https://docs.coingecko.com/docs/endpoint-showcase#coin-page)
* [Exchanges Page](https://docs.coingecko.com/docs/endpoint-showcase#exchanges-page)
* [NFTs Page](https://docs.coingecko.com/docs/endpoint-showcase#nfts-page)
* [GeckoTerminal](https://docs.coingecko.com/docs/endpoint-showcase#geckoterminal)
* [Home Page](https://docs.coingecko.com/docs/endpoint-showcase#home-page-2)
* [Chain Page](https://docs.coingecko.com/docs/endpoint-showcase#chain-page)
* [Pool Page](https://docs.coingecko.com/docs/endpoint-showcase#pool-page)
* [Categories Page](https://docs.coingecko.com/docs/endpoint-showcase#categories-page)
[](https://docs.coingecko.com/docs/endpoint-showcase#coingecko)
CoinGecko
-----------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/endpoint-showcase#home-page)
[Home Page](https://www.coingecko.com/)
1. [/global](https://docs.coingecko.com/reference/crypto-global)
— Display global crypto data such as number of active cryptocurrencies, exchanges and etc.
2. [/search/trending](https://docs.coingecko.com/reference/trending-search)
— Display trending search coins, NFTs and categories.
3. [/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
— Display the largest gainers in 24hr.
4. [/coins/categories](https://docs.coingecko.com/reference/coins-categories)
— Display all the categories list.
5. [/coins/markets](https://docs.coingecko.com/reference/coins-markets)
— Display all the supported coins with market related data.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#coin-page)
[Coin Page](https://www.coingecko.com/en/coins/bitcoin)
1. [/coins/{id}](https://docs.coingecko.com/reference/coins-id)
— Display all the coin data including name, price, market related data, website, explorers and etc.
2. [/simple/price](https://docs.coingecko.com/reference/simple-price)
— Display data such as latest coin price, market cap and 24hr trading volume.
3. * [/coins/{id}/history](https://docs.coingecko.com/reference/coins-id-history)
— Display the historical price data.
* [/coins/{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)
— Display the historical data in line chart.
* [/coins/{id}/ohlc](https://docs.coingecko.com/reference/coins-id-ohlc)
— Display the historical data in candlestick chart.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#exchanges-page)
[Exchanges Page](https://www.coingecko.com/en/exchanges/hyperliquid-spot)
1. [/exchanges/{id}](https://docs.coingecko.com/reference/exchanges-id)
— Display the exchange information such as name, type, market related data such as trading volume and etc.
2. [/exchanges/{id}/volume\_chart](https://docs.coingecko.com/reference/exchanges-id-volume-chart)
— Display the historical volume chart data.
3. [/exchanges/{id}/tickers](https://docs.coingecko.com/reference/exchanges-id-tickers)
— Display the exchange’s tickers.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#nfts-page)
[NFTs Page](https://www.coingecko.com/en/nft/pudgy-penguins)
1. [/nfts/{id}](https://docs.coingecko.com/reference/nfts-id)
— Display NFT data such as name, contract address, website, market related data such as floor price, market cap, volume and etc.
2. [/nfts/{id}/market\_chart](https://docs.coingecko.com/reference/nfts-id-market-chart)
— Display the historical market data in chart.
3. [/nfts/{id}](https://docs.coingecko.com/reference/nfts-id)
— Display the description of the NFT collection.
4. [/nfts/{id}/tickers](https://docs.coingecko.com/reference/nfts-id-tickers)
— Display the tickers of the NFT collection on different NFT marketplace.
[](https://docs.coingecko.com/docs/endpoint-showcase#geckoterminal)
GeckoTerminal
-------------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/docs/endpoint-showcase#home-page-2)
[Home Page](https://www.geckoterminal.com/)
1. [/onchain/search/pools](https://docs.coingecko.com/reference/search-pools)
— Allow users to search for pools on GeckoTerminal.
2. [/onchain/networks](https://docs.coingecko.com/reference/networks-list)
— Display a list of supported networks on GeckoTerminal.
3. [/onchain/networks/trending\_pools](https://docs.coingecko.com/reference/trending-pools-list)
— Display a list of trending pools across all networks on GeckoTerminal.
4. [/onchain/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list)
— Display all the latest pools across all networks on GeckoTerminal.
5. [/onchain/categories](https://docs.coingecko.com/reference/categories-list)
— Display all the onchain categories on GeckoTerminal.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#chain-page)
[Chain Page](https://www.geckoterminal.com/eth/pools)
1. [/onchain/networks/{network}/dexes](https://docs.coingecko.com/reference/dexes-list)
— Display all the supported dex on a network on GeckoTerminal.
2. [/onchain/networks/{network}/trending\_pools](https://docs.coingecko.com/reference/trending-pools-network)
— Display a list of trending pools on a network on GeckoTerminal.
3. [/onchain/networks/{network}/new\_pools](https://docs.coingecko.com/reference/latest-pools-network)
— Display a list of new pools on a network on GeckoTerminal.
4. [/onchain/networks/{network}/pools](https://docs.coingecko.com/reference/top-pools-network)
— Display all the top pools on a network on GeckoTerminal.
5. [/onchain/categories/{category\_id}/pools](https://docs.coingecko.com/reference/pools-category)
— Display all the pools under a specific onchain category on GeckoTerminal.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#pool-page)
[Pool Page](https://www.geckoterminal.com/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640)
1. * [/onchain/networks/{network}/pools/{address}](https://docs.coingecko.com/reference/pool-address)
— Display pool data such as price, transactions, volume and etc.
* [/onchain/networks/{network}/pools/{pool\_address}/info](https://docs.coingecko.com/reference/pool-token-info-contract-address)
— Display pool information such as name, symbol, image URL, description and etc.
2. [/onchain/networks/{network}/pools/{pool\_address}/ohlcv/{timeframe}](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)
— Display the OHLCV chart of the pool.
3. [/onchain/networks/{network}/pools/{pool\_address}/trades](https://docs.coingecko.com/reference/pool-trades-contract-address)
— Display the trades of the pool in the past 24 hours.
###
[](https://docs.coingecko.com/docs/endpoint-showcase#categories-page)
[Categories Page](https://www.geckoterminal.com/category)
1. [/onchain/categories](https://docs.coingecko.com/reference/categories-list)
— Display list of onchain categories with market data.
2. [/onchain/categories/{id}/pools](https://docs.coingecko.com/reference/pools-category)
— Display list of pools with market data of a specific onchain category.
Was this page helpful?
YesNo
[4\. Get On-chain Data](https://docs.coingecko.com/docs/4-get-on-chain-data)
[Tutorials (Beginner-friendly)](https://docs.coingecko.com/docs/tutorials-beginner-friendly)
⌘I
---
# Common Use Cases - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/common-use-cases#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Guides
Common Use Cases
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [1\. Get Coins Logo Images](https://docs.coingecko.com/docs/common-use-cases#1-get-coins-logo-images)
* [2\. Best Endpoint for Latest Crypto Price](https://docs.coingecko.com/docs/common-use-cases#2-best-endpoint-for-latest-crypto-price)
* [3\. Get All Trading Pairs (Tickers) of a Coin](https://docs.coingecko.com/docs/common-use-cases#3-get-all-trading-pairs-tickers-of-a-coin)
* [4\. Get Trading Pairs of Specific Coins from a Specific Exchange](https://docs.coingecko.com/docs/common-use-cases#4-get-trading-pairs-of-specific-coins-from-a-specific-exchange)
* [5\. Building Telegram Bot for Latest Coin Listings](https://docs.coingecko.com/docs/common-use-cases#5-building-telegram-bot-for-latest-coin-listings)
* [6\. Get List of Coins Under Specific Category](https://docs.coingecko.com/docs/common-use-cases#6-get-list-of-coins-under-specific-category)
* [7\. Identify DEX Decentralized Exchanges](https://docs.coingecko.com/docs/common-use-cases#7-identify-dex-decentralized-exchanges)
* [8\. Get Bitcoin Dominance Data (BTC.D)](https://docs.coingecko.com/docs/common-use-cases#8-get-bitcoin-dominance-data-btc-d)
* [9\. Get Market Cap or Dominance of a Specific Ecosystem](https://docs.coingecko.com/docs/common-use-cases#9-get-market-cap-or-dominance-of-a-specific-ecosystem)
* [10\. Get Token Lists of a Specific Blockchain Network](https://docs.coingecko.com/docs/common-use-cases#10-get-token-lists-of-a-specific-blockchain-network)
* [11\. Get 7-Day Sparkline Price Data of a Coin](https://docs.coingecko.com/docs/common-use-cases#11-get-7-day-sparkline-price-data-of-a-coin)
* [12\. Get Link to Individual CoinGecko Coin Page](https://docs.coingecko.com/docs/common-use-cases#12-get-link-to-individual-coingecko-coin-page)
* [13\. Check Coin Status and Stale Price Updates](https://docs.coingecko.com/docs/common-use-cases#13-check-coin-status-and-stale-price-updates)
* [14\. Get Real-Time and Historical Exchange of BTC in USD](https://docs.coingecko.com/docs/common-use-cases#14-get-real-time-and-historical-exchange-of-btc-in-usd)
* [15\. Get Watchlist Portfolio Data of a Coin](https://docs.coingecko.com/docs/common-use-cases#15-get-watchlist-portfolio-data-of-a-coin)
* [16\. Get Historical Data for Inactive Coins](https://docs.coingecko.com/docs/common-use-cases#16-get-historical-data-for-inactive-coins)
* [17\. Get TVL (Total Value Locked) data of a Coin](https://docs.coingecko.com/docs/common-use-cases#17-get-tvl-total-value-locked-data-of-a-coin)
* [18\. Query Search for Coins, Categories, NFTs, Exchanges, and Pools](https://docs.coingecko.com/docs/common-use-cases#18-query-search-for-coins%2C-categories%2C-nfts%2C-exchanges%2C-and-pools)
* [19\. Get List of Blockchain Networks supported on CoinGecko and GeckoTerminal.](https://docs.coingecko.com/docs/common-use-cases#19-get-list-of-blockchain-networks-supported-on-coingecko-and-geckoterminal)
* [20\. Get Native Coin of a Blockchain Network (Asset Platform)](https://docs.coingecko.com/docs/common-use-cases#20-get-native-coin-of-a-blockchain-network-asset-platform)
* [21\. Get Liquidity data of a Liquidity Pool or Token](https://docs.coingecko.com/docs/common-use-cases#21-get-liquidity-data-of-a-liquidity-pool-or-token)
* [22\. Get list of onchain DEX pools based on specific criteria](https://docs.coingecko.com/docs/common-use-cases#22-get-list-of-onchain-dex-pools-based-on-specific-criteria)
* [23\. Get List of Trending Coins](https://docs.coingecko.com/docs/common-use-cases#23-get-list-of-trending-coins)
* [24\. Get Security Info of Tokens](https://docs.coingecko.com/docs/common-use-cases#24-get-security-info-of-tokens)
* [25\. Get Latest Token/Pool Data from Launchpad](https://docs.coingecko.com/docs/common-use-cases#25-get-latest-token%2Fpool-data-from-launchpad)
* [26\. Get Latest Price/Data for Tokens Not Actively Traded](https://docs.coingecko.com/docs/common-use-cases#26-get-latest-price%2Fdata-for-tokens-not-actively-traded)
[](https://docs.coingecko.com/docs/common-use-cases#1-get-coins-logo-images)
1\. Get Coins Logo Images
----------------------------------------------------------------------------------------------------------
* Use [/coins/id](https://docs.coingecko.com/reference/coins-id)
endpoint.
* This endpoint can be used to query other coin’s metadata like: links, categories, contract address, community, description in different languages and many more.
* Coin descriptions may include newline characters represented as `\r\n` (escape sequences), which may require processing for proper formatting.
* Use [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)
endpoint to get metadata of tokens listed on GeckoTerminal.com.
[](https://docs.coingecko.com/docs/common-use-cases#2-best-endpoint-for-latest-crypto-price)
2\. Best Endpoint for Latest Crypto Price
------------------------------------------------------------------------------------------------------------------------------------------
* Use [/simple/price](https://docs.coingecko.com/reference/simple-price)
endpoint.
* This endpoint can be used to query other market data like market cap, 24-hour trading volume and 24-hour price change percentage.
[](https://docs.coingecko.com/docs/common-use-cases#3-get-all-trading-pairs-tickers-of-a-coin)
3\. Get All Trading Pairs (Tickers) of a Coin
------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/id/tickers](https://docs.coingecko.com/reference/coins-id-tickers)
endpoint.
[](https://docs.coingecko.com/docs/common-use-cases#4-get-trading-pairs-of-specific-coins-from-a-specific-exchange)
4\. Get Trading Pairs of Specific Coins from a Specific Exchange
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/id/tickers](https://docs.coingecko.com/reference/coins-id-tickers)
endpoint by supplying specific exchange ID.
[](https://docs.coingecko.com/docs/common-use-cases#5-building-telegram-bot-for-latest-coin-listings)
5\. Building Telegram Bot for Latest Coin Listings
------------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/list/new](https://docs.coingecko.com/reference/coins-list-new)
endpoint.
[](https://docs.coingecko.com/docs/common-use-cases#6-get-list-of-coins-under-specific-category)
6\. Get List of Coins Under Specific Category
--------------------------------------------------------------------------------------------------------------------------------------------------
* For CoinGecko [categories](https://www.coingecko.com/en/categories)
, use [/coins/markets](https://docs.coingecko.com/reference/coins-markets)
endpoint by supplying specific category.
* For GeckoTerminal [categories](https://www.geckoterminal.com/category)
, use [Pools by Category ID](https://docs.coingecko.com/reference/pools-category)
endpoint by supplying specific category.
[](https://docs.coingecko.com/docs/common-use-cases#7-identify-dex-decentralized-exchanges)
7\. Identify DEX Decentralized Exchanges
----------------------------------------------------------------------------------------------------------------------------------------
* Use [/exchanges/list](https://docs.coingecko.com/reference/exchanges-list)
endpoint to get full list of exchanges with ID on CoinGecko.
* Use [/exchanges/id](https://docs.coingecko.com/reference/exchanges-id)
to find out whether the exchange is centralized or decentralized.
* Example of responses (using Uniswap V3 as example) : Since Uniswap is a DEX, therefore it shows `"centralized": false`
JSON
Copy
{
"name": "Uniswap V3 (Ethereum)",
......
"centralized": false, 👈
......
"tickers": [],
"status_updates": []
}
[](https://docs.coingecko.com/docs/common-use-cases#8-get-bitcoin-dominance-data-btc-d)
8\. Get Bitcoin Dominance Data (BTC.D)
----------------------------------------------------------------------------------------------------------------------------------
* Use [/global](https://docs.coingecko.com/reference/crypto-global)
endpoint.
* Example of responses:
JSON
Copy
{
"data": {
"active_cryptocurrencies": 12414,
......
"market_cap_percentage": { 👈
"btc": 47.82057011844006,👈
"eth": 16.943340351591583,
......
},
"market_cap_change_percentage_24h_usd": -5.032104325648996,
"updated_at": 1706002730
}
}
[](https://docs.coingecko.com/docs/common-use-cases#9-get-market-cap-or-dominance-of-a-specific-ecosystem)
9\. Get Market Cap or Dominance of a Specific Ecosystem
----------------------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/categories](https://docs.coingecko.com/reference/coins-categories)
.
* The endpoint also returns the 24-hour percentage change, offering insights into the traction of different categories or ecosystems.
[](https://docs.coingecko.com/docs/common-use-cases#10-get-token-lists-of-a-specific-blockchain-network)
10\. Get Token Lists of a Specific Blockchain Network
------------------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/token\_lists/asset\_platforms\_id/all.json](https://docs.coingecko.com/reference/token-lists)
endpoint.
* Supply asset platform id to the endpoint.
[](https://docs.coingecko.com/docs/common-use-cases#11-get-7-day-sparkline-price-data-of-a-coin)
11\. Get 7-Day Sparkline Price Data of a Coin
--------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/id](https://docs.coingecko.com/reference/coins-id)
or [/coins/markets](https://docs.coingecko.com/reference/coins-markets)
endpoints by flagging `sparkline = true`.
[](https://docs.coingecko.com/docs/common-use-cases#12-get-link-to-individual-coingecko-coin-page)
12\. Get Link to Individual CoinGecko Coin Page
------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/list](https://docs.coingecko.com/reference/coins-list)
endpoint to get the coin **`{ID}`**.
* Supply API ID in this URL path format: `www.coingecko.com/en/coins/{ID}`
* If you wish to the obtain the URL slug of a specific CoinGecko Coin Page, e.g. `www.coingecko.com/en/coins/{web_slug}` you may use [/coin/id](https://docs.coingecko.com/reference/coins-id)
endpoint and obtain the **`{web_slug}`** value.
[](https://docs.coingecko.com/docs/common-use-cases#13-check-coin-status-and-stale-price-updates)
13\. Check Coin Status and Stale Price Updates
----------------------------------------------------------------------------------------------------------------------------------------------------
* Active: use [/coins/list](https://docs.coingecko.com/reference/coins-list)
endpoint, only active coins will be shown by default. You may also flag **`status=inactive`** to get a list of inactive coins.
* Price Stale: use [/simple/price](https://docs.coingecko.com/reference/simple-price)
endpoint, flag `include_last_updated_at=true` to check latest update time.
[](https://docs.coingecko.com/docs/common-use-cases#14-get-real-time-and-historical-exchange-of-btc-in-usd)
14\. Get Real-Time and Historical Exchange of BTC in USD
------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* Current exchange rate: use [/exchange\_rates](https://docs.coingecko.com/reference/exchange-rates)
endpoint.
* Historical exchange rate: use [/coins/id/history](https://docs.coingecko.com/reference/coins-id-history)
or [/coins/id/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)
endpoints.
[](https://docs.coingecko.com/docs/common-use-cases#15-get-watchlist-portfolio-data-of-a-coin)
15\. Get Watchlist Portfolio Data of a Coin
----------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/id](https://docs.coingecko.com/reference/coins-id)
endpoint by supplying coin ID.
* Example of responses:
JSON
Copy
{
"id": "bitcoin",
......
"watchlist_portfolio_users": 1487932, 👈
"market_cap_rank": 1,
......
}
[](https://docs.coingecko.com/docs/common-use-cases#16-get-historical-data-for-inactive-coins)
16\. Get Historical Data for Inactive Coins
----------------------------------------------------------------------------------------------------------------------------------------------
**Note**: This is available for paid plan subscribers only.
* Use [/coins/list](https://docs.coingecko.com/reference/coins-list)
endpoint, specifying the status param as `inactive`.
* Example of endpoint request: `https://pro-api.coingecko.com/api/v3/coins/list?include_platform=false&status=inactive&x_cg_pro_api_key=YOUR_API_KEY`
* Retrieve the coin’s ID from the endpoint mentioned above and use it to access historical data via the following endpoints:
* [/coins/id/history](https://docs.coingecko.com/reference/coins-id-history)
* [/coins/id/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)
* [/coins/id/market\_chart/range](https://docs.coingecko.com/reference/coins-id-market-chart-range)
* [/coins/id/contract/contract\_address/market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart)
* [/coins/id/contract/contract\_address/market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range)
[](https://docs.coingecko.com/docs/common-use-cases#17-get-tvl-total-value-locked-data-of-a-coin)
17\. Get TVL (Total Value Locked) data of a Coin
------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/coins/id](https://docs.coingecko.com/reference/coins-id)
endpoint by supplying coin ID.
* Example of responses:
JSON
Copy
"total_value_locked":
{
"btc": 72324,
"usd": 4591842314
}
[](https://docs.coingecko.com/docs/common-use-cases#18-query-search-for-coins,-categories,-nfts,-exchanges,-and-pools)
18\. Query Search for Coins, Categories, NFTs, Exchanges, and Pools
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
We have 2 Search endpoints:
* [/search](https://docs.coingecko.com/reference/search-data)
endpoint allows you to search for coins, categories, exchanges (markets), and NFTs listed on CoinGecko.com. You may query by name or symbol.
* [/search-pools](https://docs.coingecko.com/reference/search-pools)
endpoint allows you to search for pools listed on GeckoTerminal.com. You may query by pool contract address, token contract address, or token symbol.
[](https://docs.coingecko.com/docs/common-use-cases#19-get-list-of-blockchain-networks-supported-on-coingecko-and-geckoterminal)
19\. Get List of Blockchain Networks supported on CoinGecko and GeckoTerminal.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
CoinGecko and GeckoTerminal support different sets of blockchain networks. You can use the following endpoints to find the list of supported networks and their respective IDs:
* CoinGecko: [/asset-platforms-list](https://docs.coingecko.com/reference/asset-platforms-list)
* GeckoTerminal ([onchain endpoints](https://docs.coingecko.com/reference/endpoint-overview#-onchain-dex-endpoints-geckoterminal)
): [/networks-list](https://docs.coingecko.com/reference/networks-list)
[](https://docs.coingecko.com/docs/common-use-cases#20-get-native-coin-of-a-blockchain-network-asset-platform)
20\. Get Native Coin of a Blockchain Network (Asset Platform)
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
You may use the [/asset-platforms-list](https://docs.coingecko.com/reference/asset-platforms-list)
endpoint to obtain the native coin ID of all networks (asset platforms) listed on [www.coingecko.com](http://www.coingecko.com./)
.
[](https://docs.coingecko.com/docs/common-use-cases#21-get-liquidity-data-of-a-liquidity-pool-or-token)
21\. Get Liquidity data of a Liquidity Pool or Token
----------------------------------------------------------------------------------------------------------------------------------------------------------------
There are multiple onchain endpoints that provide the liquidity data (`reserve_in_usd`) of a pool, for example: [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)
. You may also get liquidity data (`total_reserve_in_usd`) of a token, using endpoints like: [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
. Note: `reserve_in_usd` (pool) represents the total liquidity of all tokens within a specific pool, whereas `total_reserve_in_usd` (token) refers to the total liquidity portion attributable to a specific token across all available pools.
[](https://docs.coingecko.com/docs/common-use-cases#22-get-list-of-onchain-dex-pools-based-on-specific-criteria)
22\. Get list of onchain DEX pools based on specific criteria
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* Use [/pools/megafilter](https://docs.coingecko.com/reference/pools-megafilter)
to retrieve data for onchain DEX pools that match a given set of filters.
* Example of use cases:
* Custom filtering: Combine multiple params — like liquidity thresholds, FDV ranges, 24-hour volume, and more — to extract the precise datasets you need.
* Risk and Quality checks: Apply fraud filters to weed out risky projects.
* For more details on examples and available filters, refer to:
* [Changelog — New Megafilter Endpoint](https://docs.coingecko.com/changelog#february-2025)
* [Live Filtering on GeckoTerminal](https://www.geckoterminal.com/)
[](https://docs.coingecko.com/docs/common-use-cases#23-get-list-of-trending-coins)
23\. Get List of Trending Coins
----------------------------------------------------------------------------------------------------------------------
* Use the following endpoints to get trending coins and pools:
* [Trending Search List](https://docs.coingecko.com/reference/trending-search)
— Trending Coins, NFTs, Categories on CoinGecko.com, based on user searches.
* [Trending Search Pools](https://docs.coingecko.com/reference/trending-search-pools)
— Trending Pools and Tokens on GeckoTerminal.com, based on user searches.
* Other useful endpoints:
* [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
on CoinGecko.com, by specific time duration.
* [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)
and [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)
on GeckoTerminal.com, by specific time duration.
[](https://docs.coingecko.com/docs/common-use-cases#24-get-security-info-of-tokens)
24\. Get Security Info of Tokens
------------------------------------------------------------------------------------------------------------------------
* By using [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)
endpoint, you can obtain the following security related data:
* GeckoTerminal Score (Pool, Transaction, Creation, Info, Holders)
* Holders count, and distribution percentage based on the total supply
(includes all wallet types: CEX, treasury/issuer, etc.)
* Mint and Freeze Authority
[](https://docs.coingecko.com/docs/common-use-cases#25-get-latest-token/pool-data-from-launchpad)
25\. Get Latest Token/Pool Data from Launchpad
----------------------------------------------------------------------------------------------------------------------------------------------------
* Use [megafilter](https://docs.coingecko.com/reference/pools-megafilter)
endpoint to retrieve latest launchpad data, by flagging `sort=pool_created_at_desc`. Learn more on [changelog](https://docs.coingecko.com/changelog#now-supported%3A-launchpad-data-pump-fun-%26-more-%2C-granular-ohlcv%2C-and-honeypot-info)
.
* **Request example (Get latest pools on Pump.fun)**:
Bash
Copy
https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool_created_at_desc&x_cg_pro_api_key=YOUR_API_KEY
[](https://docs.coingecko.com/docs/common-use-cases#26-get-latest-price/data-for-tokens-not-actively-traded)
26\. Get Latest Price/Data for Tokens Not Actively Traded
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------
* When a token has no active pools (no valid swaps in the past 7 days), you can still retrieve the latest available price and data by using the `include_inactive_source=true` parameter.
* This parameter sources data from the pool with the most recent swap, regardless of how long ago it occurred.
* The `last_trade_timestamp` field in the response indicates when the most recent trade took place.
* Supported endpoints:
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
— `/onchain/networks/../tokens/..`
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
— `/onchain/networks/../tokens/multi/..`
* [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)
— `/onchain/networks/../tokens/../pools`
* [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)
— `/onchain/simple/networks/../token_price/..`
* [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
— `/onchain/networks/../tokens/../ohlcv/..`
⚡️ Need Real-time Data Streams? Try [WebSocket API](https://docs.coingecko.com/websocket)
[](https://docs.coingecko.com/websocket)
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our [paid API plan](https://www.coingecko.com/en/api/pricing)
(Analyst plan & above) to access WebSocket and REST API data delivery methods.
Was this page helpful?
YesNo
[Best Practices](https://docs.coingecko.com/docs/best-practices)
[10-mins Tutorial Guide](https://docs.coingecko.com/docs/10-mins-tutorial-guide)
⌘I
---
# Changelog - CoinGecko API
[Skip to main content](https://docs.coingecko.com/changelog#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Changelog
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [December 2025](https://docs.coingecko.com/changelog#december-2025)
* [November 2025](https://docs.coingecko.com/changelog#november-2025)
* [October 2025](https://docs.coingecko.com/changelog#october-2025)
* [September 2025](https://docs.coingecko.com/changelog#september-2025)
* [August 2025](https://docs.coingecko.com/changelog#august-2025)
* [June 2025](https://docs.coingecko.com/changelog#june-2025)
* [May 2025](https://docs.coingecko.com/changelog#may-2025)
* [April 2025](https://docs.coingecko.com/changelog#april-2025)
* [March 2025](https://docs.coingecko.com/changelog#march-2025)
* [February 2025](https://docs.coingecko.com/changelog#february-2025)
* [January 2025](https://docs.coingecko.com/changelog#january-2025)
* [December 2024](https://docs.coingecko.com/changelog#december-2024)
* [October 2024](https://docs.coingecko.com/changelog#october-2024)
* [September 2024](https://docs.coingecko.com/changelog#september-2024)
* [August 2024](https://docs.coingecko.com/changelog#august-2024)
* [May 2024](https://docs.coingecko.com/changelog#may-2024)
* [April 2024](https://docs.coingecko.com/changelog#april-2024)
* [March 2024](https://docs.coingecko.com/changelog#march-2024)
* [February 2024](https://docs.coingecko.com/changelog#february-2024)
* [January 2024](https://docs.coingecko.com/changelog#january-2024)
* [December 2023](https://docs.coingecko.com/changelog#december-2023)
* [November 2023](https://docs.coingecko.com/changelog#november-2023)
* [October 2023](https://docs.coingecko.com/changelog#october-2023)
* [September 2023](https://docs.coingecko.com/changelog#september-2023)
* [June 2023](https://docs.coingecko.com/changelog#june-2023)
* [May 2023](https://docs.coingecko.com/changelog#may-2023)
* [April 2023](https://docs.coingecko.com/changelog#april-2023)
* [March 2023](https://docs.coingecko.com/changelog#march-2023)
* [February 2023](https://docs.coingecko.com/changelog#february-2023)
* [January 2023](https://docs.coingecko.com/changelog#january-2023)
[](https://docs.coingecko.com/changelog#december-2025)
December 2025
[](https://docs.coingecko.com/changelog#access-inactive-token-data-with-new-include-inactive-source-parameter)
Access Inactive Token Data with New `include_inactive_source` Parameter
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **December 16, 2025**We’ve introduced a new `include_inactive_source` query parameter across multiple onchain endpoints, enabling you to retrieve data for tokens even when they have no active pools (no valid swaps in the past 7 days).When `include_inactive_source=true`, the API will source data from the pool with the most recent swap, regardless of how long ago it occurred. This ensures you can still access pricing and volume data for less active and dormant tokens.**Updated endpoints:**
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
— `/onchain/networks/../tokens/..`
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
— `/onchain/networks/../tokens/multi/..`
JSON
Copy
...
"volume_usd": {
"h24": "40075650.4943209"
},
"market_cap_usd": "1544052409.96629",
"last_trade_timestamp": 1712534400
},
"relationships": {
...
* [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)
— `/onchain/networks/../tokens/../pools`
JSON
Copy
...
"h24": "536545444.904535"
},
"reserve_in_usd": "163988541.3812",
"last_trade_timestamp": 1712534400
},
"relationships": {
...
* [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)
— `/onchain/simple/networks/../token_price/..`
JSON
Copy
...
},
"total_reserve_in_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
},
"last_trade_timestamp": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
}
}
...
* [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
— `/onchain/networks/../tokens/../ohlcv/..` (no changes in payload)
[](https://docs.coingecko.com/changelog#upcoming-changes-to-market-cap-rankings-and-api-for-rehypothecated-tokens)
Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **December 15, 2025**At CoinGecko, we are committed to providing the most accurate and independent cryptocurrency data in the industry. As the DeFi landscape evolves, so too must our methodologies for tracking and ranking assets. Today, we are announcing an important update regarding how we categorize and rank **rehypothecated tokens** such as wrapped assets and liquid staking tokens to ensure our market capitalization data remains a true reflection of the market’s value.Read [here](https://www.coingecko.com/learn/upcoming-changes-to-market-cap-rankings-and-api-for-rehypothecated-tokens)
for full details.
####
[](https://docs.coingecko.com/changelog#important:-coingecko-api-breaking-changes)
**Important: CoinGecko API Breaking Changes**
**Effective Date:** These changes are scheduled to go live on **February 4th, 2026.****Note:** If your application does not specifically handle rehypothecated tokens, this breaking change is unlikely to affect you, and no action is required.If you are a developer or use our API for data fetching, please pay close attention to the following breaking changes.
1. **Endpoint:** [/coins/markets](https://docs.coingecko.com/reference/coins-markets)
* **Change:** Rehypothecated tokens will be **excluded** from the response list by default.
* **Action:** To keep them in your list, you must include the `include_rehypothecated=true` parameter.
* When a `category` parameter is added, all coins including rehypothecated tokens will continue to be returned, however the `market_cap_rank` field will be `null`.
2. **Endpoint:** [/coins/{id}](https://docs.coingecko.com/reference/coins-id)
* **Change:** The `market_cap_rank field` will return `null` for rehypothecated tokens.
* **Action:** Use the new `market_cap_rank_with_rehypothecated` field instead.
[](https://docs.coingecko.com/changelog#new-top-traders-by-token-address-endpoint)
New Top Traders by Token Address Endpoint
--------------------------------------------------------------------------------------------------------------------------------
🗓️ **December 4, 2025**Discover the top traders for any token with the new [Top Traders by Token Address](https://docs.coingecko.com/reference/top-token-traders-token-address)
endpoint. This endpoint enables you to monitor whale activity, track significant holders, and analyze trading patterns:**Example payload:**
JSON
Copy
{
"data": {
"id": "base_0x6921b130d297cc43754afba22e5eac0fbf8db75b",
"type": "top_trader",
"attributes": {
"traders": [\
{\
"address": "0xf748879edbe8cca140940788163d7be4d2a2e46a",\
"name": "@zimagetsfox",\
"label": "zimagetsfox.eth",\
"type": "other",\
"realized_pnl_usd": "1157358.77",\
"unrealized_pnl_usd": "255071.37",\
"token_balance": "1454984.43",\
"average_buy_price_usd": "0.01144",\
"average_sell_price_usd": "0.03460",\
"total_buy_count": 48,\
"total_sell_count": 109,\
"total_buy_token_amount": "51422264.86",\
"total_sell_token_amount": "49967280.42",\
"total_buy_usd": "588308.47",\
"total_sell_usd": "1729021.16",\
"explorer_url": "https://etherscan.io/address/0xf748879edbe8cca140940788163d7be4d2a2e46a"\
}\
]
}
}
}
[](https://docs.coingecko.com/changelog#november-2025)
November 2025
[](https://docs.coingecko.com/changelog#new-public-treasury-endpoints:-historical-holdings-and-transactions-history)
New Public Treasury Endpoints: Historical Holdings and Transactions History
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **November 27, 2025**
* Both endpoints support easy ID lookup via respective entity/coin IDs.
* View live data examples on [https://www.coingecko.com/en/treasuries/companies/strategy](https://www.coingecko.com/en/treasuries/companies/strategy)
###
[](https://docs.coingecko.com/changelog#track-public-treasury-holdings-over-time-with-historical-holdings-endpoint)
Track Public Treasury Holdings Over Time with Historical Holdings Endpoint
Query historical holdings data for public companies and governments with the new [Crypto Treasury Holdings Historical Chart Data by ID](https://docs.coingecko.com/reference/public-treasury-entity-chart)
endpoint.**Example payload:**
JSON
Copy
{
"holdings": [\
[\
1763683200000,\
649870.0\
],\
...\
],
"holding_value_in_usd": [\
[\
1763683200000,\
56311217680.033195\
],\
...\
]
}
###
[](https://docs.coingecko.com/changelog#access-transaction-history-with-new-treasury-endpoint)
Access Transaction History with New Treasury Endpoint
Retrieve detailed transaction history for public companies and governments using the new [Crypto Treasury Transaction History by Entity ID](https://docs.coingecko.com/reference/public-treasury-transaction-history)
endpoint.**Example payload:**
JSON
Copy
{
"transactions": [\
{\
"date": 1763337600000,\
"source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt27517abcb8f459e3/691aaadfcd08266e2ec6fbe9/form-8-k_11-17-2025.pdf",\
"coin_id": "bitcoin",\
"type": "buy",\
"holding_net_change": 8178.0,\
"transaction_value_usd": 835554438.0,\
"holding_balance": 649870.0,\
"average_entry_value_usd": 102171.0\
}\
]
}
[](https://docs.coingecko.com/changelog#gt-community-data-for-more-pools-endpoints-plus-farcaster-and-zora-social-url-support)
GT Community Data for more Pools Endpoints plus Farcaster and Zora Social URL Support
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **November 15, 2025**
###
[](https://docs.coingecko.com/changelog#gt-community-data-now-available-across-more-pools-endpoints)
GT Community Data Now Available across More Pools Endpoints
We’ve expanded GeckoTerminal community data support across multiple pool endpoints. When you set `include_gt_community_data=true`, you’ll now receive sentiment voting and community reporting data in your API responses.**New fields surfaced:**
JSON
Copy
...
},
"reserve_in_usd": "163988541.3812",
"sentiment_vote_positive_percentage": 60,
"sentiment_vote_negative_percentage": 40,
"community_sus_report": 18
},
"relationships": {
...
**Improved endpoints:**
* [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)
— `/onchain/networks/trending_pools`
* [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)
— `/onchain/networks/{network}/new_pools`
* [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)
— `/onchain/networks/{network}/trending_pools`
* [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network)
— `/onchain/networks/{network}/pools`
* [Top Pools by DEX](https://docs.coingecko.com/reference/top-pools-dex)
— `/onchain/networks/{network}/dexes/{dex}/pools`
* [New Pools List](https://docs.coingecko.com/reference/latest-pools-list)
— `/onchain/new_pools`
###
[](https://docs.coingecko.com/changelog#farcaster-and-zora-social-urls-support-for-token-info-endpoints)
Farcaster and Zora Social URLs Support for Token Info Endpoints
Farcaster and Zora social URLs are now supported in our token info endpoints. These fields are now surfaced by default alongside existing social links:
JSON
Copy
...
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": null,
...
**Supported endpoints:**
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)
— `/onchain/networks/{network}/tokens/{address}/info`
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)
— `/onchain/networks/{network}/pools/{pool_address}/info`
[](https://docs.coingecko.com/changelog#true-real-time-data-update:-cache-removed-for-key-on-chain-endpoints)
True Real-Time Data Update: Cache Removed for Key On-chain Endpoints
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **November 14, 2025**\[Changes below are applicable to all [paid plan subscribers](https://www.coingecko.com/en/api/pricing)\
.\]Dear CoinGecko API paid plan subscribers,We’re excited to announce a major upgrade to our API, aimed at providing you with direct, instantaneous access to the best real-time data! Starting **02:00 UTC, December 1, 2025**, the 10-second edge cache will be completely removed for the following endpoints. This change means your requests will now pull the freshest data directly from our servers with no cache delay.
| Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency |
| --- | --- | --- | --- |
| [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) | Monday, 02:00 UTC, December 1, 2025 | 10s | Real-time (No Cache) |
| [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address) | Tuesday, 02:00 UTC, December 2, 2025 | 10s | Real-time (No Cache) |
| [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Wednesday, 02:00 UTC, December 3, 2025 | 10s | Real-time (No Cache) |
**What This Means for You:**
* **True Real-Time Data:** You will now receive the absolute freshest, most up-to-date data with every single request. There is no longer any cache layer to cause a delay.
**Things to Keep in Mind:**
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 10 seconds or more to align with the new cache changes.
We’re committed to continuously improving your experience and providing the highest quality data. If you have any questions or need assistance, feel free to reach out to soonaik@coingecko\[dot\]com .**CoinGecko API Team**
[](https://docs.coingecko.com/changelog#onchain-ohlcv-support-extended-to-pools-with-3+-tokens)
Onchain OHLCV Support Extended to Pools with 3+ Tokens
----------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **November 8, 2025**We’ve expanded our onchain OHLCV endpoints to support pools containing more than 2 tokens. Now you can access liquidity pools with additional token compositions beyond simple pair, such as [crvUSD/WETH/CRV](https://www.geckoterminal.com/eth/pools/0x4ebdf703948ddcea3b11f675b4d1fba9d2414a14)
.**Improved endpoints:**
* [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)
— `/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}`
* [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
— `/onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}`
[](https://docs.coingecko.com/changelog#october-2025)
October 2025
[](https://docs.coingecko.com/changelog#websocket-is-now-supported-for-self-serve-api-subscribers)
Websocket is now supported for Self-serve API subscribers
----------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **October 23, 2025**
###
[](https://docs.coingecko.com/changelog#coingecko-websocket-beta-is-now-available-for-paid-plan-customers-analyst-plan-&-above)
CoinGecko Websocket (Beta) is now available for [paid plan](https://www.coingecko.com/en/api/pricing)
customers (Analyst plan & above)!
For Analyst, Lite, Pro, and Pro+ self-serve customers, you are now eligible to access the following Websocket features, and stream real-time data by utilising your monthly API plan credits:
* Max connections: 10 concurrent socket connections
* Max subscriptions: 100 token or pool data subscription per channel, per socket
* Channel Access: [all 4 channels](https://docs.coingecko.com/websocket#channel-%26-data-support)
* Credit charge: **0.1** credit per response returned, deducting from monthly API plan credits
Please visit [Websocket](https://docs.coingecko.com/websocket)
for full details, and test out Websocket data streaming. We will gradually improve the Websocket and expand the feature limits. Please share your feedback and suggestion via this [**survey form**](https://forms.gle/gNE1Txc9FCV55s7ZA)
, or email soonaik@coingecko\[dot\]com .
###
[](https://docs.coingecko.com/changelog#notice:-temporary-disruption-on-magiceden-data-for-nft-endpoints)
Notice: Temporary Disruption on MagicEden data for NFT Endpoints
Due to recent updates to MagicEden’s API, we are updating our integration. During this period, endpoints for NFT data may be temporarily unavailable or return incomplete information.
[](https://docs.coingecko.com/changelog#more-bonding-curve-support-and-new-ascending-sort-for-megafilter)
More Bonding Curve Support and New Ascending Sort for Megafilter
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **October 4, 2025**
###
[](https://docs.coingecko.com/changelog#now-supported-bonding-curve-non-graduated-data-for-more-endpoints)
Now supported Bonding Curve (non-graduated) Data for More Endpoints
We’ve added support for bonding curve (e.g. launchpad graduation from PumpFun) data across multiple token endpoints:
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
— `/onchain/networks/{network}/tokens/{address}`
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
— `/onchain/networks/{network}/tokens/multi/{addresses}`
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)
— `/onchain/networks/{network}/tokens/{address}/info`
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)
— `/onchain/networks/{network}/pools/{pool_address}/info`
JSON
Copy
"launchpad_details": {
"graduation_percentage": 2.16,
"completed": false,
"completed_at": null,
"migrated_destination_pool_address": null
}
###
[](https://docs.coingecko.com/changelog#megafilter:-ascending-sort-order-for-price-change-%)
Megafilter: Ascending Sort Order for Price Change %
The [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)
endpoint now supports ascending sorting for price change percentage:
* `m5_price_change_percentage_asc`
* `h1_price_change_percentage_asc`
* `h6_price_change_percentage_asc`
* `h24_price_change_percentage_asc`
###
[](https://docs.coingecko.com/changelog#token-ohlcv-endpoint-fix-to-respect-specified-token-address)
Token OHLCV Endpoint Fix to respect Specified Token Address
We’ve fixed an issue where the [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
endpoint returned data for the base token of the top pool instead of the requested token. It will now always return data for the specified token address.
[](https://docs.coingecko.com/changelog#september-2025)
September 2025
[](https://docs.coingecko.com/changelog#sdk-gains-public-treasury-coverage,-mcp-adds-exchanges,-nfts,-and-iso-support)
SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **September 25, 2025**
###
[](https://docs.coingecko.com/changelog#expanded-sdk-coverage-for-public-treasuries)
Expanded SDK Coverage for Public Treasuries
We’re broadening our SDK coverage to make treasury-level insights more powerful and easier to access. Check out what’s new below (with functions from [our TypeScript SDK](https://github.com/coingecko/coingecko-typescript)
)
* [`publicTreasury.getCoinID(coinID, { ...params })`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury)
to query public companies & governments’ cryptocurrency holdings by Coin ID
* [`publicTreasury.getEntityID(entityID)`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury)
to query public companies & governments’ cryptocurrency holdings by Entity ID
* [`entities.getList({ ...params })`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#entities)
to query all the supported entities on CoinGecko with entities ID, name, symbol, and country
###
[](https://docs.coingecko.com/changelog#new-mcp-tools:-exchanges,-nfts-&-multi-address-queries)
New MCP Tools: Exchanges, NFTs & Multi-Address Queries
We’re also surfacing new tools through the MCP to give developers a richer, faster way to query exchanges, NFTs, and onchain activity.
* New tools:
* Exchange coverage with [/exchanges/list](https://docs.coingecko.com/reference/exchanges-list)
, [/exchanges/](https://docs.coingecko.com/reference/exchanges-id)
, [/exchanges//tickers](https://docs.coingecko.com/reference/exchanges-id-tickers)
, and [/exchanges//volume\_chart/range](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range)
* NFT markets with [/nfts/markets](https://docs.coingecko.com/reference/nfts-markets)
* Multi-address queries with [/onchain/networks//pools/multi/](https://docs.coingecko.com/reference/pools-addresses)
and [/onchain/networks//tokens/multi/](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
* Retired tools:
* We’ve removed endpoints such as [/coins/list](https://docs.coingecko.com/reference/coins-list)
, [/onchain/networks/trending\_pools](https://docs.coingecko.com/reference/trending-pools-network)
, and single-address pool/token queries in favor of more scalable multi-address endpoints
###
[](https://docs.coingecko.com/changelog#friendlier-time-related-mcp-queries-with-iso-support)
Friendlier Time-related MCP Queries with ISO Support
Time-based queries just got easier. MCP tools now accept **ISO date strings** (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) alongside UNIX timestamps.For example, when using the [Coin Historical Chart Data within Time Range](https://docs.coingecko.com/reference/coins-id-market-chart-range)
tool, you can now pass ISO date strings directly instead of converting them into UNIX timestamps for your LLM tools.**CoinGecko API Team**
[](https://docs.coingecko.com/changelog#new-crypto-treasury-endpoints-and-improvements)
New Crypto Treasury Endpoints and Improvements
------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **September 19, 2025**
1. [Crypto Treasury Holdings by Coin ID](https://docs.coingecko.com/reference/companies-public-treasury)
endpoint now supports governments and more coins data as seen on [https://www.coingecko.com/en/treasuries/bitcoin](https://www.coingecko.com/en/treasuries/bitcoin)
2. **New endpoints:**
1. [Crypto Treasury Holdings by Entity ID](https://docs.coingecko.com/reference/public-treasury-entity)
2. [Entities List (ID Map)](https://docs.coingecko.com/reference/entities-list)
3. [Derivatives Exchange Data by ID](https://docs.coingecko.com/reference/derivatives-exchanges-id)
endpoint now supports `coin_id` and `target_coin_id` to identify coins of ticker pairs.
JSON
Copy
"tickers": [\
{\
"symbol": "ASTERUSDT",\
"base": "ASTER",\
"target": "USDT",\
"coin_id": "aster-2", 👈 NEW\
"target_coin_id": "tether" 👈 NEW\
}\
]
[](https://docs.coingecko.com/changelog#multiple-improvements:-bonding-curve-data,-pooled-token-balance,-and-more)
Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More.
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **September 12, 2025**
###
[](https://docs.coingecko.com/changelog#%F0%9F%9A%80-now-supporting-bonding-curve-data)
🚀 Now Supporting Bonding Curve Data
Bonding curve data (launchpad graduation) is now supported for the followiing endpoints:
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)
**Payload example:**
Copy
"launchpad_details": {
"graduation_percentage": 100,
"completed": true,
"completed_at": "2024-04-08T16:52:35Z",
"migrated_destination_pool_address": "5wNu5QhdpRGrL37ffcd6TMMqZugQgxwafgz477rShtHy"
}
More endpoints to support bonding curve data soon.
###
[](https://docs.coingecko.com/changelog#%F0%9F%9A%80-now-supporting-pooled-token-balance-data)
🚀 Now Supporting Pooled Token Balance Data
The following endpoints now support additional pool token balance data by flagging this parameter `include_composition=true` :
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
(requires `include=top_pools` parameter to be flagged together)
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
(requires `include=top_pools` parameter to be flagged together)
**Payload example:**
Copy
"base_token_balance": "11700.98",
"base_token_liquidity_usd": "29630000",
"quote_token_balance": "66384614.21",
"quote_token_liquidity_usd": "66330000",
###
[](https://docs.coingecko.com/changelog#%F0%9F%9A%80-other-improvements)
🚀 Other improvements
1. [Onchain Megafilter](https://docs.coingecko.com/reference/pools-megafilter)
endpoint now supports more `sort` options:
* `m5_price_change_percentage_desc`
* `h1_price_change_percentage_desc`
* `h6_price_change_percentage_desc`
* `fdv_usd_asc`
* `fdv_usd_desc`
* `reserve_in_usd_asc`
* `reserve_in_usd_desc`
2. [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
endpoint now supports additional price change percentage data by flagging `price_change_percentage` parameter. The available options are: `1h,24h,7d,14d,30d,60d,200d,1y`.
* Payload example:
Copy
"usd_1y_change": 21740.8866287307,
"usd_1h_change": -0.279590756868549,
"usd_24h_change": 3.13876587906131,
"usd_7d_change": -9.67782096261206,
"usd_14d_change": -3.39755498745517,
"usd_30d_change": -13.7768698159765,
"usd_60d_change": 29.9096824213076,
"usd_200d_change": 2282.33681679488
3. [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers)
endpoint now supports to sort tickers based on market cap, by flagging the `order` parameter.
* Available options: `market_cap_desc`, `market_cap_asc`
[](https://docs.coingecko.com/changelog#august-2025)
August 2025
[](https://docs.coingecko.com/changelog#improved-update-frequency-for-selected-pro-api-on-chain-endpoints)
Improved Update Frequency for selected Pro-API On-chain Endpoints
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **August 18, 2025**\[Changes below are applicable to all [paid plan subscribers](https://www.coingecko.com/en/api/pricing)\
.\]Dear CoinGecko API paid plan subscribers,We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, September 2, 2025**, the edge cache duration for the following endpoints will be reduced from \*\*30s \*\*to **10s**, allowing you to retrieve updated data more frequently.
| Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency |
| --- | --- | --- | --- |
| [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
| [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
| [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
| [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s |
| [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s |
| [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
| [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
| [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
| [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
**What This Means for You:**
* **Fresher Data, Quicker**: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!
* **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 10 seconds for endpoints above), there will be no additional credits charged - just like before.
**Things to Keep in Mind:**
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration.
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#e3908c8c8d828a88a3808c8a8d848680888ccd808c8e)
.**CoinGecko API Team**
[](https://docs.coingecko.com/changelog#now-supported:-launchpad-data-pump-fun-&-more-,-granular-ohlcv,-and-honeypot-info)
Now Supported: Launchpad Data (Pump.fun & More), Granular OHLCV, and Honeypot Info
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **August 05, 2025**We’re excited to announce a major update to our on-chain API endpoints! This release introduces support for popular token launchpads, adds high-frequency OHLCV data, and enhances our honeypot detection capabilities to give you deeper and more timely on-chain insights.
###
[](https://docs.coingecko.com/changelog#%F0%9F%9A%80-now-supporting-launchpad-data-pump-fun-&-more)
🚀 Now Supporting Launchpad Data (Pump.fun & More!)
In addition to the 1,600+ DEXes already integrated with GeckoTerminal.com, you can now track token data from popular launchpad platforms directly through the CoinGecko API. More launchpads will be supported soon!**New Supported Launchpads:**
| Launchpad | network id (API) | dex id (API) |
| --- | --- | --- |
| [Meteora DBC](https://www.geckoterminal.com/solana/meteora-dbc/pools) | solana | meteora-dbc |
| [Pump.fun](https://www.geckoterminal.com/solana/pump-fun/pools) | solana | pump-fun |
| [Raydium Launchpad](https://www.geckoterminal.com/solana/raydium-launchlab/pools)
(LetsBonkFun) | solana | raydium-launchlab |
| [Boop.fun](https://www.geckoterminal.com/solana/boop-fun/pools) | solana | boop-fun |
| [Virtuals (Base)](https://www.geckoterminal.com/base/virtuals-base/pools) | base | virtuals-base |
**Improved endpoints to track launchpad data:**
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)
More launchpad-specific data will be supported soon for the endpoints above!**Tips:** use [megafilter endpoint](https://docs.coingecko.com/reference/pools-megafilter)
to retrieve latest launchpad data, by flagging `sort=pool_created_at_desc`**Request example** (Get latest pools on Pump.fun):
Copy
https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool_created_at_desc&x_cg_pro_api_key=YOUR_KEY
###
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-more-granular-ohlcv-data)
\[Pro-API Exclusive\] More Granular OHLCV Data
On-chain OHLCV endpoints now support higher frequency intervals, down to 1-second granularity.
| Timeframe | Aggregate (Before) | Aggregate (New) |
| --- | --- | --- |
| day | 1 | 1 |
| hour | 1, 4, 12 | 1, 4, 12 |
| minute | 1, 5, 15 | 1, 5, 15 |
| second | n/a | 1, 15, 30 |
**Improved Endpoints:**
* [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)
* [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
**New interval supported:**
* 1s
* 15s
* 30s
**Example Request (Get the last 100 1-second intervals for a pool on Ethereum):**
Copy
https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/second?aggregate=1&limit=100&include_empty_intervals=false&x_cg_pro_api_key=YOUR_KEY
###
[](https://docs.coingecko.com/changelog#%F0%9F%8D%AF-enhanced-honeypot-information)
🍯 Enhanced Honeypot Information
We’ve expanded our honeypot detection features to provide more comprehensive risk assessment. You can now check if a token is a potential honeypot using the main info endpoints.**Improved Endpoints:**
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)
**Example Payload:**
Copy
{
"mint_authority": null,
"freeze_authority": null,
"is_honeypot": true // possible values: true / false / unknown
}
###
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-filtering-option-in-megafilter)
\[Pro-API Exclusive\] New Filtering Option in Megafilter
Previously, the[Pools Megafilter](https://docs.coingecko.com/reference/pools-megafilter)
endpoint could only show tokens confirmed as _**not**_ a honeypot (`checks=no_honeypot`). Now, you can also include tokens where the honeypot status is ‘unknown’.
* To use this, set `include_unknown_honeypot_tokens=true`.
* Important: This parameter only takes effect when `checks=no_honeypot` is also specified in the request.
**Example Request (Get trending pools that are not confirmed honeypots, including those with an unknown status):**
Copy
https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&sort=h6_trending&checks=no_honeypot&include_unknown_honeypot_tokens=true&x_cg_pro_api_key=YOUR_KEY
###
[](https://docs.coingecko.com/changelog#%F0%9F%93%88-expanded-pool-data)
📈 Expanded Pool Data
**Endpoint**: [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)
By adding `include=pool` to your request on the pool tokens endpoint, you can now retrieve additional context about the pool itself.
* Base and quote token address
* Sentiment vote percentage (positive and negative)
* Community suspicious reports count
**Payload Example**:
Copy
"included": [\
{\
"id": "eth_0x06da0fd433c1a5d7a4faa01111c044910a184553",\
"type": "pool",\
"attributes": {\
"base_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\
"quote_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"sentiment_vote_positive_percentage": 100,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
}\
}\
]
[](https://docs.coingecko.com/changelog#june-2025)
June 2025
[](https://docs.coingecko.com/changelog#sol-currency-is-now-supported-for-coingecko-endpoints)
SOL Currency Is Now Supported for CoinGecko Endpoints
--------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **June 19, 2025**We’re excited to announce that you can now obtain real-time and historical price & market data for tokens listed on CoinGecko.com, with the option to return data value in **SOL** (Solana) currency.Note: for dates prior to May 2025, ‘SOL’ historical data is limited to hourly and daily granularity**Improved endpoints:**
* [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)
* [Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price)
* [Supported Currencies List](https://docs.coingecko.com/reference/simple-supported-currencies)
* [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
* [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets)
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)
* [Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history)
* [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart)
* [Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range)
* [Coin OHLC Chart by ID](https://docs.coingecko.com/reference/coins-id-ohlc)
* [Coin OHLC Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-ohlc-range)
* [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address)
* [Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart)
* [Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range)
* [Trending Search List](https://docs.coingecko.com/reference/trending-search)
* [Crypto Global Market Data](https://docs.coingecko.com/reference/crypto-global)
**Example**: price of Bitcoin in Solana, using [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)
endpoint.
Copy
{
"bitcoin": {
"sol": 720.21
}
}
**Example:** historical daily price, market cap and volume of Trump in Solana, using [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart)
endpoint.
Copy
{
"prices": [\
[\
1750118400000,\
0.0640701365814472\
],\
[\
1750204800000,\
0.0644263929356261\
],\
[\
1750291200000,\
0.0639713357587322\
],\
[\
1750326151000,\
0.06415963364804504\
]\
],
"market_caps": [\
[\
1750118400000,\
12843589.584485611\
],\
[\
1750204800000,\
12882547.839086628\
],\
[\
1750291200000,\
12793790.726102708\
],\
[\
1750326151000,\
12826247.390733324\
]\
],
"total_volumes": [\
[\
1750118400000,\
2425793.780846796\
],\
[\
1750204800000,\
2055697.9106767387\
],\
[\
1750291200000,\
1871087.4334618242\
],\
[\
1750326151000,\
2008278.189223005\
]\
]
}
[](https://docs.coingecko.com/changelog#new-endpoints-&-improvements:-historical-token-holders-chart,-ohlcv-by-token-address,-multi-pool-token-data-support)
New Endpoints & Improvements: Historical Token Holders Chart, OHLCV by Token Address, Multi-pool Token Data Support
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
🗓️ **June 09, 2025**
###
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-endpoint-historical-token-holders-chart-by-token-address)
\[Pro-API Exclusive\] New Endpoint - Historical Token Holders Chart by Token Address
This new endpoint allows you to get the historical token holders chart based on the provided token contract address on a network.
* Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
Check it out now: [Historical Token Holders Chart by Token Address](https://docs.coingecko.com/reference/token-holders-chart-token-address)
###
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-endpoint-token-ohlcv-chart-by-token-address)
\[Pro-API Exclusive\] New Endpoint - Token OHLCV chart by Token Address
This endpoint allows you to get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network.
* This endpoint will return OHLCV data of the most liquid pool of the specified token. You may use this endpoint Top Pools by Token Address to check the top pools of a token.
Check it out now: [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address#/)
###
[](https://docs.coingecko.com/changelog#improved-endpoints-support-multi-pool-token-data)
Improved Endpoints - Support Multi-pool Token Data
Previously, we only surfaced 1 quote token for pools with more than 2 tokens. With this new improvements, for pools that have 2 or more tokens:
* Extra quote tokens being listed under a new key `relationships.quote_tokens`
* If `include=quote_token` is flagged, the extra quote tokens will be also listed under `included`
Copy
"relationships": {
"base_token": {
"data": {
"id": "eth_0x40d16fc0246ad3160ccc09b8d0d3a2cd28ae6c2f",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "eth_0x8353157092ed8be69a9df8f95af097bbf33cb2af",
"type": "token"
}
},
"quote_tokens": {
"data": [\
{\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
},\
{\
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",\
"type": "token"\
}\
\
\
This improvement is applicable to all onchain pool endpoints that support `relationships.quote_token`, including but not limited to:\
\
* [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address#/)\
\
* [Search Pools](https://docs.coingecko.com/reference/search-pools#/)\
\
* [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter#/)\
\
* [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list#/)\
\
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address#/)\
\
* [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network#/)\
\
* [New Pools List](https://docs.coingecko.com/reference/latest-pools-list#/)\
\
\
[](https://docs.coingecko.com/changelog#may-2025)\
\
May 2025\
\
[](https://docs.coingecko.com/changelog#upcoming-change-notice:-removal-of-normalized-volume-btc-data)\
\
Upcoming Change Notice: Removal of normalized\_volume\_btc Data\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 30, 2025****`Notice: Upcoming Change to CoinGecko API Endpoints - Removal ofnormalized_volume_btc Data`****Effective Date: 16 June 2025****Affected Endpoints:**\
\
* [Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id)\
\
* [Exchanges List with Data](https://docs.coingecko.com/reference/exchanges#/)\
\
\
**Details of the Change:**Please be advised that the `normalized_volume_btc` data point will be removed from the above-listed API endpoints, effective 16 June 2025. This change is being implemented due to significant recent change to a 3rd party data source provider, which have fundamentally altered how this specific data can be accessed.Example of Affected Data Structure:\
\
Copy\
\
{\
"trade_volume_24h_btc_normalized": 47765.5886637453\
},\
\
\
After the effective date, the `trade_volume_24h_btc_normalized` field will no longer be present in the API responses for these endpoints.**Action Required:**If your applications or integrations currently rely on the `trade_volume_24h_btc_normalized` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 16 June 2025 to avoid potential errors or data discrepancies.\
\
[](https://docs.coingecko.com/changelog#new-endpoint-&-improvements:-on-chain-trades,-net-buy-volume,-and-more)\
\
New Endpoint & Improvements: On-Chain Trades, Net Buy Volume, and More\
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 29, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-endpoint-on-chain-trades-by-token-address)\
\
\[Pro-API Exclusive\] New Endpoint - On-chain Trades by Token Address\
\
Previously, the [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address)\
endpoint allows you to retrieve the last 300 trades of a specific pool only.With this new endpoint [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address)\
, you can now retrieve the last 300 trades **across different pools**, based on the provided **token contract address** on a network.\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-net-buy-volume-data)\
\
Improved Endpoints - Support Net Buy Volume Data\
\
The following endpoints now support more volume breakdown data:\
\
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)\
\
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses#/)\
\
\
By flagging `include_volume_breakdown=true` , you can surface the following data:\
\
* net\_buy\_volume\_usd\
* buy\_volume\_usd\
* sell\_volume\_usd\
\
Sample Response:\
\
JSON\
\
Copy\
\
{\
"data": {\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
...\
},\
"net_buy_volume_usd": {\
"m5": "-40796.577553965",\
"m15": "-69765.771189161",\
"m30": "-88014.095440243",\
"h1": "0.000000000000",\
"h6": "1884879.921855301",\
"h24": "17555422.243003801"\
},\
"buy_volume_usd": {\
"m5": "30597.433165473",\
"m15": "139531.542378324",\
"m30": "396063.429481099",\
"h1": "969922.728762430",\
"h6": "10366839.570204150",\
"h24": "52666266.729011402"\
},\
"sell_volume_usd": {\
"m5": "71394.010719438",\
"m15": "209297.313567485",\
"m30": "484077.524921342",\
"h1": "969922.728762430",\
"h6": "8481959.648348849",\
"h24": "35110844.486007601"\
},\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoint-on-chain-ohlcv-endpoint)\
\
Improved Endpoint - On-Chain OHLCV endpoint\
\
[Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)\
endpoint now supports to include empty intervals by flagging `include_empty_intervals=true` .\
\
* By default, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded (or **skipped**) from the response.\
* This new parameter option provides the flexibility to get **padded** data, when there’s no trade data.\
\
Sample Response:\
\
Copy\
\
{\
"data": {\
"id": "81da0682-1c4f-445a-9bed-9b5454004df5",\
"type": "ohlcv_request_response",\
"attributes": {\
"ohlcv_list": [\
[\
1744712700,\
0.000212149802253853,\
0.000212173305907688,\
0.000212149802253853,\
0.000212173305907688,\
46.48164903882\
],\
[\
1744712400,\
0.000212149802253853, 👈 O — Follow previous Close value\
0.000212149802253853, 👈 H — Follow previous Close value\
0.000212149802253853, 👈 L — Follow previous Close value\
0.000212149802253853, 👈 C — Follow previous Close value\
0.0 👈 V — Set to zero\
],\
[\
1744712100,\
0.000210532522666822,\
0.000212149802253853,\
0.000210532522666822,\
0.000212149802253853, 👈 Previous Close value\
46.4765\
],\
...\
}\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-large-images)\
\
Improved Endpoints - Support Large Images\
\
The following endpoints now support more size options for coin logo image:\
\
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-addres)\
\
\
Sample Response:\
\
Copy\
\
"data": {\
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",\
"type": "token",\
"attributes": {\
...\
"image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",\
"image": {\
"thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661",\
"small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",\
"large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661"\
},\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-normalized-supply-data)\
\
Improved Endpoints - Support Normalized Supply Data\
\
The following endpoints now support `normalized_total_supply`:\
\
* [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)\
\
* [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)\
\
\
Sample Response:\
\
Copy\
\
"decimals": 6,\
"total_supply": "49999156520373530.0",\
"normalized_total_supply": "49999156520.37353",\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-pool-%E2%80%98name%E2%80%99-and-%E2%80%98fee%E2%80%99-data)\
\
Improved Endpoints - Support Pool ‘Name’ and ‘Fee’ Data\
\
The following endpoints now support `pool_name` and `pool_fee`:\
\
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)\
\
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)\
\
\
Sample Response:\
\
Copy\
\
"name": "WETH / USDC 0.05%",\
"pool_name": "WETH / USDC",\
"pool_fee_percentage": "0.05",\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-symbols-of-dex-pairs)\
\
Improved Endpoints - Support Symbols of DEX Pairs\
\
The following endpoints now allow to flag `dex_pair_format=symbol` to return DEX pair symbols instead of contract address.\
\
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)\
\
* [Coin Tickers by ID](https://docs.coingecko.com/reference/coins-id-tickers)\
\
* [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers)\
\
* [Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id)\
\
\
Sample Response:\
\
Copy\
\
// before\
{\
"base": "0X8FC8F8269EBCA376D046CE292DC7EAC40C8D358A",\
"target": "0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48",\
"market": {\
"name": "Uniswap V2 (Ethereum)",\
"identifier": "uniswap_v2",\
...\
}\
\
// now when "dex_pair_format=symbol" is flagged\
{\
"base": "DFI",\
"target": "USDC",\
"market": {\
"name": "Uniswap V2 (Ethereum)",\
"identifier": "uniswap_v2",\
...\
}\
\
\
[](https://docs.coingecko.com/changelog#april-2025)\
\
April 2025\
\
[](https://docs.coingecko.com/changelog#new-endpoint-&-improvements:-on-chain-trending-data,-enhanced-trending-search,-and-improved-token-lookup)\
\
New Endpoint & Improvements: On-Chain Trending Data, Enhanced Trending Search, and Improved Token Lookup\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **April 25, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-endpoint-on-chain-trending-search-data)\
\
\[Pro-API Exclusive\] New Endpoint - On-chain Trending Search Data\
\
With this new endpoint [Trending Search Pools](https://docs.coingecko.com/reference/trending-search-pools)\
, you can now retrieve the on-chain trending search pools and tokens data, as seen on GeckoTerminal.com .By default, this endpoint returns the top 4 trending pools data, you may specify the `pools` parameter to retrieve up to top 10 pools data.Tips: you may flag `include=base_token` to retrieve the trending tokens data.Note: this exclusive endpoint is available for our API [paid plan](https://www.coingecko.com/en/api/pricing)\
subscribers (Analyst plan & above).\
\
### \
\
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-improved-endpoint-trending-search-list)\
\
\[Pro-API Exclusive\] Improved Endpoint - Trending Search List\
\
[Paid plan](https://www.coingecko.com/en/api/pricing)\
subscribers (Analyst plan & above) can now use [Trending Search List](https://docs.coingecko.com/reference/trending-search)\
endpoint and flag `show_max` parameter to retrieve more trending coins, NFTs and coin categories on CoinGecko.com.\
\
| Trending Data | Public API (Demo plan) | Paid API (Analyst plan & above) |\
| --- | --- | --- |\
| Coins | 15 | 30 |\
| NFTs | 7 | 10 |\
| Coin Categories | 6 | 10 |\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-endpoints-support-token-lookup-by-symbol-and-name)\
\
Improved Endpoints - Support Token Lookup by Symbol and Name\
\
The following endpoints now support token lookup by symbol and name, in addition to the existing API ID support:\
\
* [Coin Price by IDs and Symbols](https://docs.coingecko.com/reference/simple-price)\
\
* [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets)\
\
\
Previously, these endpoints only supported token lookup by \[API IDs\]([https://docs.coingecko.com/docs/1-get-data-by-id-or-address#/methods-to-query-price—market-data-of-coins](https://docs.coingecko.com/docs/1-get-data-by-id-or-address#/methods-to-query-price--market-data-of-coins))\
. This enhancement streamlines token data retrieval and eliminates the need for manual coin ID mapping.Example Mapping:\
\
| API Ids | Symbol | Name |\
| --- | --- | --- |\
| bitcoin | btc | Bitcoin |\
| tether | usdt | Tether |\
| usd-coin | usdc | USDC |\
\
Lookup Priority: When multiple lookup parameters are provided, the system applies the following priority order: id (highest) > name > symbol (lowest).**`Filtering by Symbol withinclude_tokens`**The `include_tokens`parameter has been added to provide flexibility when filtering by symbol:\
\
* `include_tokens=top` : Returns only the top market cap token for the specified symbol.\
* `include_tokens=all`: Returns all tokens that share the specified symbol.\
\
Example Request & Data:\
\
| Request Example | Token Data Returned | Remarks |\
| --- | --- | --- |\
| pro-api.coingecko.com/api/v3/coins/markets?vs\_currency=usd&symbols=btc&include\_tokens=top | 1\. Bitcoin | When symbols and ‘include\_tokens=**top**’ is specified, only the top market cap tokens will be returned. |\
| pro-api.coingecko.com/api/v3/coins/markets?vs\_currency=usd&symbols=btc&include\_tokens=all | 1\. Bitcoin
2\. Osmosis allBTC
3\. atcat
4\. Meld Bridged BTC (Meld)
5\. BlackrockTradingCurrency | When symbols and ‘include\_tokens=**all**’ is specified, all the coins that share the same symbol will be returned.
All the 5 coins stated in the example have the same symbol ‘btc’. |\
\
### \
\
[](https://docs.coingecko.com/changelog#/coins/markets-endpoint-improvement)\
\
/coins/markets Endpoint Improvement\
\
We’ve enhanced the`/coins/markets` endpoint [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets)\
, by including ‘total’ and ‘per-page’ values in the Response Headers.This addition to the Response Headers enables developers to identify the total number of active coins on coingecko.com and specify the required pagination to retrieve all available data.\
\
Response Header (Example)\
\
Copy\
\
per-page: 250\
total:16989\
\
\
[](https://docs.coingecko.com/changelog#upcoming-change-notice:-removal-of-twitter-followers-data)\
\
Upcoming Change Notice: Removal of twitter\_followers Data\
-----------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **April 25, 2025****`Notice: Upcoming Change to CoinGecko API Endpoints - Removal oftwitter_followers Data`****Effective Date: 15 May 2025****Affected Endpoints:**\
\
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)\
\
* [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address)\
\
* [Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history)\
\
\
**Details of the Change:**Please be advised that the `twitter_followers` data point within the `community_data` object will be removed from the above-listed API endpoints, effective 15 May 2025. This change is being implemented due to significant recent changes to the X (formerly Twitter) API, which have fundamentally altered how this specific data can be accessed.Example of Affected Data Structure:\
\
Copy\
\
"community_data": { \
"twitter_followers": 7694251,\
// ... other community data points ...\
}\
\
\
After the effective date, the `twitter_followers` field will no longer be present in the API responses for these endpoints.**Action Required:**If your applications or integrations currently rely on the `twitter_followers` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 15 May 2025 to avoid potential errors or data discrepancies.**`Important Note Regarding Previously Storedtwitter_followers Data:`**Please be aware that if you have previously stored `twitter_followers` data obtained from the CoinGecko API and archived it within your own systems, you are solely responsible for its continued use and any implications thereof.We appreciate your understanding as we adapt to changes in third-party platforms to maintain the stability and reliability of our API. If you have any questions or require further clarification, please do not hesitate to contact our support team.\
\
[](https://docs.coingecko.com/changelog#march-2025)\
\
March 2025\
\
[](https://docs.coingecko.com/changelog#new-endpoint-&-multiple-improvements:-on-chain-top-token-holder-address,-security-data,-historical-supply)\
\
New Endpoint & Multiple Improvements: On-Chain Top Token Holder Address, Security Data, Historical Supply.\
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **March 28, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#[pro-api-exclusive]-new-endpoint-top-token-holder-address-data)\
\
\[Pro-API Exclusive\] New Endpoint - Top Token Holder Address Data\
\
You can now access the top 50 token holder address data for tokens, as seen on GeckoTerminal.com.By default, this endpoint returns the top 10 holders data, you can also specify the `holders` parameter to retrieve up to top 50 holders data.**Network supported:**\
\
* EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base\
* Solana\
* Sui\
* TON\
* Ronin\
\
👉 Visit the endpoint reference page - [Top Token Holders by Token Address](https://docs.coingecko.com/reference/top-token-holders-token-address)\
to learn more and try it out now!**Note:** this exclusive endpoint is available for our API [paid plan](https://www.coingecko.com/en/api/pricing)\
subscribers (Analyst plan & above).\
\
* The holders data is currently in **Beta**, with ongoing improvements to data quality, coverage, and update frequency.\
* For Solana tokens, the maximum number of retrievable top holders data is 40 instead of 50.\
\
**Tips:** You may also use the following endpoints to retrieve **token holders count** and **top holders distribution percentage data**:\
\
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#historical-supply-endpoints-support-for-inactive-coins)\
\
Historical Supply endpoints - Support for Inactive Coins\
\
You may now access historical total and circulating supply data of inactive coins using the following endpoints. To check for list of inactive coins, you may use [Coin List (ID Map)](https://docs.coingecko.com/reference/coins-list)\
endpoint and flag `status=inactive`.Note: these endpoints below are exclusive for [Enterprise plan](https://www.coingecko.com/en/api/pricing)\
customers only.**Improved endpoints:**\
\
* [Circulating Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart)\
\
* [Circulating Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range)\
\
* [Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart)\
\
* [Total Supply Chart within time range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-pool-data-endpoints-locked-liquidity)\
\
Onchain Pool Data endpoints - Locked Liquidity\
\
Now support **`locked_liquidity_percentage`** data.**Improved endpoints:**\
\
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)\
\
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)\
\
\
Copy\
\
{\
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
..\
"volume_usd": {\
"m5": "868581.7348314",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"locked_liquidity_percentage": "99.82"\
},\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-token-info-endpoints-gt-score,-mint-authority,-freeze-authority)\
\
Onchain Token Info endpoints - GT Score, Mint Authority, Freeze Authority\
\
The following Token Info endpoints now provide more security related information:\
\
* **GeckoTerminal Score Details** - Learn more about GT Score [here](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated)\
.\
* **Pool** - Combination of pool signals such as honeypot risk, buy/sell tax, proxy contract, liquidity amount, and whether the liquidity is locked.\
* **Transaction** - Total number of transactions and trading volume in the last 24 hours.\
* **Creation** - Age of the pool since creation. The longer, the better it is for the score.\
* **Info** - Submitted social info and metadata to the token.\
* **Holders** - Distribution of tokens among unique addresses.\
* **Mint Authority**\
* **Freeze Authority**\
\
**Improved endpoints:**\
\
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
\
Copy\
\
"gt_score": 92.6605504587156, \
"gt_score_details": {\
"pool": 0,\
"transaction": 32.2,\
"creation": 0,\
"info": 0,\
"holders": 0\
}\
"mint_authority": "no", \
"freeze_authority": "no" \
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-simple-token-price-endpoint-market-cap-to-fdv-fallback)\
\
Onchain Simple Token Price endpoint - Market Cap to FDV Fallback\
\
The [Onchain Simple Token Price](https://docs.coingecko.com/reference/onchain-simple-price)\
endpoint now supports fallback option for Market Cap to return FDV value, when the Market Cap value is not available.Notes:\
\
* If the token’s market cap is not verified by the CoinGecko team, the onchain endpoints 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.\
\
If you require the Market Cap key (`market_cap_usd`) to return FDV value (as seen on GeckoTerminal.com) when Market Cap data is unavailable, please specify this parameter `marketcap_fdv_fallback=true`.\
\
[](https://docs.coingecko.com/changelog#update-frequency-improvements-for-selected-pro-api-endpoints-march-2025)\
\
Update Frequency Improvements for selected Pro-API endpoints (March 2025)\
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **March 14, 2025**\[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing)\
only.\]Dear CoinGecko API paid plan subscribers,We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, March 25, 2025**, the edge cache duration for the following endpoints will be reduced from 60s to 30s, allowing you to retrieve updated data more frequently.\
\
1. Effective from 02:00 UTC, March 25, 2025:\
1. [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)\
\
2. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)\
\
3. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network)\
\
4. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex)\
\
2. Effective from 02:00 UTC, March 26, 2025:\
1. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)\
\
2. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list)\
\
3. [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)\
\
4. [Search Pools](https://docs.coingecko.com/reference/search-pools)\
\
3. Effective from 02:00 UTC, March 27, 2025:\
1. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)\
\
2. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated)\
\
3. [Pools by Category ID](https://docs.coingecko.com/reference/pools-category)\
\
\
**What This Means for You:**\
\
* **Fresher Data, Quicker**: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!\
* **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits charged—just like before.\
\
**Things to Keep in Mind:**\
\
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.\
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration.\
\
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#aad9c5c5c4cbc3c1eac9c5c3c4cdcfc9c1c584c9c5c7)\
.**CoinGecko API Team**\
\
[](https://docs.coingecko.com/changelog#multiple-improvement:-holders-data,-pool-stats,-simple-token-price)\
\
Multiple Improvement: Holders data, Pool Stats, Simple Token Price\
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **March 14, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-token-info-endpoints-holders-data)\
\
Onchain Token Info endpoints - Holders data\
\
Now support the following holder data **(Beta)**:\
\
* holders count\
* top holders distribution percentage\
\
**Improved endpoints:**\
\
* [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
* [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
\
Copy\
\
"holders": {\
"count": 1432761,\
"distribution_percentage": {\
"top_10": "1.3019",\
"11_20": "0.1024",\
"21_40": "0.095",\
"rest": "98.5007"\
},\
"last_updated": "2025-03-06T01:21:18Z"\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-pool-data-endpoints-more-data-support)\
\
Onchain Pool Data endpoints - More Data Support\
\
Now support the following data:\
\
* `price_change_percentage`: m15, m30\
* `volume_usd`: m15, m30\
* `transactions`: h6\
\
**Improved endpoints:**\
\
* [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)\
\
* [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)\
\
\
Copy\
\
"price_change_percentage": {\
"m5": "0.06",\
"m15": "0.06",\
"m30": "0.89",\
"h1": "-4.31",\
"h6": "-1.02",\
"h24": "3.32"\
},\
"transactions": {\
"m5": {\
"buys": 0,\
"sells": 2,\
"buyers": 0,\
"sellers": 2\
},\
"m15": {\
"buys": 0,\
"sells": 2,\
"buyers": 0,\
"sellers": 2\
},\
"m30": {\
"buys": 0,\
"sells": 3,\
"buyers": 0,\
"sellers": 3\
},\
"h1": {\
"buys": 1,\
"sells": 23,\
"buyers": 1,\
"sellers": 7\
},\
"h6": {\
"buys": 60,\
"sells": 38,\
"buyers": 23,\
"sellers": 18\
},\
"h24": {\
"buys": 206,\
"sells": 138,\
"buyers": 96,\
"sellers": 77\
}\
},\
"volume_usd": {\
"m5": "130.5119858698",\
"m15": "130.5119858698",\
"m30": "177.109036156",\
"h1": "4942.2463835639",\
"h6": "28362.2127269542",\
"h24": "112426.585893123"\
}\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-simple-token-price-endpoint-liquidity-&-price-change-percentage-data)\
\
Onchain Simple Token Price endpoint - Liquidity & Price Change Percentage data\
\
Now supports the following optional parameter to return more data.\
\
* `include_24hr_price_change` (24hr price change percentage)\
* `include_total_reverse_in_usd` (token liquidity data - total liquidity portion attributable to a specific token across all available pools)\
\
**Improved Endpoint:**\
\
* [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)\
\
\
Copy\
\
{\
"data": {\
"id": "e58258f7-8368-4968-bbe1-b5343540cd71",\
"type": "simple_token_price",\
"attributes": {\
"token_prices": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00276143983565",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3175.22870146126"\
},\
"market_cap_usd": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "25000000000",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "500000000000"\
},\
"h24_volume_usd": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "50000000",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10000000000"\
},\
"h24_price_change_percentage": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "-0.15",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1.15"\
},\
"total_reserve_in_usd": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "417994486.4342195821530162288",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "417994486.4342195821530162288" \
}\
}\
}\
\
\
[](https://docs.coingecko.com/changelog#february-2025)\
\
February 2025\
\
[](https://docs.coingecko.com/changelog#new-megafilter-endpoint,-200+-chains-supported:-hyperliquid,-abstract,-berachain-&-moar)\
\
New Megafilter Endpoint, 200+ Chains Supported: Hyperliquid, Abstract, Berachain & MOAR!\
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 27, 2025**Powered by GeckoTerminal, the CoinGecko API now supports on-chain data across **200+ blockchain networks**, including the latest additions: Hyperliquid, HyperEVM, Abstract, Berachain, Story, Monad, Unichain, and Soneium.While we offer the widest on-chain data coverage, we understand that you may have specific needs when slicing and dicing data for your use case. That’s why we’re introducing Megafilter, an exclusive endpoint available for our API paid plan subscribers (Analyst plan & above).\
\
### \
\
[](https://docs.coingecko.com/changelog#%F0%9F%94%A5-what%E2%80%99s-megafilter)\
\
🔥 What’s Megafilter?\
\
This new endpoint provides unmatched flexibility, allowing you to query and filter data exactly the way you want.🔗 Docs: [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)\
\
### \
\
[](https://docs.coingecko.com/changelog#%F0%9F%91%80-what-can-you-do)\
\
👀 What Can You Do?\
\
With the /megafilter endpoint, you can slice and dice on-chain data your way across:\
\
* 200+ blockchain networks, 1,400+ dexes, 6M+ pools, and 5M+ tokens\
* Advanced filtering options based on liquidity, FDV, volume, transactions, buy/sell trends, and time range\
* Custom sorting, including trending pools (5m), newest pools, or liquidity growth\
* Fraud detection filters: Exclude honeypots, check GT Score, verify CG listings, and track social metrics\
\
Here’s some quick examples:\
\
* Track fresh pools on Uniswap V4 & Aerodrome with liquidity above $1,000\
* Discover trending DEX pools across Solana, Base, and other chains with a high GT Score.\
* Filter out risky pools with built-in honeypot protection & fraud checks\
* Customize data retrieval based on your strategy: time-based, volume-based, or trend-driven\
\
### \
\
[](https://docs.coingecko.com/changelog#try-it-out-now)\
\
Try it out now!\
\
🚀 API Docs: [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)\
\
🔗 Live Filtering on [GeckoTerminal](https://www.geckoterminal.com/)\
\
[](https://docs.coingecko.com/changelog#update-frequency-improvements-for-selected-pro-api-endpoints)\
\
Update Frequency Improvements for selected Pro-API endpoints\
----------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 14, 2025**\[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing)\
only.\]Dear CoinGecko API paid plan subscribers,We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, February 24, 2025**, the edge cache duration for the following endpoints will be reduced to 30s, allowing you to retrieve updated data more frequently.\
\
| Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency |\
| --- | --- | --- | --- |\
| Onchain [/networks/../tokens/](https://docs.coingecko.com/reference/token-data-contract-address) | 02:00 UTC, February 24, 2025 | 60s | 30s |\
| Onchain [/networks/../tokens/multi/](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | 06:00 UTC, February 24, 2025 | 60s | 30s |\
| Onchain [/networks/../pools/../ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 25, 2025 - Enterprise plan subscribers only | 60s | 30s |\
| Onchain [/networks/../pools/../ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 26, 2025 - Analyst/Lite/Pro plan subscribers | 60s | 30s |\
\
**What This Means for You:**\
\
* **Fresher Data, Quicker**: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!\
* **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits charged—just like before.\
\
**Things to Keep in Mind:**\
\
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.\
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration.\
\
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#75061a1a1b141c1e35161a1c1b1210161e1a5b161a18)\
.**CoinGecko API Team**\
\
[](https://docs.coingecko.com/changelog#enhanced-onchain-metadata,-increased-max-address-limit-for-multi-endpoints,-improved-exchange-tickers-sorting)\
\
Enhanced Onchain Metadata, Increased Max Address Limit for Multi Endpoints, Improved Exchange Tickers Sorting\
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 09, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-metadata:-improved-coverage)\
\
Onchain Metadata: Improved Coverage\
\
**Previously:** Payload may return ‘missing.png’ for `image_url` for tokens that do not have image data.**Now:** Coverage of metadata (images, websites, description, socials) is now improved for tokens on Solana, Ton, Base, and Sui networks. For tokens that do not contain image data, ‘null’ value will be returned for `image_url`.**Improved endpoints with image data:**\
\
1. [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)\
\
2. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)\
\
3. [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)\
\
4. [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)\
\
5. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network)\
\
6. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex)\
\
7. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)\
\
8. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list)\
\
9. [Search Pools](https://docs.coingecko.com/reference/search-pools)\
\
10. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)\
\
11. [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)\
\
12. [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)\
\
13. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
14. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
15. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated)\
\
\
**Improved endpoints with metadata (images, websites, description, socials):**\
\
1. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
2. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
3. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated)\
\
\
Note: Metadata 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:\
\
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)\
\
* [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-max-address-limit-for-onchain-/multi-endpoints)\
\
Improved Max Address Limit for onchain /multi endpoints\
\
**Previously:** Onchain /multi endpoints support up to 30 token or pool contract addresses per request.**Now:** Onchain /multi endpoints support up to 50 token or pool contract addresses per request.**Improved endpoints:**\
\
1. [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)\
\
2. [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)\
\
\
Note: this new max address input limit is exclusive for paid plan subscribers (Analyst plan & above) only.\
\
### \
\
[](https://docs.coingecko.com/changelog#improved-data-consistency-for-exchange-tickers-by-id)\
\
Improved Data Consistency for Exchange Tickers by ID\
\
For [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers)\
endpoint, the order is sorted by **trust\_score\_desc** by default.\
\
* Sometimes duplicate or missing data may occur due to paginated cached response, especially when a ticker’s rank changes between 2 paginated requests, e.g. it might shift from Page 2 to Page 1, vice versa.\
* We’ve added a new `order` option: **base\_target**, which will sort the tickers by **base** symbol, then **target** symbol, in lexicographical order, i.e. `0->9`, then `a->Z`.\
\
Example: flagging ?order=base\_target\
\
Copy\
\
pro-api.coingecko.com/api/v3/exchanges/binance/tickers?order=base_target\
\
\
This sorting method ensures stable pagination, reducing issues where cached responses may cause duplicate or missing tickers across pages.\
\
[](https://docs.coingecko.com/changelog#january-2025)\
\
January 2025\
\
[](https://docs.coingecko.com/changelog#multiple-improvements:-onchain-pools-page-limit,-trades-token-filter)\
\
Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 27, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-pools-data:-supports-more-than-10-pages-of-data)\
\
Onchain Pools Data: Supports more than 10 pages of data\
\
**Previously:** There was a limitation of a maximum of 10 pages for accessing pools data in the related endpoints.**Now:** All paid plan subscribers (Analyst & above) can access more than 10 pages of pools data for the endpoints below.**Improved Endpoints:**\
\
1. [Search Pools](https://docs.coingecko.com/reference/search-pools)\
\
2. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)\
\
3. [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)\
\
4. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)\
\
5. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)\
\
6. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list)\
\
7. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network)\
\
8. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-trades:-added-token-filter)\
\
Onchain Trades: Added Token Filter\
\
**Endpoint:** [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address)\
**Previously:** There was no way to filter trades data by base or quote token.**Now**: A new optional parameter has been added to allow filtering by base or quote token of a pool.\
\
* Parameter: `token`\
* Value options:\
* `base`\
* `quote`\
* `{token_address}`\
\
**Example**:\
\
Example\
\
Copy\
\
?token=base // get the trades data of base token\
?token=quote // get the trades data of quote token\
?token=8FqXr6dw5NHA2TtwFeDz6q9p7y9uWyoEdZmpXqqUpump // get the trades data of specific token based on address\
\
\
[](https://docs.coingecko.com/changelog#multiple-improvements:-onchain-token-price,-nft-market-cap)\
\
Multiple Improvements: Onchain Token Price, NFT Market Cap\
------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 24, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-simple-token-price:-added-market-cap-and-24h-volume-data)\
\
Onchain Simple Token Price: Added Market Cap and 24h Volume Data\
\
**Endpoint:** [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)\
\
* You can now flag `include_market_cap=true` and `include_24hr_vol=true` to retrieve market cap and 24h trading volume data. e.g.\
\
json\
\
Copy\
\
{\
"data": {\
"id": "e1979db1-5c3e-4ba8-b103-cb0258af4a7c",\
"type": "simple_token_price",\
"attributes": {\
"token_prices": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "0.999365729816931",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3399.24368371279"\
},\
"market_cap_usd": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "51963214441.24363",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10005535878.50094"\
},\
"h24_volume_usd": {\
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "2095689865.85327",\
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2544539948.02599"\
}\
}\
}\
}\
\
\
### \
\
[](https://docs.coingecko.com/changelog#nft-data:-added-%E2%80%98market-cap-rank%E2%80%99)\
\
NFT Data: Added ‘Market Cap Rank’\
\
You can now obtain the `market_cap_rank` data of NFT collections via the following endpoints:\
\
* [NFTs Collection Data by ID](https://docs.coingecko.com/reference/nfts-id)\
\
* [NFTs Collection Data by Contract Address](https://docs.coingecko.com/reference/nfts-contract-address)\
\
\
example\
\
Copy\
\
\
"market_cap_rank": 75,\
\
\
\
[](https://docs.coingecko.com/changelog#removal-of-unsupported-categories)\
\
Removal of Unsupported Categories\
----------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 23, 2025**\
\
### \
\
[](https://docs.coingecko.com/changelog#upcoming-removal-of-unsupported-categories-from-coingecko-and-coingecko-api)\
\
Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API\
\
We are announcing the removal of certain categories from CoinGecko and CoinGecko API. These categories will no longer be supported across all API endpoints starting **February 12, 2025**.\
\
| No | Category Name | Category ID |\
| --- | --- | --- |\
| 1 | US Election 2020 | us-election-2020 |\
| 2 | Governance | governance |\
| 3 | Cryptocurrency | cryptocurrency |\
| 4 | Technology and Science | technology-science |\
| 5 | Presale Meme | presale-meme-coins |\
| 6 | Business Platform | business-platform |\
| 7 | Number | number |\
| 8 | Structured Product | structured-products |\
| 9 | Investment | investment |\
| 10 | Niftex Shards | niftex-shards |\
| 11 | Ethereum POW IOU | ethereum-pow-iou |\
| 12 | Mirrored Assets | mirrored-assets |\
| 13 | Remittance | remittance |\
| 14 | Protocol | protocol |\
| 15 | Unicly Ecosystem | utokens |\
| 16 | Finance and Banking | finance-banking |\
| 17 | Eth 2.0 Staking | eth-2-0-staking |\
\
**Reason for Removal:**Many of these categories no longer have associated coins. Some categories are outdated and no longer relevant in the crypto space. The changes align with updated category topology standards to maintain data accuracy and relevance.**Impact:**API responses for the `/coins/markets` [endpoint](https://docs.coingecko.com/reference/coins-markets)\
will no longer support data of the categories above. Any requests specifying these categories will return an error.**Action Required:**Ensure applications using the `/coins/markets` [endpoint](https://docs.coingecko.com/reference/coins-markets)\
are not querying these removed categories. Please update any code or documentation referencing these categories to prevent errors.\
\
[](https://docs.coingecko.com/changelog#extended-historical-data-for-onchain-ohlcv-endpoint)\
\
Extended Historical Data for Onchain OHLCV Endpoint\
----------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 15, 2025**We’ve improved the [Pool OHLCV Chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)\
endpoint to provide access to a much broader range of historical data.**Key Updates**\
\
* **Previous Behavior:** Users could only query data for the past 6 months from today.\
* **New Behavior**: Users can now access data from September 2021 to the present, depending on the pool’s tracking start date on GeckoTerminal.\
* Each API request is **limited to a 6-month date range**, but users can query older data by using the before\_timestamp parameter.\
\
Note: access to data beyond the past 6 months is only available to [Paid Plan](https://www.coingecko.com/en/api/pricing)\
subscribers (Analyst plan & above).**Action Required**No changes are required for existing integrations. However, users who need data beyond the past 6 months should adjust their queries to use the `before_timestamp` parameter to fetch additional data.\
\
[](https://docs.coingecko.com/changelog#update-to-total-supply-of-pow-coins)\
\
Update to Total Supply of POW Coins\
--------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 15, 2025****What’s Changing?**We are updating the definition of Total Supply for PoW (Proof-of-Work) coins to reflect the actual number of mined coins rather than the maximum supply. This change ensures consistency and accuracy in representing the supply data.**Key Updates**\
\
* **Previous Behavior:**\
* Total Supply: Displayed as the maximum possible supply (e.g., Bitcoin: 21,000,000).\
* **New Behavior:**\
* Total Supply: Now reflects the actual number of mined coins. \
For example: Bitcoin: ~19,500,000 (as of January 2025).\
\
This update will also affect historical Total Supply data for consistency. This change applies to all affected PoW coins, including Bitcoin, Bitcoin Cash, Litecoin, Ethereum Classic, and more.**Affected endpoints** that contain “total\_supply” data:\
\
* **Current Data**\
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)\
\
* [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets)\
\
* **Historical Darta**\
* [Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart)\
\
* [Total Supply chart within time range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range)\
\
\
**Timeline:****Bitcoin:** Updated on Jan 14, 2025**Other PoW Coins**: Scheduled for Jan 22, 2025\
\
* [Bitcoin Cash](https://www.coingecko.com/en/coins/bitcoin-cash)\
\
* [Litecoin](https://www.coingecko.com/en/coins/litecoin)\
\
* [Ethereum Classic](https://www.coingecko.com/en/coins/ethereum-classic)\
\
* [Bitcoin SV](https://www.coingecko.com/en/coins/bitcoin-sv)\
\
* [Zcash](https://www.coingecko.com/en/coins/zcash)\
\
* [eCash](https://www.coingecko.com/en/coins/ecash)\
\
* [Dash](https://www.coingecko.com/en/coins/dash)\
\
* [Verus Coin](https://www.coingecko.com/en/coins/verus-coin)\
\
* [Ravencoin](https://www.coingecko.com/en/coins/ravencoin)\
\
* [Kadena](https://www.coingecko.com/en/coins/kadena)\
\
* [Decred](https://www.coingecko.com/en/coins/decred)\
\
* [Flux (Zelcash)](https://www.coingecko.com/en/coins/flux-zelcash)\
\
* [DigiByte](https://www.coingecko.com/en/coins/digibyte)\
\
* [Quantum Resistant Ledger](https://www.coingecko.com/en/coins/quantum-resistant-ledger)\
\
* [Komodo](https://www.coingecko.com/en/coins/komodo)\
\
* [Groestlcoin](https://www.coingecko.com/en/coins/groestlcoin)\
\
* [Firo](https://www.coingecko.com/en/coins/firo)\
\
* [Litecoin Cash](https://www.coingecko.com/en/coins/litecoin-cash)\
\
* [LuckyCoin](https://www.coingecko.com/en/coins/luckycoin)\
\
* [Enecuum](https://www.coingecko.com/en/coins/enecuum)\
\
* [Wownero](https://www.coingecko.com/en/coins/wownero)\
\
* [Radiant](https://www.coingecko.com/en/coins/radiant)\
\
* [Tidecoin](https://www.coingecko.com/en/coins/tidecoin)\
\
* [Handshake](https://www.coingecko.com/en/coins/handshake)\
\
* [Neoxa](https://www.coingecko.com/en/coins/neoxa)\
\
* [Vertcoin](https://www.coingecko.com/en/coins/vertcoin)\
\
* [Feathercoin](https://www.coingecko.com/en/coins/feathercoin)\
\
* [Bitcore](https://www.coingecko.com/en/coins/bitcore)\
\
* [Phoenixcoin](https://www.coingecko.com/en/coins/phoenixcoin)\
\
* [BitcoinZ](https://www.coingecko.com/en/coins/bitcoinz)\
\
* [Hush](https://www.coingecko.com/en/coins/hush)\
\
* [DigitalNote](https://www.coingecko.com/en/coins/digitalnote)\
\
* [EquityPay](https://www.coingecko.com/en/coins/equitypay)\
\
* [Evadore](https://www.coingecko.com/en/coins/evadore)\
\
* [Swap](https://www.coingecko.com/en/coins/swap)\
\
* [DeVault](https://www.coingecko.com/en/coins/devault)\
\
* [AXE](https://www.coingecko.com/en/coins/axe)\
\
* [Iridium](https://www.coingecko.com/en/coins/iridium)\
\
* [X-Cash](https://www.coingecko.com/en/coins/x-cash)\
\
* [Bolivarcoin](https://www.coingecko.com/en/coins/bolivarcoin)\
\
* [uPlexa](https://www.coingecko.com/en/coins/uplexa)\
\
* [WorldCoin (WDC)](https://www.coingecko.com/en/coins/worldcoin-wdc)\
\
\
[](https://docs.coingecko.com/changelog#improved-update-frequency-for-selected-pro-api-endpoints)\
\
Improved Update Frequency for selected Pro-API endpoints\
--------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 13, 2025**\[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing)\
only.\]The edge cache duration for the following endpoints are now reduced to 20-30s, allowing you to retrieve updated data more frequently.\
\
| Endpoints | Previous Update Frequency | Current Update Frequency |\
| --- | --- | --- |\
| CoinGecko [/simple/price](https://docs.coingecko.com/reference/simple-price) | 30s | 20s |\
| CoinGecko [/simple/token\_price](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s |\
| Onchain [/simple/networks/../token\_price](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s |\
| Onchain [/networks/../pools/../trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s |\
| Onchain [/networks/../pools/..](https://docs.coingecko.com/reference/pool-address) | 60s | 30s |\
| Onchain [/networks/../pools/multi/..](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s |\
\
**What This Means for You:**\
\
* **Fresher Data, Quicker**: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!\
* **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits charged—just like before.\
\
**Things to Keep in Mind:**\
\
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.\
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration.\
\
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#0c7f6363626d65674c6f6365626b696f6763226f6361)\
.**CoinGecko API Team**\
\
[](https://docs.coingecko.com/changelog#improved-5-minutely-data-for-historical-chart-data-endpoints)\
\
Improved 5-minutely data for Historical Chart Data endpoints\
----------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 09, 2025**For the following 4 historical chart endpoints, the data of the _last 48 hours from now_ is no longer excluded.\
\
* [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart)\
\
* [Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range)\
\
* [Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart)\
\
* [Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range)\
\
\
**Note:** The **5-minutely** and **hourly** interval params are exclusively available to Enterprise plan subscribers, bypassing auto-granularity:\
\
* `interval=5m`: 5-minutely historical data, supports up to any 10 days date range per request.\
* `interval=hourly`: hourly historical data, supports up to any 100 days date range per request.\
* **Data availability:**\
* `interval=5m`: Available from 9 February 2018 onwards\
* `interval=hourly`: Available from 30 Jan 2018 onwards\
\
For non-Enterprise plan subscribers who would like to get hourly data, please leave the `interval` params empty for auto granularity:\
\
* 1 day from current time = 5-minutely data\
* 1 day from any time (except current time) = hourly data\
* 2 - 90 days from any time = hourly data\
* above 90 days from any time = daily data (00:00 UTC)\
\
[](https://docs.coingecko.com/changelog#december-2024)\
\
December 2024\
\
[](https://docs.coingecko.com/changelog#added:-onchain-categories-data,-cg-data-improvements)\
\
Added: Onchain Categories Data, CG data improvements\
------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 24, 2024**\
\
### \
\
[](https://docs.coingecko.com/changelog#new:-onchain-categories-:-get-categories-on-geckoterminal-com)\
\
NEW: Onchain Categories : Get Categories on GeckoTerminal.com\
\
This new [Categories List](https://docs.coingecko.com/reference/categories-list)\
endpoint allows you to query all the categories supported on GeckoTerminal.com such as ‘Pump Fun’ and ‘Animal’.\
\
* This endpoint is exclusively available for [Analyst/Lite/Pro/Enterprise plan](https://www.coingecko.com/en/api/pricing)\
subscribers only.\
\
### \
\
[](https://docs.coingecko.com/changelog#new:-onchain-catergory-pools:-get-pools-of-a-specific-category)\
\
NEW: Onchain Catergory Pools: Get Pools of a specific Category\
\
This new [Pools by Category ID](https://docs.coingecko.com/reference/pools-category)\
endpoint allows you to query all the pools of a specific category on GeckoTerminal.com.\
\
* This endpoint is exclusively available for [Analyst/Lite/Pro/Enterprise plan](https://www.coingecko.com/en/api/pricing)\
subscribers only.\
* You can also obtain tokens of a specific category, by flagging `include=base_token`\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-token-info:-added-categories-data)\
\
Onchain Token Info: Added Categories Data\
\
You can now obtain the categories of a token via the following endpoints:\
\
1. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address)\
\
2. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
\
Payload example:\
\
json\
\
Copy\
\
"categories": [\
"Doge",\
"Baby",\
"Animal"\
],\
"gt_category_ids": [\
"doge",\
"baby",\
"animal"\
\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-new-pools-data:-bug-fixed)\
\
Onchain New Pools Data: Bug Fixed\
\
Previously, this [/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-network)\
endpoint omitted new pools that are created within the last 24 hours.It now returns all newly created pools in the last 48 hours.\
\
### \
\
[](https://docs.coingecko.com/changelog#coingecko-exchange-data:-added-support-of-inactive-exchange-id)\
\
CoinGecko Exchange Data: Added support of inactive exchange id\
\
You now query the the list of id of delisted exchanges with [Exchanges List (ID Map)](https://docs.coingecko.com/reference/exchanges-list)\
endpoint, by flagging `status=inactive` Payload example:\
\
json\
\
Copy\
\
{\
"id": "ftx",\
"name": "FTX (Derivatives)"\
},\
{\
"id": "ftx_spot",\
"name": "FTX"\
},\
{\
"id": "ftx_tr",\
"name": "FTX TR"\
},\
{\
"id": "ftx_us",\
"name": "FTX.US"\
},\
\
\
**Tips**: you may query to get historical volume delisted exchanges for via the following endpoints:\
\
* [Exchange Volume Chart by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart)\
\
* [Exchange Volume Chart within Time Range by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#coingecko-historical-chart-data:-faster-last-utc-day-00:00-data-update)\
\
CoinGecko Historical Chart Data: Faster Last UTC Day (00:00) Data Update\
\
For [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart)\
endpoint, the last completed UTC day (00:00) data is now available **10 minutes after midnight** on the next UTC day (00:10).Previously, the last completed UTC day (00:00) was only made available **35 minutes** after midnight.\
\
[](https://docs.coingecko.com/changelog#[updated:-q4-2024]-coingecko-asset-issuance-standardisation-initiative-updates)\
\
\[Updated: Q4 2024\] CoinGecko Asset Issuance Standardisation Initiative Updates\
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 17, 2024**As part of our commitment to improving data quality and enhancing the consistency of asset information, we are rolling out an asset standardization initiative at CoinGecko.**What is asset standardization?** \
Standardization involves refining how we classify and display assets. By systematically organizing asset listings into more precise categories - such as native, bridged, or wrapped tokens each following specific naming conventions, we aim to eliminate confusion and enhance data reliability.**What changes should I expect?** \
The most notable change is that non-native token contracts previously grouped under native asset listings will now be assigned their own distinct pages.For example, a bridged version of USDT that might have been aggregated under the original, native USDT page, will now be featured on a dedicated page specifically for that bridged variant.Additionally, there may be varying levels of changes in various aggregated data points of the standardized assets, including trading volume, supply, market cap rankings, etc., due to misplaced contracts being transitioned away from the original page to accurately reflect their true metrics.**Focus for Q3 2024** **\[Completed ✅\]**\
\
* [Wrapped Bitcoin (WBTC)](https://www.coingecko.com/en/coins/wrapped-bitcoin)\
\
* [Wrapped Ethereum (WETH)](https://www.coingecko.com/en/coins/weth)\
\
* [Dai (DAI)](https://www.coingecko.com/en/coins/dai)\
\
\
\*\*For full list of FAQs and updated infomation, please refer [here](https://support.coingecko.com/hc/en-us/articles/35555248857497-CoinGecko-Asset-Issuance-Standardisation-Initiative-Updates-and-FAQ)\
\
### \
\
[](https://docs.coingecko.com/changelog#what%E2%80%99s-new-in-q4-2024-%F0%9F%91%88)\
\
What’s New in Q4 2024? 👈\
\
Building on Q3’s achievements, we’re expanding the scope of Standardization to include four additional Coins this quarter, selected based on their significance and impact on the DeFi ecosystem.\
\
* [Frax (FRAX)](https://www.coingecko.com/en/coins/frax)\
\
* [Wrapped AVAX (WAVAX)](https://www.coingecko.com/en/coins/wrapped-avax)\
\
* [Wrapped BNB (WBNB)](https://www.coingecko.com/en/coins/wbnb)\
\
* [Wrapped stETH (wstETH)](https://www.coingecko.com/en/coins/wrapped-steth)\
\
\
### \
\
[](https://docs.coingecko.com/changelog#tips-and-faqs-for-api-users)\
\
Tips and FAQs for API users\
\
#### \
\
[](https://docs.coingecko.com/changelog#1-how-does-this-affect-my-current-api-setup)\
\
**1\. How does this affect my current API setup?**\
\
The following CoinGecko API endpoints will be impacted, with full details tracked in [this spreadsheet](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing)\
. We encourage you to make the necessary adjustments and enable edit notifications on the Google Sheets, to receive real-time updates when non-native token contracts have been successfully standardized.**Simple**\
\
* /simple/price\
* /simple/token\_price/id\
\
**Coins**\
\
* /coins/markets\
* /coins/id\
* /coins/id/tickers\
* /coins/id/history\
* /coins/id/market\_chart\
* /coins/id/market\_chart/range\
* /coins/id/ohlc\
* /coins/id/ohlc/range\
* /coins/id/circulating\_supply\_chart\
* /coins/id/circulating\_supply\_chart/range\
* /coins/id/total\_supply\_chart\
* /coins/id/total\_supply\_chart/range\
\
**Contract**\
\
* /coins/id/contract/contract\_address\
* /coins/id/contract/contract\_address/market\_chart\
* /coins/id/contract/contract\_address/market\_chart/range\
\
**Exchange**\
\
* /exchanges/id/tickers\
* /exchanges/id/volume\_chart\
* /exchanges/id/volume\_chart/range\
\
#### \
\
[](https://docs.coingecko.com/changelog#2-do-i-have-to-make-changes-to-my-api)\
\
**2\. Do I have to make changes to my API?**\
\
**No changes are necessary** if you do not need data for non-native token contracts that will be separated away from the native tokens.\
\
#### \
\
[](https://docs.coingecko.com/changelog#3-what-will-happen-to-the-coins-that-are-separated-into-a-new-coin-page)\
\
**3\. What will happen to the coins that are separated into a new coin page?**\
\
Historical data for new non-native or bridged assets will only be available from the date of asset page creation (i.e. stnadardized). To access historical data prior to the asset standardization, we recommend retrieving data from the original native assets.\
\
#### \
\
[](https://docs.coingecko.com/changelog#4-how-do-i-identify-the-list-of-coins-that-will-be-separated)\
\
**4\. How do I identify the list of coins that will be separated?**\
\
For a finalised list of token contracts and API IDs that have been separated from its native asset page and listed individually, please refer to this [Google Sheets](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing)\
You may also identify the list of bridged coins via API: you may also use [/categories/list endpoint](https://docs.coingecko.com/reference/coins-categories-list)\
to look for bridged categories such as:\
\
1. bridged-usdc\
2. bridged-wbtc\
3. bridged-weth\
\
Then you may use [/coins/market endpoint](https://docs.coingecko.com/reference/coins-markets)\
to retrieve the list of coins\
\
[](https://docs.coingecko.com/changelog#enhancing-your-access-to-even-fresher-data)\
\
Enhancing Your Access to Even Fresher Data!\
-----------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 16, 2024**\[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing)\
only.\]**Dear CoinGecko API paid plan subscribers,**We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, January 13, 2025**, the edge cache duration for the following endpoints will be reduced to 20-30s, allowing you to retrieve updated data more frequently.\
\
| Endpoints | Current Update Frequency | New Update Frequency |\
| --- | --- | --- |\
| CoinGecko [/simple/price](https://docs.coingecko.com/reference/simple-price) | 30s | 20s |\
| CoinGecko [/simple/token\_price](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s |\
| Onchain [/simple/networks/../token\_price](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s |\
| Onchain [/networks/../pools/../trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s |\
| Onchain [/networks/../pools/..](https://docs.coingecko.com/reference/pool-address) | 60s | 30s |\
| Onchain [/networks/../pools/multi/..](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s |\
\
**What This Means for You:**\
\
* **Fresher Data, Quicker**: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!\
* **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits charged—just like before.\
\
**Things to Keep in Mind:**\
\
* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.\
* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration.\
\
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#3b485454555a52507b585452555c5e58505415585456)\
.**CoinGecko API Team**\
\
[](https://docs.coingecko.com/changelog#multiple-improvements:-onchain-trending-pools,-cg-new-currencies-support,-snapshot,-exchange-info)\
\
Multiple Improvements: Onchain Trending Pools, CG New Currencies Support, Snapshot, Exchange Info\
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 15, 2024**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain-trending-pools:-added-support-to-filter-by-duration)\
\
Onchain Trending Pools: Added Support to Filter by Duration\
\
You can now query trending pools with the following endpoints, and filter them by different duration: 5m, 1h, 6h, 24h, using `duration` parameter. e.g. `duration=5m`\
\
* [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)\
: query all the trending pools across all networks on GeckoTerminal\
* [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)\
: query the trending pools based on the provided network\
\
### \
\
[](https://docs.coingecko.com/changelog#cg-coin-prices:-added-support-for-new-fiat-currencies)\
\
CG Coin Prices: Added Support for New Fiat Currencies\
\
You can now query coin prices in the 13 new currencies for the following 3 endpoints:\
\
* [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)\
: query latest price in selected currencies, by coin id\
* [Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price)\
: query latest price in selected currencies, by token address\
* [BTC-to-Currency Exchange Rates](https://docs.coingecko.com/reference/exchange-rates)\
: query BTC exchange rates with other currencies\
\
**New supported currencies:**\
\
1. Colombia | COP\
2. Kenya | KES\
3. Romania | RON\
4. Dominican Republic | DOP\
5. Costa Rica | CRC\
6. Honduras | HNL\
7. Zambia | ZMW\
8. El Salvador | SVC\
9. Bosnia and Herzegovina | BAM\
10. Peru | PEN\
11. Guatemala | GTQ\
12. Lebanon | LBP\
13. Armenian Dram | AMD\
\
### \
\
[](https://docs.coingecko.com/changelog#cg-coin-info:-included-snapshot-url)\
\
CG Coin Info: Included Snapshot URL\
\
[Coin Data by ID](https://docs.coingecko.com/reference/coins-id)\
now includes Snapshot link, e.g.\
\
json\
\
Copy\
\
"snapshot_url": "https://snapshot.org/#/lido-snapshot.eth",\
\
\
### \
\
[](https://docs.coingecko.com/changelog#cg-exchange-info:-included-number-of-coins-and-pairs)\
\
CG Exchange Info: Included Number of Coins and Pairs\
\
[https://docs.coingecko.com/reference/exchanges-id](https://docs.coingecko.com/reference/exchanges-id)\
now includes “coins” and “pairs”, e.g.\
\
json\
\
Copy\
\
"coins": 384,\
"pairs": 1281,\
\
\
[](https://docs.coingecko.com/changelog#october-2024)\
\
October 2024\
\
[](https://docs.coingecko.com/changelog#multiple-improvements:-onchain-simple-price,-onchain-recently-updated-info,-nft-collection-data)\
\
Multiple Improvements: Onchain Simple Price, Onchain Recently Updated Info, NFT Collection Data\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **October 09, 2024**\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain:-simple-price-increased-token-address-limit-from-30-to-100)\
\
Onchain: Simple Price - Increased Token Address Limit from 30 to 100\
\
[Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)\
now allows to input up to 100 contract addresses, instead of 30.\
\
* You may now retrieve data of up to 100 token prices of a specific network, in one single request.\
* Available exclusively to Pro API paid plan subscribers.\
\
### \
\
[](https://docs.coingecko.com/changelog#onchain:-recently-updated-info-added-filter-by-network)\
\
Onchain: Recently Updated Info - Added Filter by Network\
\
[Most Recently Updated Token List](https://docs.coingecko.com/reference/tokens-info-recent-updated)\
now allows to filter by blockchain network, by flagging the `network` parameter. e.g. `network=eth`.\
\
* You can use the `network` parameter to retrieve the 100 most recently updated token info of a specific network.\
* View list of supported network via [Supported Networks List](https://docs.coingecko.com/reference/networks-list)\
endpoint.\
\
### \
\
[](https://docs.coingecko.com/changelog#nft-collection-data-included-banner-image)\
\
NFT Collection Data - Included Banner Image\
\
[NFTs Collection Data by ID](https://docs.coingecko.com/reference/nfts-id)\
now provides banner image of a NFT collection.View banner image [example](https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.png?1708416126)\
on: [https://www.coingecko.com/en/nft/pudgy-penguins](https://www.coingecko.com/en/nft/pudgy-penguins)\
\
Copy\
\
{\
"symbol": "PPG",\
"image": {\
"small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/da64989d9762c8a61b3c65917edfdf97.png?1707287183"\
},\
"banner_image": "https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.png?1708416126",\
..\
\
\
[](https://docs.coingecko.com/changelog#september-2024)\
\
September 2024\
\
[](https://docs.coingecko.com/changelog#multiple-improvements:-global-market-chart,-asset-platforms,-coin-categories,-historical-supply-chart)\
\
Multiple Improvements: Global Market Chart, Asset Platforms, Coin Categories, Historical Supply Chart\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **September 26, 2024**\
\
### \
\
[](https://docs.coingecko.com/changelog#global-market-chart-improved-daily-data-update)\
\
Global Market Chart - Improved Daily Data Update\
\
Previously, for [Global Market Cap Chart Data endpoint](https://docs.coingecko.com/reference/global-market-cap-chart)\
, the daily data is returned at 23:00 UTC. We’ve made improvement to return daily data at 00:00 UTC.The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). The cache will **always expire at 00:05 UTC**. If you wish to get the latest daily data (00:00 UTC), you can make request at 00:05 UTC or later.\
\
### \
\
[](https://docs.coingecko.com/changelog#asset-platforms-included-images-of-blockchain-network-logos)\
\
Asset Platforms - Included Images of Blockchain Network Logos\
\
[Asset Platforms List (ID Map)](https://docs.coingecko.com/reference/asset-platforms-list)\
now provides the logos of blockchain networks.For example:\
\
Copy\
\
"image": {\
"thumb": "https://coin-images.coingecko.com/asset_platforms/images/93/thumb/AN_logomark.png?1706606703",\
"small": "https://coin-images.coingecko.com/asset_platforms/images/93/small/AN_logomark.png?1706606703",\
"large": "https://coin-images.coingecko.com/asset_platforms/images/93/large/AN_logomark.png?1706606703"\
}\
\
\
### \
\
[](https://docs.coingecko.com/changelog#coins-categories-included-ids-of-top-3-coins)\
\
Coins Categories - Included Ids of Top 3 Coins\
\
[Coins Categories List with Market Data](https://docs.coingecko.com/reference/coins-categories)\
now provides coins id of the top 3 coins of a category.For example:\
\
Copy\
\
"top_3_coins_id": [\
"bitcoin",\
"ethereum",\
"binancecoin"\
],\
\
\
### \
\
[](https://docs.coingecko.com/changelog#circulating-supply-chart-and-total-supply-chart-fixed-%E2%80%980%E2%80%99-data-issue)\
\
Circulating Supply Chart and Total Supply Chart - Fixed ‘0’ data issue\
\
For the following **Enterprise-plan** exclusive endpoints below, there was a bug that returned wrong ‘0’ value in the payload. This is fixed and will no longer return wrong ‘0’ value in the payload.\
\
1. [👑 Circulating Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart)\
\
2. [👑 Circulating Supply chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range)\
\
3. [👑 Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart)\
\
4. [👑 Total Supply Chart within time range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range)\
\
\
[](https://docs.coingecko.com/changelog#improvement-of-update-frequency-for-ohlc-endpoints)\
\
Improvement of update frequency for OHLC endpoints\
--------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **September 04, 2024**The cache & update frequency of the following endpoints have been improved from every 30 minutes to every 15 minutes:\
\
* [/coins//ohlc](https://docs.coingecko.com/reference/coins-id-ohlc)\
\
* [/coins//ohlc/range](https://docs.coingecko.com/reference/coins-id-ohlc-range)\
\
\
[](https://docs.coingecko.com/changelog#august-2024)\
\
August 2024\
\
[](https://docs.coingecko.com/changelog#included-new-fields-nft-data)\
\
Included new fields - NFT data\
--------------------------------------------------------------------------------------------------------\
\
🗓️ **August 18, 2024**We’ve added ‘user\_favorites\_count’, and ‘ath’ (all-time-high) related data to the following NFT endpoints:\
\
* [/nfts/](https://docs.coingecko.com/reference/nfts-id)\
\
* [/nfts//contract/](https://docs.coingecko.com/reference/nfts-contract-address)\
\
\
**Example of responses:**\
\
Copy\
\
{\
"user_favorites_count": 3660,\
"ath": {\
"native_currency": 22.9,\
"usd": 67535\
},\
"ath_change_percentage": {\
"native_currency": -59.825327510917,\
"usd": -64.3396788440525\
},\
"ath_date": {\
"native_currency": "2024-02-17T09:25:05.056Z",\
"usd": "2024-02-29T11:45:08.150Z"\
}\
\
\
[](https://docs.coingecko.com/changelog#may-2024)\
\
May 2024\
\
[](https://docs.coingecko.com/changelog#introduced-/coins/id/ohlc/range-endpoint)\
\
Introduced /coins/id/ohlc/range endpoint\
------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 10, 2024**We’ve introduced a new endpoint [/coins//ohlc/range](https://docs.coingecko.com/reference/coins-id-ohlc-range)\
.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.Please note that this endpoint is available exclusively for **paid plan subscribers only**.\
\
[](https://docs.coingecko.com/changelog#added-interval-hourly-params-to-/coins/id/ohlc)\
\
Added interval hourly params to /coins/id/ohlc\
------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 04, 2024**We’ve expanded functionality to include support for the `interval=hourly` parameter within the [/coins//ohlc](https://docs.coingecko.com/reference/coins-id-ohlc)\
endpoint.Users can use this parameter to retrieve OHLC (Open/High/Low/Close) data on a hourly interval for up to 90 days of the date range.Example of endpoint request:`https://pro-api.coingecko.com/api/v3/coins/bitcoin/ohlc?vs_currency=usd&days=1&interval=hourly&x_cg_pro_api_key=YOUR_API_KEY`\
\
[](https://docs.coingecko.com/changelog#april-2024)\
\
April 2024\
\
[](https://docs.coingecko.com/changelog#added-support-for-inactive-coins-in-/coins/list-and-historical-data-endpoints)\
\
Added support for inactive coins in /coins/list and historical data endpoints\
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **April 30, 2024**We’ve now enhanced the [/coins/list](https://docs.coingecko.com/reference/coins-list)\
endpoint to include inactive coins\
\
* You may access the inactive coins by specifying `status=inactive` in your query\
* Example of endpoint request: \
`https://pro-api.coingecko.com/api/v3/coins/list?include_platform=false&status=inactive&x_cg_pro_api_key=YOUR_API_KEY`\
\
Additionally, historical data for inactive coins can be queried using their IDs in the following endpoints:\
\
* [/coins//history](https://docs.coingecko.com/reference/coins-id-history)\
\
* [/coins//market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)\
\
* [/coins//market\_chart/range](https://docs.coingecko.com/reference/coins-id-market-chart-range)\
\
* [/coins//contract//market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart)\
\
* [/coins//contract//market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range)\
\
\
Please note that these features are available exclusively for **paid plan subscribers only**\
\
[](https://docs.coingecko.com/changelog#march-2024)\
\
March 2024\
\
[](https://docs.coingecko.com/changelog#introduced-/key-endpoint)\
\
Introduced /key endpoint\
----------------------------------------------------------------------------------------------\
\
🗓️ **March 27, 2024**We’ve introduced a new endpoint [/key](https://docs.coingecko.com/reference/api-usage)\
for conveniently monitoring your account’s API usage, including rate limits and remaining credits.**Example of responses**:\
\
Copy\
\
{\
"plan": "Other",\
"rate_limit_request_per_minute": 1000,\
"monthly_call_credit": 1000000,\
"current_total_monthly_calls": 307,\
"current_remaining_monthly_calls": 999693\
}\
\
\
[](https://docs.coingecko.com/changelog#february-2024)\
\
February 2024\
\
[](https://docs.coingecko.com/changelog#multiple-improvements-onchain/gt)\
\
Multiple Improvements (Onchain/GT)\
----------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 28, 2024**\
\
* image\_url is now returned in the token response for pools and tokens endpoints: Example of responses:\
\
JSON\
\
Copy\
\
"data": {\
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",\
"type": "token",\
"attributes": {\
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\
"name": "Tether USD",\
"symbol": "USDT",\
"image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", 👈\
......\
"market_cap_usd": "100719721661.467"\
},\
"relationships": {}\
}\
\
\
* We’ve added sorting parameters such as order= `h24_volume_usd_desc` and order= `h24_tx_count_desc` for /pools endpoints\
* The ‘token’ parameter within the [/ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)\
endpoint can now accept a token address, provided it exists in the queried pool, to return OHLCV data \
Example of endpoint request (**token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2**): \
`https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/day?token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&x_cg_pro_api_key=YOUR_API_KEY`\
* [/ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)\
endpoint now includes the base and target token metadata in the response \
Example of responses:\
\
JSON\
\
Copy\
\
{\
"data": {\
"id": "46303eb4-fba1-44f3-a3c8-c542e4cd5d1a",\
"type": "ohlcv_request_response",\
"attributes": {\
"ohlcv_list": []\
}\
},\
"meta": {\
"base": {\
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\
"name": "Tether USD",\
"symbol": "USDT",\
"coingecko_coin_id": "tether"\
},\
"quote": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"coingecko_coin_id": "weth"\
}\
}\
}\
\
\
\
[](https://docs.coingecko.com/changelog#introduced-/networks/network/trending-pools-endpoint-onchain/gt)\
\
Introduced /networks/network/trending\_pools endpoint (Onchain/GT)\
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 19, 2024**Trending Pools endpoint, [/networks//trending\_pools](https://docs.coingecko.com/reference/trending-pools-network)\
is now available to fetch a list of pools that are trending as seen on GeckoTerminal based on web visits and on-chain activities.\
\
[](https://docs.coingecko.com/changelog#introduced-/search/pools-endpoint-onchain/gt)\
\
Introduced /search/pools endpoint (Onchain/GT)\
----------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 19, 2024**Added new endpoint to search for pools /search/pools based on keywords passed into query.\
\
[](https://docs.coingecko.com/changelog#january-2024)\
\
January 2024\
\
[](https://docs.coingecko.com/changelog#included-new-field-for-/coins/id-endpoint)\
\
Included new field for /coins/id endpoint\
--------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 18, 2024**We’ve included a new field “whitepaper” under “links” section for [/coins/](https://docs.coingecko.com/reference/coins-id)\
endpoint**Example of responses:**\
\
Copy\
\
{\
"id": "bitcoin",\
......\
"links": {\
"homepage": [],\
"whitepaper": "https://bitcoin.org/bitcoin.pdf", 👈\
"blockchain_site": [],\
"official_forum_url": [],\
"chat_url": [],\
"announcement_url": [],\
"twitter_screen_name": "bitcoin",\
"facebook_username": "bitcoins",\
"bitcointalk_thread_identifier": null,\
"telegram_channel_identifier": "",\
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",\
"repos_url": {}\
},\
.......\
}\
\
\
[](https://docs.coingecko.com/changelog#december-2023)\
\
December 2023\
\
[](https://docs.coingecko.com/changelog#deprecated-response-fields-for-/coins/id)\
\
Deprecated response fields for /coins/id\
------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 13, 2023**The following data is now deprecated for [/coins/](https://docs.coingecko.com/reference/coins-id)\
endpoint:\
\
* coingecko\_rank\
* coingecko\_score\
* developer\_score\
* community\_score\
* liquidity\_score\
* public\_interest\_score\
* public\_interest\_stats\
* alexa\_rank\
* bing\_matches\
\
[](https://docs.coingecko.com/changelog#introduced-new-historical-total-supply-endpoints)\
\
Introduced new historical total supply endpoints\
----------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 12, 2023**We’ve introduced Historical Total Supply data to Enterprise plan subscribers via these 2 exclusive endpoints:\
\
* [/coins//total\_supply\_chart](https://docs.coingecko.com/reference/coins-id-total-supply-chart)\
: get historical total supply of a coin, by number of days away from now.\
* [/coins//total\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range)\
: get historical total supply of a coin, within a range of timestamp.\
\
[](https://docs.coingecko.com/changelog#included-more-trending-coins)\
\
Included more trending coins\
------------------------------------------------------------------------------------------------------\
\
🗓️ **December 07, 2023**We’ve expanded the capabilities of the [/search/trending](https://docs.coingecko.com/reference/trending-search)\
endpoint.It now supports up to 15 trending coins, a significant increase from the previous limit of 7.\
\
[](https://docs.coingecko.com/changelog#improvement-on-pool-data-onchain/gt)\
\
Improvement on pool data (Onchain/GT)\
----------------------------------------------------------------------------------------------------------------------\
\
🗓️ **December 03, 2023**Pool data now returns transaction stats for the last 1 hour. Unique buyers and sellers in the last 1 hour and 24 hours are now returned in the response\
\
[](https://docs.coingecko.com/changelog#november-2023)\
\
November 2023\
\
[](https://docs.coingecko.com/changelog#multiple-improvements)\
\
Multiple Improvements\
----------------------------------------------------------------------------------------\
\
🗓️ **November 21, 2023**The web\_slug data is now available in the following endpoints.\
\
* [/coins/](https://docs.coingecko.com/reference/coins-id)\
\
* [/coins//contract/](https://docs.coingecko.com/reference/coins-contract-address)\
\
\
This addition allows users to accurately link to a CoinGecko coin page using [www.coingecko.com/en/](http://www.coingecko.com/en/%7Bweb_slug%7D)\
.**Example of responses:**\
\
JSON\
\
Copy\
\
{\
"id": "bitcoin",\
"symbol": "btc",\
"name": "Bitcoin",\
"web_slug": "bitcoin", 👈\
......\
"tickers": [...]\
}\
\
\
For the [/asset\_platforms](https://docs.coingecko.com/reference/asset-platforms-list)\
endpoint, we’ve introduced the native\_coin\_id data. This enables users to obtain the coin ID of different blockchain networks or asset platforms that may not have a contract address to look up**Example of responses:**\
\
JSON\
\
Copy\
\
{\
"id": "polygon-pos",\
"chain_identifier": 137,\
"name": "Polygon POS",\
"shortname": "MATIC", \
"native_coin_id": "matic-network" 👈\
},\
\
\
[](https://docs.coingecko.com/changelog#introduced-/simple/networks/network/token-price/addresses-endpoint-onchain/gt)\
\
Introduced /simple/networks/network/token\_price/addresses endpoint (Onchain/GT)\
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **November 10, 2023**Inspired by CoinGecko API most popular endpoint, we have launched the [/simple/networks//token\_price/](https://docs.coingecko.com/reference/onchain-simple-price)\
, simple endpoint. Simply pass in addresses of any tokens on supported blockchain and get price data for it\
\
[](https://docs.coingecko.com/changelog#introduced-/networks/network/pools/pool-address/trades-endpoint-onchain/gt)\
\
Introduced /networks/network/pools/pool\_address/trades endpoint (Onchain/GT)\
-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **November 08, 2023**You can now get the latest 300 trades in the past 24 hours of a given pool from this endpoint [/networks//pools//trades](https://docs.coingecko.com/reference/pool-trades-contract-address)\
. You may optionally filter by trade size as well. You can now build your own telegram bot alert!\
\
[](https://docs.coingecko.com/changelog#october-2023)\
\
October 2023\
\
[](https://docs.coingecko.com/changelog#introduced-new-endpoints-onchain/gt)\
\
Introduced new endpoints (Onchain/GT)\
----------------------------------------------------------------------------------------------------------------------\
\
🗓️ **October 23, 2023**You can now fetch token information such as name, image, social links, and description via these endpoints:\
\
* To fetch information of tokens inside a pool, use [/networks//pools//info](https://docs.coingecko.com/reference/pool-token-info-contract-address)\
\
* To fetch information of a specific token use [/networks//tokens//info](https://docs.coingecko.com/reference/token-info-contract-address)\
\
* If you like to get token information of the most recently updated tokens, use [/tokens/info\_recently\_updated](https://docs.coingecko.com/reference/tokens-info-recent-updated)\
\
\
[](https://docs.coingecko.com/changelog#september-2023)\
\
September 2023\
\
[](https://docs.coingecko.com/changelog#included-new-fields-onchain/gt)\
\
Included new fields (Onchain/GT)\
------------------------------------------------------------------------------------------------------------\
\
🗓️ **September 11, 2023**Pool response data now returns price in the base and quote token of the pool base\_token\_price\_quote\_token and quote\_token\_price\_base\_token for your convenience without the need to do additional calculation to derive these values\
\
[](https://docs.coingecko.com/changelog#introduced-new-endpoints-onchain/gt-2)\
\
Introduced new endpoints (Onchain/GT)\
------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **September 06, 2023**Added new endpoints to allow querying multiple pools and tokens in a single API call. /networks/network/pools/multi/addresses and /networks/network/tokens/multi/addresses\
\
[](https://docs.coingecko.com/changelog#june-2023)\
\
June 2023\
\
[](https://docs.coingecko.com/changelog#included-new-fields-onchain/gt-2)\
\
Included new fields (Onchain/GT)\
--------------------------------------------------------------------------------------------------------------\
\
🗓️ **June 23, 2023**\
\
* More data added to the Pool response such as FDV, market cap (from CoinGecko if available), price change percentage, volume, number of buy/sell transactions\
* More data added when querying for token such as FDV, volume, market cap, and the top 3 pools\
\
[](https://docs.coingecko.com/changelog#introduced-precision-params-for-other-endpoints)\
\
Introduced precision params for other endpoints\
--------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **June 15, 2023**The uses of ‘precision’ parameter allows to specify price data in full or 0-18 decimals, and previously was only made available for [/simple/price](https://docs.coingecko.com/reference/simple-price)\
and [/simple/token\_price/](https://docs.coingecko.com/reference/simple-token-price)\
endpoints.This parameter is now supported for more endpoints as listed below:\
\
* [/coins/markets](https://docs.coingecko.com/reference/coins-markets)\
\
* [/coins/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)\
\
* [/coins/market\_chart/range](https://docs.coingecko.com/reference/coins-id-market-chart)\
\
* [/coins//contract//market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart)\
\
* [/coins//contract//market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range)\
\
* [/coins//ohlc](https://docs.coingecko.com/reference/coins-id-ohlc)\
\
\
[](https://docs.coingecko.com/changelog#multiple-improvements-2)\
\
Multiple Improvements\
------------------------------------------------------------------------------------------\
\
🗓️ **June 01, 2023**We’ve made enhancements to the /search/trending and /coins/asset\_platform\_id/contract/contract\_address endpoints:\
\
* Top 5 trending NFT data (based on high trading volume in the last 24 hours) is now included in the [/search/trending](https://docs.coingecko.com/reference/trending-search)\
endpoint\
* Near Protocol contract address (e.g. wrap.near) is now supported for [/coins//contract/](https://docs.coingecko.com/reference/coins-contract-address)\
endpoint\
\
[](https://docs.coingecko.com/changelog#may-2023)\
\
May 2023\
\
[](https://docs.coingecko.com/changelog#multiple-improvements-onchain/gt-2)\
\
Multiple Improvements (Onchain/GT)\
------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 28, 2023**\
\
* Token metadata such as name, symbol, and CoinGecko ID are now returned in the responses for pools endpoints. Users will need to pass in this attribute include=base\_token, quote\_token\
* CoinGecko asset platform ID added to the response for [/networks](https://docs.coingecko.com/reference/networks-list)\
endpoint\
\
[](https://docs.coingecko.com/changelog#added-interval-daily-params-to-/coins/id/ohlc)\
\
Added interval daily params to /coins/id/ohlc\
----------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **May 22, 2023**The [/coins//ohlc](https://docs.coingecko.com/reference/coins-id-ohlc)\
endpoint now supports the “interval=daily” parameter for Paid Plan SubscribersUsers can use this parameter to retrieve OHLC (Open/High/Low/Close) data on a daily interval for up to 180 days of date range.\
\
[](https://docs.coingecko.com/changelog#april-2023)\
\
April 2023\
\
[](https://docs.coingecko.com/changelog#included-new-fields)\
\
Included new fields\
------------------------------------------------------------------------------------\
\
🗓️ **April 26, 2023**We’ve added ‘watchlist\_portfolio\_users’ field to [/coins/](https://docs.coingecko.com/reference/coins-id)\
endpoint responses.This refers to number of users who added the coin into a watchlist or portfolio.**Example of responses:**\
\
JSON\
\
Copy\
\
{\
"id": "bitcoin",\
......\
"watchlist_portfolio_users": 1449601, 👈\
"market_cap_rank": 1,\
......\
"tickers": []\
}\
\
\
[](https://docs.coingecko.com/changelog#increased-rate-limit-onchain/gt)\
\
Increased Rate Limit (Onchain/GT)\
--------------------------------------------------------------------------------------------------------------\
\
🗓️ **April 19, 2023**We’ve increased the rate limit of Public Plan from 10 calls per minute to 30 calls per minute\
\
[](https://docs.coingecko.com/changelog#multiple-improvements-onchain/gt-3)\
\
Multiple Improvements (Onchain/GT)\
------------------------------------------------------------------------------------------------------------------\
\
🗓️ **April 18, 2023**\
\
* base\_token\_native\_currency and quote\_token\_native\_currency added to the pools endpoint response. This allows you to obtain price in the network’s native currency in addition to in USD\
* reserve\_in\_usd added to the pools endpoint response. This returns the total liquidity/reserve of the pool in USD\
* pool\_created\_at added to the pools endpoint response\
\
Example of responses for [/networks//pools/](https://docs.coingecko.com/reference/pool-address)\
:\
\
Copy\
\
{\
"data": {\
"id": "eth_0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "0.0000186523882966482",\
"base_token_price_native_currency": "0.00000000647822280242372", 👈\
"quote_token_price_usd": "2881.71870575097",\
"quote_token_price_native_currency": "1.0", 👈\
"base_token_price_quote_token": "0.000000006478222802",\
"quote_token_price_base_token": "154363323",\
"address": "0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f",\
"name": "DGX-1 / WETH",\
"pool_created_at": "2024-02-18T08:10:59Z", 👈\
"fdv_usd": "784687",\
"market_cap_usd": null,\
"price_change_percentage": {\
"h1": "34.67",\
"h24": "8406.81"\
},\
"transactions": {},\
"volume_usd": {},\
"reserve_in_usd": "110214.6247" 👈\
},\
"relationships": {}\
}\
}\
\
\
* [/networks//new\_pools](https://docs.coingecko.com/reference/latest-pools-network)\
endpoint added to query new pools discovered for a network\
* [/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list)\
endpoint added to query new pools discovered across all networks\
\
[](https://docs.coingecko.com/changelog#included-new-fields-2)\
\
Included new fields\
--------------------------------------------------------------------------------------\
\
🗓️ **April 03, 2023**We’ve added “symbol” field to these NFT endpoints responses:\
\
* [/nfts/markets](https://docs.coingecko.com/reference/nfts-markets)\
\
* [/nfts/](https://docs.coingecko.com/reference/nfts-id)\
\
* [/nfts//contract/](https://docs.coingecko.com/reference/nfts-contract-address)\
\
\
**Example of responses:**\
\
JSON\
\
Copy\
\
{\
"id": "pudgy-penguins",\
"contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",\
"asset_platform_id": "ethereum",\
"name": "Pudgy Penguins",\
"symbol": "PPG", 👈\
....\
},\
\
\
[](https://docs.coingecko.com/changelog#march-2023)\
\
March 2023\
\
[](https://docs.coingecko.com/changelog#included-new-fields-3)\
\
Included new fields\
--------------------------------------------------------------------------------------\
\
🗓️ **March 27, 2023**We’ve added “links” field (e.g. homepage, twitter, discord) to these NFT endpoints responses:\
\
* [/nfts/](https://docs.coingecko.com/reference/nfts-id)\
\
* [/nfts//contract/](https://docs.coingecko.com/reference/nfts-contract-address)\
\
\
**Example of responses:**\
\
Copy\
\
{\
"id": "pudgy-penguins",\
"contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",\
.......\
"links": {\
"homepage": "https://www.pudgypenguins.com/", 👈\
"twitter": "https://twitter.com/pudgypenguins",👈\
"discord": "https://discord.gg/pudgypenguins" 👈\
},\
.......\
}\
\
\
[](https://docs.coingecko.com/changelog#introduced-/coins/top-gainer-losers-endpoint)\
\
Introduced /coins/top\_gainer\_losers endpoint\
----------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **March 23, 2023**We’ve added [/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)\
endpoint exclusively for Paid Plan Subscribers.Users can now get the top 30 coins with largest price gain and loss by a specific time duration with this endpoint.\
\
[](https://docs.coingecko.com/changelog#improved-ohlcv-endpoint-onchain/gt)\
\
Improved OHLCV endpoint (Onchain/GT)\
--------------------------------------------------------------------------------------------------------------------\
\
🗓️ **March 23, 2023**[/networks//pools//ohlcv/](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)\
now returns more granularity `day,` `hour`, `minute` and multiple aggregates\
\
[](https://docs.coingecko.com/changelog#february-2023)\
\
February 2023\
\
[](https://docs.coingecko.com/changelog#multiple-improvements-3)\
\
Multiple Improvements\
------------------------------------------------------------------------------------------\
\
🗓️ **February 23, 2023**We’ve made some updates to the /coins/categories and /simple/token\_price/id endpoints:\
\
* Market cap and volume data for ‘ecosystem’ categories in the [/coins/categories](https://docs.coingecko.com/reference/coins-categories)\
endpoint will now return ‘null’ until further notice. The CoinGecko team is actively working on improvements to provide more accurate data. If you have any feedback or suggestions, please reach out via [\[email protected\]](https://docs.coingecko.com/cdn-cgi/l/email-protection#6203120b22010d0b0c050701090d4c010d0f)\
.\
* Previously, the [/simple/token\_price/](https://docs.coingecko.com/reference/simple-token-price)\
endpoint was unable to return data for some Solana coins. This issue has been resolved, and users can now expect accurate data for Solana coins from this endpoint.\
\
[](https://docs.coingecko.com/changelog#introduced-/exchange/id/volume-chart/range-endpoint)\
\
Introduced /exchange/id/volume\_chart/range endpoint\
-----------------------------------------------------------------------------------------------------------------------------------------------------\
\
🗓️ **February 15, 2023**We’ve introduced the [/exchange//volume\_chart/range](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range)\
endpoint for Paid Plan Subscribers.This exclusive feature allows users to query full historical volume data of an exchange.\
\
[](https://docs.coingecko.com/changelog#january-2023)\
\
January 2023\
\
[](https://docs.coingecko.com/changelog#introduced-/coins/list/new-endpoint)\
\
Introduced /coins/list/new endpoint\
--------------------------------------------------------------------------------------------------------------------\
\
🗓️ **January 09, 2023**We’ve introduced the [/coins/list/new](https://docs.coingecko.com/reference/coins-list-new)\
endpoint for Paid Plan Subscribers.This exclusive feature allows users to query the latest 200 coins on CoinGecko.\
\
Was this page helpful?\
\
YesNo\
\
⌘I
---
# Check API server status - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/ping-server#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Ping
Check API server status
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Check API server status
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/ping \
--header 'x-cg-pro-api-key: '
200
Copy
{
"gecko_says": "(V3) To the Moon!"
}
GET
/
ping
Try it
Check API server status
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/ping \
--header 'x-cg-pro-api-key: '
200
Copy
{
"gecko_says": "(V3) To the Moon!"
}
###
[](https://docs.coingecko.com/reference/ping-server#note)
Note
* You can also go to [status.coingecko.com](https://status.coingecko.com/)
to check the API server status and further maintenance notices.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/ping-server#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
Status OK
[](https://docs.coingecko.com/reference/ping-server#response-gecko-says)
gecko\_says
string
Was this page helpful?
YesNo
[Endpoint Overview](https://docs.coingecko.com/reference/endpoint-overview)
[💼 API Usage](https://docs.coingecko.com/reference/api-usage)
⌘I
---
# Token Price by Token Addresses - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/onchain-simple-price#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Simple
Token Price by Token Addresses
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Token Price by Token Addresses
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/simple/networks/{network}/token_price/{addresses} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
"type": "simple_token_price",
"attributes": {
"token_prices": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2289.33"
},
"market_cap_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "6692452895.779648"
},
"h24_volume_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "965988358.733808"
},
"h24_price_change_percentage": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3.3870290336"
},
"total_reserve_in_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
},
"last_trade_timestamp": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
}
}
}
}
GET
/
simple
/
networks
/
{network}
/
token\_price
/
{addresses}
Try it
Token Price by Token Addresses
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/simple/networks/{network}/token_price/{addresses} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "1ba898f0-eda2-4291-9491-9a5b323f66ef",
"type": "simple_token_price",
"attributes": {
"token_prices": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2289.33"
},
"market_cap_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "6692452895.779648"
},
"h24_volume_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "965988358.733808"
},
"h24_price_change_percentage": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3.3870290336"
},
"total_reserve_in_usd": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208"
},
"last_trade_timestamp": {
"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
}
}
}
}
###
[](https://docs.coingecko.com/reference/onchain-simple-price#note)
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](https://www.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 100 contract addresses** per request. This limit is exclusive for [paid plan](https://www.coingecko.com/en/api/pricing)
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}`](https://docs.coingecko.com/reference/pool-address)
endpoint by providing a specific pool address.
* If `include_inactive_source=true` is set and no top pool is found for a token, the search will expand to include recently active pools up to the past 1 year.
* Cache/Update Frequency: Real-time (Cacheless) for Pro API (Basic, Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/onchain-simple-price#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-addresses)
addresses
string
default:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
required
token contract address, comma-separated if more than one token contract address
#### Query Parameters
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-include-market-cap)
include\_market\_cap
boolean
include market capitalization, default: false
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-mcap-fdv-fallback)
mcap\_fdv\_fallback
boolean
return FDV if market cap is not available, default: false
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-include-24hr-vol)
include\_24hr\_vol
boolean
include 24hr volume, default: false
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-include-24hr-price-change)
include\_24hr\_price\_change
boolean
include 24hr price change, default: false
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-include-total-reserve-in-usd)
include\_total\_reserve\_in\_usd
boolean
include total reserve in USD, default: false
[](https://docs.coingecko.com/reference/onchain-simple-price#parameter-include-inactive-source)
include\_inactive\_source
boolean
default:false
include token price data from inactive pools using the most recent swap, default: false
#### Response
200 - application/json
Get current USD prices of multiple tokens on a network
[](https://docs.coingecko.com/reference/onchain-simple-price#response-data)
data
object
Show child attributes
Was this page helpful?
YesNo
[💼 Global Market Cap Chart Data](https://docs.coingecko.com/reference/global-market-cap-chart)
[Supported Networks List (ID Map)](https://docs.coingecko.com/reference/networks-list)
⌘I
---
# Check API server status - CoinGecko API
[Skip to main content](https://docs.coingecko.com/v3.0.1/reference/ping-server#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Ping
Check API server status
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Check API server status
cURL
Copy
curl --request GET \
--url https://api.coingecko.com/api/v3/ping \
--header 'x-cg-demo-api-key: '
200
Copy
{
"gecko_says": "(V3) To the Moon!"
}
GET
/
ping
Try it
Check API server status
cURL
Copy
curl --request GET \
--url https://api.coingecko.com/api/v3/ping \
--header 'x-cg-demo-api-key: '
200
Copy
{
"gecko_says": "(V3) To the Moon!"
}
###
[](https://docs.coingecko.com/v3.0.1/reference/ping-server#note)
Note
* You can also go to [status.coingecko.com](https://status.coingecko.com/)
to check the API server status and further maintenance notices.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/v3.0.1/reference/ping-server#authorization-x-cg-demo-api-key)
x-cg-demo-api-key
string
header
required
#### Response
200 - application/json
Status OK
[](https://docs.coingecko.com/v3.0.1/reference/ping-server#response-gecko-says)
gecko\_says
string
Was this page helpful?
YesNo
[Endpoint Overview](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview)
[Coin Price by IDs](https://docs.coingecko.com/v3.0.1/reference/simple-price)
⌘I
---
# Endpoint Overview - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/endpoint-overview#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Overview
Endpoint Overview
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Notes](https://docs.coingecko.com/reference/endpoint-overview#notes)
* [CoinGecko Endpoints: Coins](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints%3A-coins)
* [CoinGecko Endpoints: NFT](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints%3A-nft)
* [CoinGecko Endpoints: Exchanges & Derivatives](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints%3A-exchanges-%26-derivatives)
* [CoinGecko Endpoints: Public Treasuries](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints%3A-public-treasuries)
* [CoinGecko Endpoints: General](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints%3A-general)
* [Onchain DEX Endpoints (GeckoTerminal)](https://docs.coingecko.com/reference/endpoint-overview#onchain-dex-endpoints-geckoterminal)
###
[](https://docs.coingecko.com/reference/endpoint-overview#notes)
Notes
In the API reference pages, the plan-specific endpoint access will be marked as below:
* 💼 — exclusive for [Analyst Plan & above](https://www.coingecko.com/en/api/pricing)
subscribers only (excluding Basic plan).
* 👑 — exclusive for [Enterprise Plan](https://www.coingecko.com/en/api/enterprise)
subscribers only.
Some endpoints may have parameters or data access that are exclusive to different plan subscribers, please refer to the endpoint reference page for details.
[](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints:-coins)
CoinGecko Endpoints: Coins
--------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/ping](https://docs.coingecko.com/reference/ping-server) | Check the API server status |
| 💼 [/key](https://docs.coingecko.com/reference/api-usage) | Check account’s API usage |
| [/simple/price](https://docs.coingecko.com/reference/simple-price) | Query the prices of one or more coins by using their unique Coin API IDs |
| [/simple/token\_price/{id}](https://docs.coingecko.com/reference/simple-token-price) | Query the prices of one or more coins by using their unique Coin API IDs |
| [/simple/supported\_vs\_currencies](https://docs.coingecko.com/reference/simple-supported-currencies) | Query all the supported currencies on CoinGecko |
| [/coins/list](https://docs.coingecko.com/reference/coins-list) | Query all the supported coins on CoinGecko with coins ID, name and symbol |
| 💼 [/coins/top\_gainers\_losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) | Query the top 30 coins with largest price gain and loss by a specific time duration |
| 💼 [/coins/list/new](https://docs.coingecko.com/reference/coins-list-new) | Query the latest 200 coins that recently listed on CoinGecko |
| [/coins/markets](https://docs.coingecko.com/reference/coins-markets) | Query all the supported coins with price, market cap, volume and market related data |
| [/coins/{id}](https://docs.coingecko.com/reference/coins-id) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID |
| [/coins/{id}/tickers](https://docs.coingecko.com/reference/coins-id-tickers) | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID |
| [/coins/{id}/history](https://docs.coingecko.com/reference/coins-id-history) | Query the historical data (price, market cap, 24hr volume, …) at a given date for a coin based on a particular coin ID |
| [/coins/{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID |
| [/coins/{id}/market\_chart/range](https://docs.coingecko.com/reference/coins-id-market-chart-range) | 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 |
| [/coins-id-ohlc](https://docs.coingecko.com/reference/coins-id-ohlc) | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID |
| 💼 [/coins/{id}/ohlc/range](https://docs.coingecko.com/reference/coins-id-ohlc-range) | Get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID |
| 👑 [/coins/{id}/circulating\_supply\_chart](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) | Query historical circulating supply of a coin by number of days away from now based on provided coin ID |
| 👑 [/coins/{id}/circulating\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) | Query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID |
| 👑 [/coins/{id}/total\_supply\_chart](https://docs.coingecko.com/reference/coins-id-total-supply-chart) | Query historical total supply of a coin by number of days away from now based on provided coin ID |
| 👑 [/coins/{id}/total\_supply\_chart/range](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) | Query historical total supply of a coin, within a range of timestamp based on the provided coin ID |
| [/coins/../contract/..](https://docs.coingecko.com/reference/coins-contract-address) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address |
| [/coins/../contract/../market\_chart](https://docs.coingecko.com/reference/contract-address-market-chart) | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address |
| [/coins/../contract/../market\_chart/range](https://docs.coingecko.com/reference/contract-address-market-chart-range) | 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 |
| [/coins/categories/list](https://docs.coingecko.com/reference/coins-categories-list) | Query all the coins categories on CoinGecko |
| [/coins/categories](https://docs.coingecko.com/reference/coins-categories) | Query all the coins categories with market data (market cap, volume, …) on CoinGecko |
[](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints:-nft)
CoinGecko Endpoints: NFT
----------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/nfts/list](https://docs.coingecko.com/reference/nfts-list) | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko |
| [/nfts/..](https://docs.coingecko.com/reference/nfts-id) | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection ID |
| [/nfts/../contract/..](https://docs.coingecko.com/reference/nfts-contract-address) | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection contract address and respective asset platform |
| 💼 [/nfts/markets](https://docs.coingecko.com/reference/nfts-markets) | Query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko |
| 💼 [/nfts/../market\_chart](https://docs.coingecko.com/reference/nfts-id-market-chart) | Query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now |
| 💼 [/nfts/../contract/../market\_chart](https://docs.coingecko.com/reference/nfts-contract-address-market-chart) | 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 |
| 💼 [/nfts/../tickers](https://docs.coingecko.com/reference/nfts-id-tickers) | Query the latest floor price and 24hr volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and LooksRare |
[](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints:-exchanges-&-derivatives)
CoinGecko Endpoints: Exchanges & Derivatives
--------------------------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/exchanges](https://docs.coingecko.com/reference/exchanges) | Query all the supported exchanges with exchanges’ data (ID, name, country, …) that have active trading volumes on CoinGecko |
| [/exchanges/list](https://docs.coingecko.com/reference/exchanges-list) | Query all the exchanges with ID and name |
| [/exchanges/{id}](https://docs.coingecko.com/reference/exchanges-id) | Query exchange’s data (name, year established, country, …), exchange volume in BTC and tickers based on exchange’s ID |
| [/exchanges/{id}/tickers](https://docs.coingecko.com/reference/exchanges-id-tickers) | Query exchange’s tickers based on exchange’s ID |
| [/exchanges/{id}/volume\_chart](https://docs.coingecko.com/reference/exchanges-id-volume-chart) | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange’s ID |
| 💼 [/exchanges/{id}/volume\_chart/range](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range) | Query the historical volume chart data in BTC by specifying date range in UNIX based on exchange’s ID |
| [/derivatives](https://docs.coingecko.com/reference/derivatives-tickers) | Query all the tickers from derivatives exchanges on CoinGecko |
| [/derivatives/exchanges](https://docs.coingecko.com/reference/derivatives-exchanges) | Query all the derivatives exchanges with related data (ID, name, open interest, …) on CoinGecko |
| [/derivatives/exchanges/{id}](https://docs.coingecko.com/reference/derivatives-exchanges-id) | Query the derivatives exchange’s related data (ID, name, open interest, …) based on the exchanges’ ID |
| [/derivatives/exchanges/list](https://docs.coingecko.com/reference/derivatives-exchanges-list) | Query all the derivatives exchanges with ID and name on CoinGecko |
[](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints:-public-treasuries)
CoinGecko Endpoints: Public Treasuries
--------------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/entities/list](https://docs.coingecko.com/reference/entities-list) | Query all the supported entities on CoinGecko with entities ID, name, symbol, and country |
| [/{entity}/public\_treasury/{coin\_id}](https://docs.coingecko.com/reference/companies-public-treasury) | Query public companies & governments’ cryptocurrency holdings by coin ID |
| [/public\_treasury/{entity\_id}](https://docs.coingecko.com/reference/public-treasury-entity) | Query public companies & governments’ cryptocurrency holdings by entity ID |
| [/public\_treasury/{entity\_id}/…/holding\_chart](https://docs.coingecko.com/reference/public-treasury-entity-chart) | Query public companies & governments’ cryptocurrency historical holdings by entity ID and coin ID |
| [/public\_treasury/{entity\_id}/transaction\_history](https://docs.coingecko.com/reference/public-treasury-transaction-history) | Query public companies & governments’ cryptocurrency transaction history by entity ID |
[](https://docs.coingecko.com/reference/endpoint-overview#coingecko-endpoints:-general)
CoinGecko Endpoints: General
------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/asset\_platforms](https://docs.coingecko.com/reference/asset-platforms-list) | Query all the asset platforms (blockchain networks) on CoinGecko |
| [/token\_lists/{asset\_platform\_id}/all.json](https://docs.coingecko.com/reference/token-lists) | Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard |
| [/exchange\_rates](https://docs.coingecko.com/reference/exchange-rates) | Query BTC exchange rates with other currencies |
| [/search](https://docs.coingecko.com/reference/search-data) | Search for coins, categories and markets listed on CoinGecko |
| [/search/trending](https://docs.coingecko.com/reference/trending-search) | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours |
| [/global](https://docs.coingecko.com/reference/crypto-global) | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc. |
| [/global/decentralized\_finance\_defi](https://docs.coingecko.com/reference/global-defi) | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume |
| 💼 [/global/market\_cap\_chart](https://docs.coingecko.com/reference/global-market-cap-chart) | Query historical global market cap and volume data by number of days away from now |
[](https://docs.coingecko.com/reference/endpoint-overview#onchain-dex-endpoints-geckoterminal)
Onchain DEX Endpoints (GeckoTerminal)
----------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/onchain/simple/networks/../token\_price/..](https://docs.coingecko.com/reference/onchain-simple-price) | Get token price based on the provided token contract address on a network |
| [/onchain/networks](https://docs.coingecko.com/reference/networks-list) | Query all the supported networks on GeckoTerminal |
| [/onchain/networks/../dexes](https://docs.coingecko.com/reference/dexes-list) | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal |
| [/onchain/networks/../pools/..](https://docs.coingecko.com/reference/pool-address) | Query the specific pool based on the provided network and pool address |
| [/onchain/networks/../pools/multi/..](https://docs.coingecko.com/reference/pools-addresses) | Query multiple pools based on the provided network and pool address |
| [/onchain/networks/trending\_pools](https://docs.coingecko.com/reference/trending-pools-list) | Query all the trending pools across all networks on GeckoTerminal |
| [/onchain/networks/../trending\_pools](https://docs.coingecko.com/reference/trending-pools-network) | Query the trending pools based on the provided network |
| [/onchain/networks/../pools](https://docs.coingecko.com/reference/top-pools-network) | Query all the top pools based on the provided network |
| [/onchain/networks/../dexes/../pools](https://docs.coingecko.com/reference/top-pools-dex) | Query all the top pools based on the provided network and decentralized exchange (DEX) |
| [/onchain/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list) | Query all the latest pools across all networks on GeckoTerminal |
| [/onchain/networks/../new\_pools](https://docs.coingecko.com/reference/latest-pools-network) | Query all the latest pools based on provided network |
| 🔥 💼 [/onchain/pools/megafilter](https://docs.coingecko.com/reference/pools-megafilter) | Query pools based on various filters across all networks on GeckoTerminal |
| [/onchain/search/pools](https://docs.coingecko.com/reference/search-pools) | Search for pools on a network |
| 💼 [/onchain/pools/trending\_search](https://docs.coingecko.com/reference/trending-search-pools) | Query all the trending search pools across all networks on GeckoTerminal |
| [/onchain/networks/../tokens/../pools](https://docs.coingecko.com/reference/top-pools-contract-address) | Query top pools based on the provided token contract address on a network |
| [/onchain/networks/../tokens/..](https://docs.coingecko.com/reference/token-data-contract-address) | Query specific token data based on the provided token contract address on a network |
| [/onchain/networks/../tokens/multi/..](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | Query multiple tokens data based on the provided token contract addresses on a network |
| [/onchain/networks/../tokens/../info](https://docs.coingecko.com/reference/token-info-contract-address) | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network |
| [/onchain/networks/../pools/../info](https://docs.coingecko.com/reference/pool-token-info-contract-address) | 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 |
| [/onchain/tokens/info\_recently\_updated](https://docs.coingecko.com/reference/tokens-info-recent-updated) | Query 100 most recently updated tokens info across all networks on GeckoTerminal |
| 💼 [/onchain/networks/../tokens/../top\_traders](https://docs.coingecko.com/reference/top-token-traders-token-address) | Query top token traders based on the provided token contract address on a network |
| 💼 [/onchain/networks/../tokens/../top\_holders](https://docs.coingecko.com/reference/top-token-holders-token-address) | Query top token holders based on the provided token contract address on a network |
| 💼 [/onchain/networks/../tokens/../holders\_chart](https://docs.coingecko.com/reference/token-holders-chart-token-address) | Get the historical token holders chart based on the provided token contract address on a network |
| [/onchain/networks/../pools/../ohlcv/..](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network |
| 💼 [/onchain/networks/../tokens/../ohlcv/..](https://docs.coingecko.com/reference/token-ohlcv-token-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network |
| [/onchain/networks/../pools/../trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | Query the last 300 trades in the past 24 hours based on the provided pool address |
| 💼 [/onchain/networks/../tokens/../trades](https://docs.coingecko.com/reference/token-trades-contract-address) | Query the last 300 trades in the past 24 hours across all pools, based on the provided token contract address on a network |
| 💼 [/onchain/categories](https://docs.coingecko.com/reference/categories-list) | Query all the supported categories on GeckoTerminal |
| 💼 [/onchain/categories/../pools](https://docs.coingecko.com/reference/pools-category) | Query all the pools based on the provided category ID |
⚡️ Need Real-time Data Streams? Try [WebSocket API](https://docs.coingecko.com/websocket)
[](https://docs.coingecko.com/websocket)
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our [paid API plan](https://www.coingecko.com/en/api/pricing)
(Analyst plan & above) to access WebSocket and REST API data delivery methods.
Was this page helpful?
YesNo
[Authentication (Pro API)](https://docs.coingecko.com/reference/authentication)
[Check API server status](https://docs.coingecko.com/reference/ping-server)
⌘I
---
# Endpoint Overview - CoinGecko API
[Skip to main content](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Overview
Endpoint Overview
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [Notes](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#notes)
* [CoinGecko Endpoints: Coins](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints%3A-coins)
* [CoinGecko Endpoints: NFT](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints%3A-nft)
* [CoinGecko Endpoints: Exchanges & Derivatives](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints%3A-exchanges-%26-derivatives)
* [CoinGecko Endpoints: Public Treasuries](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints%3A-public-treasuries)
* [CoinGecko Endpoints: General](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints%3A-general)
* [Onchain DEX Endpoints (GeckoTerminal)](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#onchain-dex-endpoints-geckoterminal)
###
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#notes)
Notes
Any exclusive endpoints for Pro-API users (any paid plan subscribers) will not be included here.For a full list of endpoints, please visit [Pro API Documentation](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview)
instead.
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints:-coins)
CoinGecko Endpoints: Coins
---------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/ping](https://docs.coingecko.com/v3.0.1/reference/ping-server) | Check the API server status |
| [/simple/price](https://docs.coingecko.com/v3.0.1/reference/simple-price) | Query the prices of one or more coins by using their unique Coin API IDs |
| [/simple/token\_price/{id}](https://docs.coingecko.com/v3.0.1/reference/simple-token-price) | Query the prices of one or more coins by using their unique Coin API IDs |
| [/simple/supported\_vs\_currencies](https://docs.coingecko.com/v3.0.1/reference/simple-supported-currencies) | Query all the supported currencies on CoinGecko |
| [/coins/list](https://docs.coingecko.com/v3.0.1/reference/coins-list) | Query all the supported coins on CoinGecko with coins ID, name and symbol |
| [/coins/markets](https://docs.coingecko.com/v3.0.1/reference/coins-markets) | Query all the supported coins with price, market cap, volume and market related data |
| [/coins/{id}](https://docs.coingecko.com/v3.0.1/reference/coins-id) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID |
| [/coins/{id}/tickers](https://docs.coingecko.com/v3.0.1/reference/coins-id-tickers) | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID |
| [/coins/{id}/history](https://docs.coingecko.com/v3.0.1/reference/coins-id-history) | Query the historical data (price, market cap, 24hr volume, …) at a given date for a coin based on a particular coin ID |
| [/coins/{id}/market\_chart](https://docs.coingecko.com/v3.0.1/reference/coins-id-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID |
| [/coins/{id}/market\_chart/range](https://docs.coingecko.com/v3.0.1/reference/coins-id-market-chart-range) | 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 |
| [/coins-id-ohlc](https://docs.coingecko.com/v3.0.1/reference/coins-id-ohlc) | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID |
| [/coins/../contract/..](https://docs.coingecko.com/v3.0.1/reference/coins-contract-address) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address |
| [/coins/../contract/../market\_chart](https://docs.coingecko.com/v3.0.1/reference/contract-address-market-chart) | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address |
| [/coins/../contract/../market\_chart/range](https://docs.coingecko.com/v3.0.1/reference/contract-address-market-chart-range) | 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 |
| [/coins/categories/list](https://docs.coingecko.com/v3.0.1/reference/coins-categories-list) | Query all the coins categories on CoinGecko |
| [/coins/categories](https://docs.coingecko.com/v3.0.1/reference/coins-categories) | Query all the coins categories with market data (market cap, volume, …) on CoinGecko |
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints:-nft)
CoinGecko Endpoints: NFT
-----------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/nfts/list](https://docs.coingecko.com/v3.0.1/reference/nfts-list) | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko |
| [/nfts/..](https://docs.coingecko.com/v3.0.1/reference/nfts-id) | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection ID |
| [/nfts/../contract/..](https://docs.coingecko.com/v3.0.1/reference/nfts-contract-address) | Query all the NFT data (name, floor price, 24hr volume, …) based on the NFT collection contract address and respective asset platform |
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints:-exchanges-&-derivatives)
CoinGecko Endpoints: Exchanges & Derivatives
---------------------------------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/exchanges](https://docs.coingecko.com/v3.0.1/reference/exchanges) | Query all the supported exchanges with exchanges’ data (ID, name, country, …) that have active trading volumes on CoinGecko |
| [/exchanges/list](https://docs.coingecko.com/v3.0.1/reference/exchanges-list) | Query all the exchanges with ID and name |
| [/exchanges/{id}](https://docs.coingecko.com/v3.0.1/reference/exchanges-id) | Query exchange’s data (name, year established, country, …), exchange volume in BTC and tickers based on exchange’s ID |
| [/exchanges/{id}/tickers](https://docs.coingecko.com/v3.0.1/reference/exchanges-id-tickers) | Query exchange’s tickers based on exchange’s ID |
| [/exchanges/{id}/volume\_chart](https://docs.coingecko.com/v3.0.1/reference/exchanges-id-volume-chart) | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange’s ID |
| [/derivatives](https://docs.coingecko.com/v3.0.1/reference/derivatives-tickers) | Query all the tickers from derivatives exchanges on CoinGecko |
| [/derivatives/exchanges](https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges) | Query all the derivatives exchanges with related data (ID, name, open interest, …) on CoinGecko |
| [/derivatives/exchanges/{id}](https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges-id) | Query the derivatives exchange’s related data (ID, name, open interest, …) based on the exchanges’ ID |
| [/derivatives/exchanges/list](https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges-list) | Query all the derivatives exchanges with ID and name on CoinGecko |
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints:-public-treasuries)
CoinGecko Endpoints: Public Treasuries
---------------------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/entities/list](https://docs.coingecko.com/v3.0.1/reference/entities-list) | Query all the supported entities on CoinGecko with entities ID, name, symbol, and country |
| [/{entity}/public\_treasury/{coin\_id}](https://docs.coingecko.com/v3.0.1/reference/companies-public-treasury) | Query public companies & governments’ cryptocurrency holdings by coin ID |
| [/public\_treasury/{entity\_id}](https://docs.coingecko.com/v3.0.1/reference/public-treasury-entity) | Query public companies & governments’ cryptocurrency holdings by entity ID |
| [/public\_treasury/{entity\_id}/…/holding\_chart](https://docs.coingecko.com/v3.0.1/reference/public-treasury-entity-chart) | Query public companies & governments’ cryptocurrency historical holdings by entity ID and coin ID |
| [/public\_treasury/{entity\_id}/transaction\_history](https://docs.coingecko.com/v3.0.1/reference/public-treasury-transaction-history) | Query public companies & governments’ cryptocurrency transaction history by entity ID |
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#coingecko-endpoints:-general)
CoinGecko Endpoints: General
-------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/asset\_platforms](https://docs.coingecko.com/v3.0.1/reference/asset-platforms-list) | Query all the asset platforms (blockchain networks) on CoinGecko |
| [/token\_lists/{asset\_platform\_id}/all.json](https://docs.coingecko.com/v3.0.1/reference/token-lists) | Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard |
| [/exchange\_rates](https://docs.coingecko.com/v3.0.1/reference/exchange-rates) | Query BTC exchange rates with other currencies |
| [/search](https://docs.coingecko.com/v3.0.1/reference/search-data) | Search for coins, categories and markets listed on CoinGecko |
| [/search/trending](https://docs.coingecko.com/v3.0.1/reference/trending-search) | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours |
| [/global](https://docs.coingecko.com/v3.0.1/reference/crypto-global) | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc. |
| [/global/decentralized\_finance\_defi](https://docs.coingecko.com/v3.0.1/reference/global-defi) | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume |
[](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview#onchain-dex-endpoints-geckoterminal)
Onchain DEX Endpoints (GeckoTerminal)
-----------------------------------------------------------------------------------------------------------------------------------------------
| Endpoint | Description |
| --- | --- |
| [/onchain/simple/networks/../token\_price/..](https://docs.coingecko.com/v3.0.1/reference/onchain-simple-price) | Get token price based on the provided token contract address on a network |
| [/onchain/networks](https://docs.coingecko.com/v3.0.1/reference/networks-list) | Query all the supported networks on GeckoTerminal |
| [/onchain/networks/../dexes](https://docs.coingecko.com/v3.0.1/reference/dexes-list) | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal |
| [/onchain/networks/../pools/..](https://docs.coingecko.com/v3.0.1/reference/pool-address) | Query the specific pool based on the provided network and pool address |
| [/onchain/networks/../pools/multi/..](https://docs.coingecko.com/v3.0.1/reference/pools-addresses) | Query multiple pools based on the provided network and pool address |
| [/onchain/networks/trending\_pools](https://docs.coingecko.com/v3.0.1/reference/trending-pools-list) | Query all the trending pools across all networks on GeckoTerminal |
| [/onchain/networks/../trending\_pools](https://docs.coingecko.com/v3.0.1/reference/trending-pools-network) | Query the trending pools based on the provided network |
| [/onchain/networks/../pools](https://docs.coingecko.com/v3.0.1/reference/top-pools-network) | Query all the top pools based on the provided network |
| [/onchain/networks/../dexes/../pools](https://docs.coingecko.com/v3.0.1/reference/top-pools-dex) | Query all the top pools based on the provided network and decentralized exchange (DEX) |
| [/onchain/networks/new\_pools](https://docs.coingecko.com/v3.0.1/reference/latest-pools-list) | Query all the latest pools across all networks on GeckoTerminal |
| [/onchain/networks/../new\_pools](https://docs.coingecko.com/v3.0.1/reference/latest-pools-network) | Query all the latest pools based on provided network |
| [/onchain/search/pools](https://docs.coingecko.com/v3.0.1/reference/search-pools) | Search for pools on a network |
| [/onchain/networks/../tokens/../pools](https://docs.coingecko.com/v3.0.1/reference/top-pools-contract-address) | Query top pools based on the provided token contract address on a network |
| [/onchain/networks/../tokens/..](https://docs.coingecko.com/v3.0.1/reference/token-data-contract-address) | Query specific token data based on the provided token contract address on a network |
| [/onchain/networks/../tokens/multi/..](https://docs.coingecko.com/v3.0.1/reference/tokens-data-contract-addresses) | Query multiple tokens data based on the provided token contract addresses on a network |
| [/onchain/networks/../tokens/../info](https://docs.coingecko.com/v3.0.1/reference/token-info-contract-address) | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network |
| [/onchain/networks/../pools/../info](https://docs.coingecko.com/v3.0.1/reference/pool-token-info-contract-address) | 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 |
| [/onchain/tokens/info\_recently\_updated](https://docs.coingecko.com/v3.0.1/reference/tokens-info-recent-updated) | Query 100 most recently updated tokens info across all networks on GeckoTerminal |
| [/onchain/networks/../pools/../ohlcv/..](https://docs.coingecko.com/v3.0.1/reference/pool-ohlcv-contract-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network |
| [/onchain/networks/../pools/../trades](https://docs.coingecko.com/v3.0.1/reference/pool-trades-contract-address) | Query the last 300 trades in the past 24 hours based on the provided pool address |
⚡️ Need Real-time Data Streams? Try [WebSocket API](https://docs.coingecko.com/websocket)
[](https://docs.coingecko.com/websocket)
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our [paid API plan](https://www.coingecko.com/en/api/pricing)
(Analyst plan & above) to access WebSocket and REST API data delivery methods.
Was this page helpful?
YesNo
[Authentication (Public/Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Check API server status](https://docs.coingecko.com/v3.0.1/reference/ping-server)
⌘I
---
# CGSimplePrice - CoinGecko API
[Skip to main content](https://docs.coingecko.com/websocket/cgsimpleprice#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Websocket (Beta)
CGSimplePrice
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Messages
Subscribe to CGSimplePrice
{ "command": "", "identifier": ""}
Stream CGSimplePrice Data
{ "command": "", "identifier": "", "data": ""}
CGSimplePrice Update
{ "c": "", "i": "", "m": 123, "p": 123, "pp": 123, "t": 123, "v": 123}
WSS
wss://stream.coingecko.com
/
v1
Connect
Messages
Subscribe to CGSimplePrice
{ "command": "", "identifier": ""}
Stream CGSimplePrice Data
{ "command": "", "identifier": "", "data": ""}
CGSimplePrice Update
{ "c": "", "i": "", "m": 123, "p": 123, "pp": 123, "t": 123, "v": 123}
Security Schemes
x\_cg\_pro\_api\_key
type:httpApiKey
Insert CoinGecko Pro API key to establish WebSocket connection
Send
Subscribe to CGSimplePrice
type:object
show 2 properties
Subscribe to the CGSimplePrice channel
Stream CGSimplePrice Data
type:object
show 3 properties
Set coins to receive price updates
Receive
CGSimplePrice Update
type:object
show 7 properties
Real-time price update
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.
###
[](https://docs.coingecko.com/websocket/cgsimpleprice#data-payload)
Data Payload
| | Field | Type | Description | Example |
| --- | --- | --- | --- | --- |
| `c` | `channel_type` | string | Indicates the type of channel subscribed to. | C1 |
| `i` | `coin_id` | string | Identifier of the coins. Check full list of IDs [here](https://api.coingecko.com/api/v3/coins/list)
. | `ethereum`, `usd-coin` |
| `p` | `usd_price` | string | Current token price in USD. | 3639.78228844745 |
| `pp` | `usd_price_24h_change_percentage` | float | Percentage change in token price over the last 24 hours. | 3.566 |
| `m` | `usd_market_cap` | float | Market capitalization in USD. | 123 |
| `v` | `usd_24h_vol` | float | 24-hour trading volume in USD. | 31233333.33 |
| `t` | `last_updated_at` | integer | Timestamp 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.
* * *
[](https://docs.coingecko.com/websocket/cgsimpleprice#1-establish-connection-to-websocket)
1\. Establish Connection to Websocket
------------------------------------------------------------------------------------------------------------------------------------
Bash
Copy
wss://stream.coingecko.com/v1?x_cg_pro_api_key=YOUR_KEY
OR
wss://stream.coingecko.com/v1
x-cg-pro-api-key: YOUR_KEY
[](https://docs.coingecko.com/websocket/cgsimpleprice#2-subscribe-to-a-specific-channel-cgsimpleprice)
2\. Subscribe to a specific channel - CGSimplePrice
--------------------------------------------------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"subscribe","identifier":"{\"channel\":\"CGSimplePrice\"}"}
**Output Example**:
JSON
Copy
{"type":"confirm_subscription","identifier":"{\"channel\":\"CGSimplePrice\"}"}
[](https://docs.coingecko.com/websocket/cgsimpleprice#3-stream-cgsimpleprice)
3\. Stream CGSimplePrice
----------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"CGSimplePrice\"}","data":"{\"coin_id\":[\"ethereum\",\"bitcoin\"],\"action\":\"set_tokens\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Subscription is successful for ethereum"
}
**Output Example**:
JSON
Copy
{
"c": "C1",
"i": "ethereum",
"m": 312938652962.8005,
"p": 2591.080889351465,
"pp": 1.3763793110454519,
"t": 1747808150.269067,
"v": 20460612214.801384
}
The output keys will be in random order.
[](https://docs.coingecko.com/websocket/cgsimpleprice#tips:)
Tips:
----------------------------------------------------------------------
###
[](https://docs.coingecko.com/websocket/cgsimpleprice#un-subscribe-to-stop-streaming-cgsimpleprice-data)
Un-subscribe to stop streaming CGSimplePrice data
**Input Example:** Unsubscribe for 1 specific token data:
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"CGSimplePrice\"}","data":"{\"coin_id\":[\"ethereum\"],\"action\":\"unset_tokens\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Unsubscription is successful for ethereum"
}
**Input Example:** Unsubscribe from CGSimplePrice channel and all token data:
JSON
Copy
{"command":"unsubscribe","identifier":"{\"channel\":\"CGSimplePrice\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Unsubscription is successful for all tokens"
}
Was this page helpful?
YesNo
[WebSocket (Beta)](https://docs.coingecko.com/websocket)
[OnchainSimpleTokenPrice](https://docs.coingecko.com/websocket/onchainsimpletokenprice)
⌘I
---
# OnchainSimpleTokenPrice - CoinGecko API
[Skip to main content](https://docs.coingecko.com/websocket/onchainsimpletokenprice#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Websocket (Beta)
OnchainSimpleTokenPrice
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Messages
Subscribe to OnchainSimpleTokenPrice
{ "command": "", "identifier": ""}
Stream OnchainSimpleTokenPrice Data
{ "command": "", "identifier": "", "data": ""}
OnchainSimpleTokenPrice Update
{ "c": "", "n": "", "ta": "", "p": 123, "pp": 123, "m": 123, "v": 123, "t": 123}
WSS
wss://stream.coingecko.com
/
v1
Connect
Messages
Subscribe to OnchainSimpleTokenPrice
{ "command": "", "identifier": ""}
Stream OnchainSimpleTokenPrice Data
{ "command": "", "identifier": "", "data": ""}
OnchainSimpleTokenPrice Update
{ "c": "", "n": "", "ta": "", "p": 123, "pp": 123, "m": 123, "v": 123, "t": 123}
Security Schemes
x\_cg\_pro\_api\_key
type:httpApiKey
Insert CoinGecko Pro API key to establish WebSocket connection
Send
Subscribe to OnchainSimpleTokenPrice
type:object
show 2 properties
Subscribe to the OnchainSimpleTokenPrice channel
Stream OnchainSimpleTokenPrice Data
type:object
show 3 properties
Set tokens to receive price updates
Receive
OnchainSimpleTokenPrice Update
type:object
show 8 properties
Real-time token price update
This Websocket channel allows you to subscribe to real-time updates of price changes for token.
* Lookup by Network + Token Address
* It will return price and market data of the top pool of the specified token
**Update Frequency**: as fast as 1s, for actively traded tokens.
###
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#data-payload)
Data Payload
| | Field | Type | Description | Example |
| --- | --- | --- | --- | --- |
| `c` | `channel_type` | string | Indicates the type of channel subscribed to. | G1 |
| `n` | `network_id` | string | Identifier of the blockchain network. Check full list of IDs [here](https://api.geckoterminal.com/api/v2/networks?page=1)
. | `eth` |
| `ta` | `token_address` | string | Contract address of the token on the blockchain. | `0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2` |
| `p` | `usd_price` | float | Current token price in USD. | 3639.78228844745 |
| `pp` | `usd_price_24h_change_percentage` | float | Percentage change in token price over the last 24 hours. | 3.566 |
| `m` | `usd_market_cap` | float | Market capitalization in USD. | 123 |
| `v` | `usd_24h_vol` | float | 24-hour trading volume in USD. | 31233333.33 |
| `t` | `last_updated_at` | integer | Timestamp 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.
* * *
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#1-establish-connection-to-websocket)
1\. Establish Connection to Websocket
----------------------------------------------------------------------------------------------------------------------------------------------
Bash
Copy
wss://stream.coingecko.com/v1?x_cg_pro_api_key=YOUR_KEY
OR
wss://stream.coingecko.com/v1
x-cg-pro-api-key: YOUR_KEY
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#2-subscribe-to-a-specific-channel-onchainsimpletokenprice)
2\. Subscribe to a specific channel - OnchainSimpleTokenPrice
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"subscribe","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}"}
**Output Example**:
JSON
Copy
{"type":"confirm_subscription","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}"}
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#3-stream-onchainsimpletokenprice-data)
3\. Stream OnchainSimpleTokenPrice data
--------------------------------------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}","data":"{\"network_id:token_addresses\":[\"bsc:0x55d398326f99059ff775485246999027b3197955\"],\"action\":\"set_tokens\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Subscription successful for bsc:0x55d398326f99059ff775485246999027b3197955"
}
**Output Example**:
JSON
Copy
{
"c": "G1",
"n": "bsc",
"ta": "0x55d398326f99059ff775485246999027b3197955",
"p": 0.999457718373347,
"pp": -0.009028866490825653,
"m": 1317802988326.25,
"v": 1476864199.38384,
"t": 1737427063
}
The output keys will be in random order.
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#tips:)
Tips:
--------------------------------------------------------------------------------
###
[](https://docs.coingecko.com/websocket/onchainsimpletokenprice#un-subscribe-to-stop-streaming-onchainsimpletokenprice-data)
Un-subscribe to stop streaming OnchainSimpleTokenPrice data
**Input Example:** Unsubscribe for 1 specific token data:
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}","data":"{\"network_id:token_addresses\":[\"bsc:0x55d398326f99059ff775485246999027b3197955\"],\"action\":\"unset_tokens\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for bsc:0x55d398326f99059ff775485246999027b3197955"
}
**Input Example:** Unsubscribe from OnchainSimpleTokenPrice channel and all token data:
JSON
Copy
{"command":"unsubscribe","identifier":"{\"channel\":\"OnchainSimpleTokenPrice\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for all tokens"
}
Was this page helpful?
YesNo
[CGSimplePrice](https://docs.coingecko.com/websocket/cgsimpleprice)
[OnchainTrade](https://docs.coingecko.com/websocket/wss-onchain-trade)
⌘I
---
# OnchainTrade - CoinGecko API
[Skip to main content](https://docs.coingecko.com/websocket/wss-onchain-trade#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Websocket (Beta)
OnchainTrade
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Messages
Subscribe to OnchainTrade
{ "command": "", "identifier": ""}
Stream OnchainTrade Data
{ "command": "", "identifier": "", "data": ""}
OnchainTrade Update
{ "c": "", "n": "", "pa": "", "tx": "", "ty": "", "to": "", "vo": "", "pc": "", "pu": "", "t": 123}
WSS
wss://stream.coingecko.com
/
v1
Connect
Messages
Subscribe to OnchainTrade
{ "command": "", "identifier": ""}
Stream OnchainTrade Data
{ "command": "", "identifier": "", "data": ""}
OnchainTrade Update
{ "c": "", "n": "", "pa": "", "tx": "", "ty": "", "to": "", "vo": "", "pc": "", "pu": "", "t": 123}
Security Schemes
x\_cg\_pro\_api\_key
type:httpApiKey
Insert CoinGecko Pro API key to establish WebSocket connection
Send
Subscribe to OnchainTrade
type:object
show 2 properties
Subscribe to the OnchainTrade channel
Stream OnchainTrade Data
type:object
show 3 properties
Set pools to receive trade updates
Receive
OnchainTrade Update
type:object
show 10 properties
Real-time trade update
This Websocket channel allows you to subscribe to real-time updates of token trades of a pool.
* Lookup by Network + Pool Address
* It will return transaction type (buy/sell), tx hash, amount of token transacted, volume, and current price data of the specified pool.
**Update Frequency**: as fast as 0.1s, for actively traded pools. **Tips**: use this Rest API endpoint [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)
to obtain contract address of the most liquid pool.
###
[](https://docs.coingecko.com/websocket/wss-onchain-trade#data-payload)
Data Payload
| | Field | Type | Description | Example |
| --- | --- | --- | --- | --- |
| `ch` | `channel_type` | string | Indicates the type of channel subscribed to. | G2 |
| `n` | `network_id` | string | Identifier of the blockchain network. Check full list of IDs [here](https://api.geckoterminal.com/api/v2/networks?page=1)
. | eth |
| `pa` | `pool_address` | string | Contract address of the pool. | `0x88e6a0c2dd6fcb..3f5640` |
| `tx` | `tx_hash` | string | transaction hash | `0x0b8ac5a16c2d5a..4d422` |
| `ty` | `type` | string | type of transaction (`b` for buy or `s` for sell) | b |
| `to` | `token_amount` | float | Amount of token transacted. | 100 |
| `vo` | `volume_in_usd` | float | The transaction value in USD. | 1000 |
| `pc` | `price_in_native_currency` | float | Current token price in network’s native token currency. E.g. Base network’s native currency is ETH. | 3639.78228844745 |
| `pu` | `price_in_usd` | float | Current token price in USD | 3.566 |
| `t` | `last_updated_at` | integer | Timestamp of the last data update in UNIX time. | 1752072129000 |
**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.
* * *
[](https://docs.coingecko.com/websocket/wss-onchain-trade#1-establish-connection-to-websocket)
1\. Establish Connection to Websocket
----------------------------------------------------------------------------------------------------------------------------------------
Bash
Copy
wss://stream.coingecko.com/v1?x_cg_pro_api_key=YOUR_KEY
OR
wss://stream.coingecko.com/v1
x-cg-pro-api-key: YOUR_KEY
[](https://docs.coingecko.com/websocket/wss-onchain-trade#2-subscribe-to-a-specific-channel-onchaintrade)
2\. Subscribe to a specific channel - OnchainTrade
----------------------------------------------------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"subscribe","identifier":"{\"channel\":\"OnchainTrade\"}"}
**Output Example**:
JSON
Copy
{"type":"confirm_subscription","identifier":"{\"channel\":\"OnchainTrade\"}"}
[](https://docs.coingecko.com/websocket/wss-onchain-trade#3-stream-onchaintrade-data)
3\. Stream OnchainTrade data
----------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainTrade\"}","data":"{\"network_id:pool_addresses\":[\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\"],\"action\":\"set_pools\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Subscription successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849"
}
**Output Example**:
JSON
Copy
{
"c": "G2",
"n": "bsc",
"pa": "0x172fcd41e0913e95784454622d1c3724f546f849",
"tx": "0x3e71ee7da66000a5a92f13abd2ae95e0abc0bc828087d8dd210338fd262cf6c9",
"ty": "b",
"to": "1.51717616246451",
"vo": "2.75413132131313",
"pc": "0.000274100995437363"
"pu": "3656.8970003075",
"t": 1724927796000
}
The output keys will be in random order.
[](https://docs.coingecko.com/websocket/wss-onchain-trade#tips:)
Tips:
--------------------------------------------------------------------------
###
[](https://docs.coingecko.com/websocket/wss-onchain-trade#un-subscribe-to-stop-streaming-onchaintrade-data)
Un-subscribe to stop streaming OnchainTrade data
**Input Example:** Unsubscribe for 1 specific pool data:
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainTrade\"}","data":"{\"network_id:pool_addresses\":[\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\"],\"action\":\"unset_pools\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849"
}
**Input Example:** Unsubscribe from OnchainTrade channel and all pools data:
JSON
Copy
{"command":"unsubscribe","identifier":"{\"channel\":\"OnchainTrade\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for all pools"
}
Was this page helpful?
YesNo
[OnchainSimpleTokenPrice](https://docs.coingecko.com/websocket/onchainsimpletokenprice)
[OnchainOHLCV](https://docs.coingecko.com/websocket/wssonchainohlcv)
⌘I
---
# OnchainOHLCV - CoinGecko API
[Skip to main content](https://docs.coingecko.com/websocket/wssonchainohlcv#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Websocket (Beta)
OnchainOHLCV
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Messages
Subscribe to OnchainOHLCV
{ "command": "", "identifier": ""}
Stream OnchainOHLCV Data
{ "command": "", "identifier": "", "data": ""}
OnchainOHLCV Update
{ "ch": "", "n": "", "pa": "", "to": "", "i": "", "o": 123, "h": 123, "l": 123, "c": 123, "v": 123, "t": 123}
WSS
wss://stream.coingecko.com
/
v1
Connect
Messages
Subscribe to OnchainOHLCV
{ "command": "", "identifier": ""}
Stream OnchainOHLCV Data
{ "command": "", "identifier": "", "data": ""}
OnchainOHLCV Update
{ "ch": "", "n": "", "pa": "", "to": "", "i": "", "o": 123, "h": 123, "l": 123, "c": 123, "v": 123, "t": 123}
Security Schemes
x\_cg\_pro\_api\_key
type:httpApiKey
Insert CoinGecko Pro API key to establish WebSocket connection
Send
Subscribe to OnchainOHLCV
type:object
show 2 properties
Subscribe to the OnchainOHLCV channel
Stream OnchainOHLCV Data
type:object
show 3 properties
Set pools to receive OHLCV updates
Receive
OnchainOHLCV Update
type:object
show 11 properties
Real-time OHLCV update
This Websocket channel allows you to subscribe to real-time OHLCV updates of a pool.
* Lookup by Network + Pool Address
* It will return **O**pen, **H**igh, **L**ow, **C**lose price and **V**olume data the specified pool.
**Update Frequency**: as fast as 1s, for actively traded pools. **Tips**: use this Rest API endpoint [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address#/)
to obtain contract address of the most liquid pool.
###
[](https://docs.coingecko.com/websocket/wssonchainohlcv#notes)
**Notes**
* Interval options: 1s / 1m / 5m / 1h / 2h / 4h / 8h
* You may stream the pool ohlcv data based on `base` or `quote` token of a pool.
* Please note that your subscription quota is based on the number of **unique data streams** you request. Each unique combination of an interval and token for a given pool is considered a **distinct subscription** and will count towards your max subscription limit.
###
[](https://docs.coingecko.com/websocket/wssonchainohlcv#data-payload)
Data Payload
| | Field | Type | Description | Example |
| --- | --- | --- | --- | --- |
| `ch` | `channel_type` | string | Indicates the type of channel subscribed to. | G3 |
| `n` | `network_id` | string | Identifier of the blockchain network. Check full list of IDs [here](https://api.geckoterminal.com/api/v2/networks?page=1)
. | eth |
| `pa` | `pool_address` | string | Contract address of the pool. | `0x88e6a0c2dd6fcb..3f5640` |
| `to` | `token` | string | `base` or `quote` token | `base` |
| `i` | `interval` | string | Interval or resolution of the candle: 1s / 1m / 5m / 1h / 2h / 4h / 8h | 1m |
| `o` | `open` | float | Open price in USD | 3539 |
| `h` | `high` | float | High price in USD | 3541 |
| `l` | `low` | float | Low price in USD | 3530 |
| `c` | `close` | float | Close price in USD | 3531 |
| `v` | `volume` | float | Volume in USD | 323333 |
| `t` | `timestamp` | integer | Opening timestamp of candle interval | 1753803600 |
**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.
* * *
[](https://docs.coingecko.com/websocket/wssonchainohlcv#1-establish-connection-to-websocket)
1\. Establish Connection to Websocket
--------------------------------------------------------------------------------------------------------------------------------------
Bash
Copy
wss://stream.coingecko.com/v1?x_cg_pro_api_key=YOUR_KEY
OR
wss://stream.coingecko.com/v1
x-cg-pro-api-key: YOUR_KEY
[](https://docs.coingecko.com/websocket/wssonchainohlcv#2-subscribe-to-a-specific-channel-onchainohlcv)
2\. Subscribe to a specific channel - OnchainOHLCV
--------------------------------------------------------------------------------------------------------------------------------------------------------------
**Input Example:**
JSON
Copy
{"command":"subscribe","identifier":"{\"channel\":\"OnchainOHLCV\"}"}
**Output Example**:
JSON
Copy
{"type":"confirm_subscription","identifier":"{\"channel\":\"OnchainOHLCV\"}"}
[](https://docs.coingecko.com/websocket/wssonchainohlcv#3-stream-onchainohlcv-data)
3\. Stream OnchainOHLCV data
--------------------------------------------------------------------------------------------------------------------
**Input Example:** (1 minute interval and base token of a pool)
* `Interval` options: 1s / 1m / 5m / 1h / 2h / 4h / 8h
* You may stream the pool ohlcv data of ‘base’ or ‘quote’ `token`.
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainOHLCV\"}","data":"{\"network_id:pool_addresses\":[\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\"],\"interval\":\"1m\",\"token\":\"base\",\"action\":\"set_pools\"}"}
**Output Example**:
JSON
Copy
{
"code": 2000,
"message": "Subscription successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849:1m:base"
}
**Output Example**:
JSON
Copy
{
"c": 0.999727235252031,
"ch": "G3",
"h": 0.999974654065411,
"i": "1m",
"l": 0.999353212178554,
"n": "bsc",
"o": 0.999570907451071,
"pa": "0x172fcd41e0913e95784454622d1c3724f546f849",
"t": 1753886760,
"to": "base",
"v": 63932.29404921795
}
The output keys will be in random order.
[](https://docs.coingecko.com/websocket/wssonchainohlcv#tips:)
Tips:
------------------------------------------------------------------------
###
[](https://docs.coingecko.com/websocket/wssonchainohlcv#un-subscribe-to-stop-streaming-onchainohlcv-data)
Un-subscribe to stop streaming OnchainOHLCV data
**Input Example:** Unsubscribe for 1 specific pool data:
JSON
Copy
{"command":"message","identifier":"{\"channel\":\"OnchainOHLCV\"}","data":"{\"network_id:pool_addresses\":[\"eth:0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b\"],\"interval\":\"1m\",\"token\":\"base\",\"action\":\"unset_pools\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for eth:0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b:1m:base"
}
**Input Example:** Unsubscribe from OnchainOHLCV channel and all pools data:
JSON
Copy
{"command":"unsubscribe","identifier":"{\"channel\":\"OnchainOHLCV\"}"}
**Output Example**:
JSON
Copy
{
"code":2000,
"message":"Unsubscription is successful for all pools"
}
Was this page helpful?
YesNo
[OnchainTrade](https://docs.coingecko.com/websocket/wss-onchain-trade)
⌘I
---
# Coins List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
Coins List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coins List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "0chain",\
"symbol": "zcn",\
"name": "Zus",\
"platforms": {\
"ethereum": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78",\
"polygon-pos": "0x8bb30e0e67b11b978a5040144c410e1ccddcba30"\
}\
},\
{\
"id": "01coin",\
"symbol": "zoc",\
"name": "01coin",\
"platforms": {}\
}\
]
GET
/
coins
/
list
Try it
Coins List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "0chain",\
"symbol": "zcn",\
"name": "Zus",\
"platforms": {\
"ethereum": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78",\
"polygon-pos": "0x8bb30e0e67b11b978a5040144c410e1ccddcba30"\
}\
},\
{\
"id": "01coin",\
"symbol": "zoc",\
"name": "01coin",\
"platforms": {}\
}\
]
###
[](https://docs.coingecko.com/reference/coins-list#tips)
Tips
* You may use this endpoint to query the list of coins with coin id for other endpoints that contain params like `id` or `ids` (coin ID).
* By default, this endpoint returns full list of active coins that are currently listed on CoinGecko.com , you can also flag `status=inactive` to retrieve coins that are no longer available on CoinGecko.com . The inactive coin IDs can also be used with [selected historical data](https://docs.coingecko.com/changelog#april-2024)
endpoints.
###
[](https://docs.coingecko.com/reference/coins-list#note)
Note
* There is no pagination required for this endpoint.
* Cache/Update Frequency: every 5 minutes for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-list#parameter-include-platform)
include\_platform
boolean
include platform and token's contract addresses, default: false
[](https://docs.coingecko.com/reference/coins-list#parameter-status)
status
enum
filter by status of coins, default: active
Available options:
`active`,
`inactive`
#### Response
200 - application/json
List all coins with ID, name, and symbol
[](https://docs.coingecko.com/reference/coins-list#response-items-id)
id
string
coin ID
[](https://docs.coingecko.com/reference/coins-list#response-items-symbol)
symbol
string
coin symbol
[](https://docs.coingecko.com/reference/coins-list#response-items-name)
name
string
coin name
[](https://docs.coingecko.com/reference/coins-list#response-items-platforms)
platforms
object
coin asset platform and contract address
Show child attributes
Example:
[ { "id": "0chain", "symbol": "zcn", "name": "Zus", "platforms": { "ethereum": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78", "polygon-pos": "0x8bb30e0e67b11b978a5040144c410e1ccddcba30" } }, { "id": "01coin", "symbol": "zoc", "name": "01coin", "platforms": {} }]
Was this page helpful?
YesNo
[Supported Currencies List](https://docs.coingecko.com/reference/simple-supported-currencies)
[💼 Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
⌘I
---
# AI Prompts - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/ai-prompts#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
AI Integration
AI Prompts
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [How to Use Our Prompts](https://docs.coingecko.com/docs/ai-prompts#how-to-use-our-prompts)
* [Available Prompts](https://docs.coingecko.com/docs/ai-prompts#available-prompts)
* [Best Practices](https://docs.coingecko.com/docs/ai-prompts#best-practices)
Accelerate your development with CoinGecko’s curated AI prompts. These prompts are designed to guide AI-powered coding assistants in correctly implementing our official API SDKs (libraries), helping you spend less time debugging and more time building.
[](https://docs.coingecko.com/docs/ai-prompts#how-to-use-our-prompts)
How to Use Our Prompts
------------------------------------------------------------------------------------------------
Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant.
1. For **Chat Interfaces (Claude, ChatGPT, etc.)**: Paste the prompt at the beginning of your conversation before asking the AI to write code.
2. For **Cursor IDE**: Add the prompt to your project’s `Rules` to enforce the guidelines across all AI interactions.
3. For **GitHub Copilot**: Save the prompt to a file (e.g. `coingecko_rules.md`) and reference it in your chat with `@workspace #coingecko_rules.md`.
[](https://docs.coingecko.com/docs/ai-prompts#available-prompts)
Available Prompts
--------------------------------------------------------------------------------------
Select the prompt that matches your project’s tech stack.
* 🐍 **[Python](https://docs.coingecko.com/docs/python-ai-prompts)
**: A complete guide for implementing the CoinGecko API using our official [coingecko-sdk](https://pypi.org/project/coingecko-sdk/)
.
* 🟦 **[TypeScript](https://docs.coingecko.com/docs/typescript-ai-prompts#/)
**: The definitive prompt for integrating the CoinGecko API with our official [@coingecko/coingecko-typescript](https://www.npmjs.com/package/@coingecko/coingecko-typescript)
package.
[](https://docs.coingecko.com/docs/ai-prompts#best-practices)
Best Practices
--------------------------------------------------------------------------------
To get the most out of our AI prompts, keep these tips in mind:
* **Be Specific**: After providing the main prompt, give the AI a clear, specific task (e.g. “Write a function to fetch the price of Bitcoin and Ethereum in EUR”).
* **Customize**: Feel free to modify the prompts to fit your project’s unique requirements or coding standards.
* **Version Control**: Store your customized prompts in your repository to ensure your entire team benefits from consistent AI-generated code.
* **Always Review**: Treat AI-generated code as a starting point. Always review it for security, performance, and correctness.
Was this page helpful?
YesNo
[Building with AI](https://docs.coingecko.com/docs/building-with-ai)
[Python AI Prompts](https://docs.coingecko.com/docs/python-ai-prompts)
⌘I
---
# Unknown
\# Changelog Source: https://docs.coingecko.com/changelog Product updates and announcements export const GreenSeparator = () => (
); \## Access Inactive Token Data with New \`include\_inactive\_source\` Parameter 🗓️ \*\*December 16, 2025\*\* We've introduced a new \`include\_inactive\_source\` query parameter across multiple onchain endpoints, enabling you to retrieve data for tokens even when they have no active pools (no valid swaps in the past 7 days). When \`include\_inactive\_source=true\`, the API will source data from the pool with the most recent swap, regardless of how long ago it occurred. This ensures you can still access pricing and volume data for less active and dormant tokens. \*\*Updated endpoints:\*\* \* \[Token Data by Token Address\](/reference/token-data-contract-address) — \`/onchain/networks/../tokens/..\` \* \[Tokens Data by Token Addresses\](/reference/tokens-data-contract-addresses) — \`/onchain/networks/../tokens/multi/..\` \`\`\`json JSON {6} theme={null} ... "volume\_usd": { "h24": "40075650.4943209" }, "market\_cap\_usd": "1544052409.96629", "last\_trade\_timestamp": 1712534400 }, "relationships": { ... \`\`\` \* \[Top Pools by Token Address\](/reference/top-pools-contract-address) — \`/onchain/networks/../tokens/../pools\` \`\`\`json JSON {5} theme={null} ... "h24": "536545444.904535" }, "reserve\_in\_usd": "163988541.3812", "last\_trade\_timestamp": 1712534400 }, "relationships": { ... \`\`\` \* \[Token Price by Token Addresses\](/reference/onchain-simple-price) — \`/onchain/simple/networks/../token\_price/..\` \`\`\`json JSON {6-8} theme={null} ... }, "total\_reserve\_in\_usd": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208" }, "last\_trade\_timestamp": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400 } } ... \`\`\` \* \[Token OHLCV chart by Token Address\](/reference/token-ohlcv-token-address) — \`/onchain/networks/../tokens/../ohlcv/..\` (no changes in payload) \## Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens 🗓️ \*\*December 15, 2025\*\* At CoinGecko, we are committed to providing the most accurate and independent cryptocurrency data in the industry. As the DeFi landscape evolves, so too must our methodologies for tracking and ranking assets. Today, we are announcing an important update regarding how we categorize and rank \*\*rehypothecated tokens\*\* such as wrapped assets and liquid staking tokens to ensure our market capitalization data remains a true reflection of the market’s value. Read \[here\](https://www.coingecko.com/learn/upcoming-changes-to-market-cap-rankings-and-api-for-rehypothecated-tokens) for full details. #### \*\*Important: CoinGecko API Breaking Changes\*\* \*\*Effective Date:\*\* These changes are scheduled to go live on \*\*February 4th, 2026.\*\* \*\*Note:\*\* If your application does not specifically handle rehypothecated tokens, this breaking change is unlikely to affect you, and no action is required. If you are a developer or use our API for data fetching, please pay close attention to the following breaking changes. 1. \*\*Endpoint:\*\* \[/coins/markets\](/reference/coins-markets) \* \*\*Change:\*\* Rehypothecated tokens will be \*\*excluded\*\* from the response list by default. \* \*\*Action:\*\* To keep them in your list, you must include the \`include\_rehypothecated=true\` parameter. \* When a \`category\` parameter is added, all coins including rehypothecated tokens will continue to be returned, however the \`market\_cap\_rank\` field will be \`null\`. 2. \*\*Endpoint:\*\* \[/coins/\\{id}\](/reference/coins-id) \* \*\*Change:\*\* The \`market\_cap\_rank field\` will return \`null\` for rehypothecated tokens. \* \*\*Action:\*\* Use the new \`market\_cap\_rank\_with\_rehypothecated\` field instead. \## New Top Traders by Token Address Endpoint 🗓️ \*\*December 4, 2025\*\* Discover the top traders for any token with the new \[Top Traders by Token Address\](/reference/top-token-traders-token-address) endpoint. This endpoint enables you to monitor whale activity, track significant holders, and analyze trading patterns: \*\*Example payload:\*\* \`\`\`json JSON theme={null} { "data": { "id": "base\_0x6921b130d297cc43754afba22e5eac0fbf8db75b", "type": "top\_trader", "attributes": { "traders": \[ { "address": "0xf748879edbe8cca140940788163d7be4d2a2e46a", "name": "@zimagetsfox", "label": "zimagetsfox.eth", "type": "other", "realized\_pnl\_usd": "1157358.77", "unrealized\_pnl\_usd": "255071.37", "token\_balance": "1454984.43", "average\_buy\_price\_usd": "0.01144", "average\_sell\_price\_usd": "0.03460", "total\_buy\_count": 48, "total\_sell\_count": 109, "total\_buy\_token\_amount": "51422264.86", "total\_sell\_token\_amount": "49967280.42", "total\_buy\_usd": "588308.47", "total\_sell\_usd": "1729021.16", "explorer\_url": "https://etherscan.io/address/0xf748879edbe8cca140940788163d7be4d2a2e46a" } \] } } } \`\`\` \## New Public Treasury Endpoints: Historical Holdings and Transactions History 🗓️ \*\*November 27, 2025\*\* \* Both endpoints support easy ID lookup via respective entity/coin IDs. \* View live data examples on \[https://www.coingecko.com/en/treasuries/companies/strategy\](https://www.coingecko.com/en/treasuries/companies/strategy) ### Track Public Treasury Holdings Over Time with Historical Holdings Endpoint Query historical holdings data for public companies and governments with the new \[Crypto Treasury Holdings Historical Chart Data by ID\](/reference/public-treasury-entity-chart) endpoint. \*\*Example payload:\*\* \`\`\`json JSON theme={null} { "holdings": \[ \[ 1763683200000, 649870.0 \], ... \], "holding\_value\_in\_usd": \[ \[ 1763683200000, 56311217680.033195 \], ... \] } \`\`\` ### Access Transaction History with New Treasury Endpoint Retrieve detailed transaction history for public companies and governments using the new \[Crypto Treasury Transaction History by Entity ID\](/reference/public-treasury-transaction-history) endpoint. \*\*Example payload:\*\* \`\`\`json JSON theme={null} { "transactions": \[ { "date": 1763337600000, "source\_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt27517abcb8f459e3/691aaadfcd08266e2ec6fbe9/form-8-k\_11-17-2025.pdf", "coin\_id": "bitcoin", "type": "buy", "holding\_net\_change": 8178.0, "transaction\_value\_usd": 835554438.0, "holding\_balance": 649870.0, "average\_entry\_value\_usd": 102171.0 } \] } \`\`\` \## GT Community Data for more Pools Endpoints plus Farcaster and Zora Social URL Support 🗓️ \*\*November 15, 2025\*\* ### GT Community Data Now Available across More Pools Endpoints We've expanded GeckoTerminal community data support across multiple pool endpoints. When you set \`include\_gt\_community\_data=true\`, you'll now receive sentiment voting and community reporting data in your API responses. \*\*New fields surfaced:\*\* \`\`\`json JSON {4,5,6} theme={null} ... }, "reserve\_in\_usd": "163988541.3812", "sentiment\_vote\_positive\_percentage": 60, "sentiment\_vote\_negative\_percentage": 40, "community\_sus\_report": 18 }, "relationships": { ... \`\`\` \*\*Improved endpoints:\*\* \* \[Trending Pools List\](/reference/trending-pools-list) — \`/onchain/networks/trending\_pools\` \* \[New Pools by Network\](/reference/latest-pools-network) — \`/onchain/networks/{network}/new\_pools\` \* \[Trending Pools by Network\](/reference/trending-pools-network) — \`/onchain/networks/{network}/trending\_pools\` \* \[Top Pools by Network\](/reference/top-pools-network) — \`/onchain/networks/{network}/pools\` \* \[Top Pools by DEX\](/reference/top-pools-dex) — \`/onchain/networks/{network}/dexes/{dex}/pools\` \* \[New Pools List\](/reference/latest-pools-list) — \`/onchain/new\_pools\` ### Farcaster and Zora Social URLs Support for Token Info Endpoints Farcaster and Zora social URLs are now supported in our token info endpoints. These fields are now surfaced by default alongside existing social links: \`\`\`json JSON {2,3} theme={null} ... "discord\_url": null, "farcaster\_url": null, "zora\_url": null, "telegram\_handle": null, ... \`\`\` \*\*Supported endpoints:\*\* \* \[Token Info by Token Address\](/reference/token-info-contract-address) — \`/onchain/networks/{network}/tokens/{address}/info\` \* \[Pool Tokens Info by Pool Address\](/reference/pool-token-info-contract-address) — \`/onchain/networks/{network}/pools/{pool\_address}/info\` \## True Real-Time Data Update: Cache Removed for Key On-chain Endpoints 🗓️ \*\*November 14, 2025\*\* \\\[Changes below are applicable to all \[paid plan subscribers\](https://www.coingecko.com/en/api/pricing).\] Dear CoinGecko API paid plan subscribers, We're excited to announce a major upgrade to our API, aimed at providing you with direct, instantaneous access to the best real-time data! Starting \*\*02:00 UTC, December 1, 2025\*\*, the 10-second edge cache will be completely removed for the following endpoints. This change means your requests will now pull the freshest data directly from our servers with no cache delay. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :----------------------------------------------------------------------------------------------------------- | :------------------------------------- | :----------------------- | :------------------- | | \[Token Price by Token Addresses\](https://docs.coingecko.com/reference/onchain-simple-price) | Monday, 02:00 UTC, December 1, 2025 | 10s | Real-time (No Cache) | | \[Past 24 Hour Trades by Pool Address\](https://docs.coingecko.com/reference/pool-trades-contract-address) | Tuesday, 02:00 UTC, December 2, 2025 | 10s | Real-time (No Cache) | | \[Past 24 Hour Trades by Token Address\](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Wednesday, 02:00 UTC, December 3, 2025 | 10s | Real-time (No Cache) | \*\*What This Means for You:\*\* \* \*\*True Real-Time Data:\*\* You will now receive the absolute freshest, most up-to-date data with every single request. There is no longer any cache layer to cause a delay. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 10 seconds or more to align with the new cache changes. We're committed to continuously improving your experience and providing the highest quality data. If you have any questions or need assistance, feel free to reach out to soonaik\\@coingecko\\\[dot\]com . \*\*CoinGecko API Team\*\* \## Onchain OHLCV Support Extended to Pools with 3+ Tokens 🗓️ \*\*November 8, 2025\*\* We've expanded our onchain OHLCV endpoints to support pools containing more than 2 tokens. Now you can access liquidity pools with additional token compositions beyond simple pair, such as \[crvUSD/WETH/CRV\](https://www.geckoterminal.com/eth/pools/0x4ebdf703948ddcea3b11f675b4d1fba9d2414a14). \*\*Improved endpoints:\*\* \* \[Pool OHLCV chart by Pool Address\](/reference/pool-ohlcv-contract-address) — \`/onchain/networks/{network}/pools/{pool\_address}/ohlcv/{timeframe}\` \* \[Token OHLCV chart by Token Address\](/reference/token-ohlcv-token-address) — \`/onchain/networks/{network}/tokens/{token\_address}/ohlcv/{timeframe}\` \## Websocket is now supported for Self-serve API subscribers 🗓️ \*\*October 23, 2025\*\* ### CoinGecko Websocket (Beta) is now available for \[paid plan\](https://www.coingecko.com/en/api/pricing) customers (Analyst plan & above)! For Analyst, Lite, Pro, and Pro+ self-serve customers, you are now eligible to access the following Websocket features, and stream real-time data by utilising your monthly API plan credits: \* Max connections: 10 concurrent socket connections \* Max subscriptions: 100 token or pool data subscription per channel, per socket \* Channel Access: \[all 4 channels\](https://docs.coingecko.com/websocket#channel-%26-data-support) \* Credit charge: \*\*0.1\*\* credit per response returned, deducting from monthly API plan credits Please visit \[Websocket\](https://docs.coingecko.com/websocket) for full details, and test out Websocket data streaming. We will gradually improve the Websocket and expand the feature limits. Please share your feedback and suggestion via this \[\*\*survey form\*\*\](https://forms.gle/gNE1Txc9FCV55s7ZA), or email soonaik\\@coingecko\\\[dot\]com . ### Notice: Temporary Disruption on MagicEden data for NFT Endpoints Due to recent updates to MagicEden's API, we are updating our integration. During this period, endpoints for NFT data may be temporarily unavailable or return incomplete information. \## More Bonding Curve Support and New Ascending Sort for Megafilter 🗓️ \*\*October 4, 2025\*\* ### Now supported Bonding Curve (non-graduated) Data for More Endpoints We've added support for bonding curve (e.g. launchpad graduation from PumpFun) data across multiple token endpoints: \* \[Token Data by Token Address\](/reference/token-data-contract-address) — \`/onchain/networks/{network}/tokens/{address}\` \* \[Tokens Data by Token Addresses\](/reference/tokens-data-contract-addresses) — \`/onchain/networks/{network}/tokens/multi/{addresses}\` \* \[Token Info by Token Address\](/reference/token-info-contract-address) — \`/onchain/networks/{network}/tokens/{address}/info\` \* \[Pool Tokens Info by Pool Address\](/reference/pool-token-info-contract-address) — \`/onchain/networks/{network}/pools/{pool\_address}/info\` \`\`\`json JSON theme={null} "launchpad\_details": { "graduation\_percentage": 2.16, "completed": false, "completed\_at": null, "migrated\_destination\_pool\_address": null } \`\`\` ### Megafilter: Ascending Sort Order for Price Change % The \[Megafilter for Pools\](/reference/pools-megafilter) endpoint now supports ascending sorting for price change percentage: \* \`m5\_price\_change\_percentage\_asc\` \* \`h1\_price\_change\_percentage\_asc\` \* \`h6\_price\_change\_percentage\_asc\` \* \`h24\_price\_change\_percentage\_asc\` ### Token OHLCV Endpoint Fix to respect Specified Token Address We've fixed an issue where the \[Token OHLCV chart by Token Address\](/reference/token-ohlcv-token-address) endpoint returned data for the base token of the top pool instead of the requested token. It will now always return data for the specified token address. \## SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support 🗓️ \*\*September 25, 2025\*\* ### Expanded SDK Coverage for Public Treasuries We're broadening our SDK coverage to make treasury-level insights more powerful and easier to access. Check out what's new below (with functions from \[our TypeScript SDK\](https://github.com/coingecko/coingecko-typescript)) \* \[\`publicTreasury.getCoinID(coinID, { ...params })\`\](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury) \\ to query public companies & governments' cryptocurrency holdings by Coin ID \* \[\`publicTreasury.getEntityID(entityID)\`\](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury) \\ to query public companies & governments' cryptocurrency holdings by Entity ID \* \[\`entities.getList({ ...params })\`\](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#entities) \\ to query all the supported entities on CoinGecko with entities ID, name, symbol, and country ### New MCP Tools: Exchanges, NFTs & Multi-Address Queries We're also surfacing new tools through the MCP to give developers a richer, faster way to query exchanges, NFTs, and onchain activity. \* New tools: \* Exchange coverage with \[/exchanges/list\](reference/exchanges-list), \[/exchanges/\](reference/exchanges-id), \[/exchanges//tickers\](reference/exchanges-id-tickers), and \[/exchanges//volume\\\_chart/range\](reference/exchanges-id-volume-chart-range) \* NFT markets with \[/nfts/markets\](reference/nfts-markets) \* Multi-address queries with \[/onchain/networks//pools/multi/\](reference/pools-addresses) and \[/onchain/networks//tokens/multi/\](reference/tokens-data-contract-addresses) \* Retired tools: \* We've removed endpoints such as \[/coins/list\](reference/coins-list), \[/onchain/networks/trending\\\_pools\](reference/trending-pools-network), and single-address pool/token queries in favor of more scalable multi-address endpoints ### Friendlier Time-related MCP Queries with ISO Support Time-based queries just got easier. MCP tools now accept \*\*ISO date strings\*\* (\`YYYY-MM-DD\` or \`YYYY-MM-DDTHH:MM\`) alongside UNIX timestamps. For example, when using the \[Coin Historical Chart Data within Time Range\](reference/coins-id-market-chart-range) tool, you can now pass ISO date strings directly instead of converting them into UNIX timestamps for your LLM tools. \*\*CoinGecko API Team\*\* \## New Crypto Treasury Endpoints and Improvements 🗓️ \*\*September 19, 2025\*\* 1. \[Crypto Treasury Holdings by Coin ID\](https://docs.coingecko.com/reference/companies-public-treasury) endpoint now supports governments and more coins data as seen on \[https://www.coingecko.com/en/treasuries/bitcoin\](https://www.coingecko.com/en/treasuries/bitcoin) 2. \*\*New endpoints:\*\* 1. \[Crypto Treasury Holdings by Entity ID\](https://docs.coingecko.com/reference/public-treasury-entity) 2. \[Entities List (ID Map)\](https://docs.coingecko.com/reference/entities-list) 3. \[Derivatives Exchange Data by ID\](https://docs.coingecko.com/reference/derivatives-exchanges-id) endpoint now supports \`coin\_id\` and \`target\_coin\_id\` to identify coins of ticker pairs. \`\`\`json JSON theme={null} "tickers": \[ { "symbol": "ASTERUSDT", "base": "ASTER", "target": "USDT", "coin\_id": "aster-2", 👈 NEW "target\_coin\_id": "tether" 👈 NEW } \] \`\`\` \## Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More. 🗓️ \*\*September 12, 2025\*\* ### 🚀 Now Supporting Bonding Curve Data Bonding curve data (launchpad graduation) is now supported for the followiing endpoints: \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) \*\*Payload example:\*\* \`\`\`json theme={null} "launchpad\_details": { "graduation\_percentage": 100, "completed": true, "completed\_at": "2024-04-08T16:52:35Z", "migrated\_destination\_pool\_address": "5wNu5QhdpRGrL37ffcd6TMMqZugQgxwafgz477rShtHy" } \`\`\` More endpoints to support bonding curve data soon. ### 🚀 Now Supporting Pooled Token Balance Data The following endpoints now support additional pool token balance data by flagging this parameter \`include\_composition=true\` : \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) \* \[Token Data by Token Address\](https://docs.coingecko.com/reference/token-data-contract-address) (requires \`include=top\_pools\` parameter to be flagged together) \* \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) (requires \`include=top\_pools\` parameter to be flagged together) \*\*Payload example:\*\* \`\`\`json theme={null} "base\_token\_balance": "11700.98", "base\_token\_liquidity\_usd": "29630000", "quote\_token\_balance": "66384614.21", "quote\_token\_liquidity\_usd": "66330000", \`\`\` ### 🚀 Other improvements 1. \[Onchain Megafilter\](https://docs.coingecko.com/reference/pools-megafilter) endpoint now supports more \`sort\` options: \* \`m5\_price\_change\_percentage\_desc\` \* \`h1\_price\_change\_percentage\_desc\` \* \`h6\_price\_change\_percentage\_desc\` \* \`fdv\_usd\_asc\` \* \`fdv\_usd\_desc\` \* \`reserve\_in\_usd\_asc\` \* \`reserve\_in\_usd\_desc\` 2. \[Top Gainers & Losers\](https://docs.coingecko.com/reference/coins-top-gainers-losers) endpoint now supports additional price change percentage data by flagging \`price\_change\_percentage\` parameter. The available options are: \`1h,24h,7d,14d,30d,60d,200d,1y\`. \* Payload example: \`\`\`json theme={null} "usd\_1y\_change": 21740.8866287307, "usd\_1h\_change": -0.279590756868549, "usd\_24h\_change": 3.13876587906131, "usd\_7d\_change": -9.67782096261206, "usd\_14d\_change": -3.39755498745517, "usd\_30d\_change": -13.7768698159765, "usd\_60d\_change": 29.9096824213076, "usd\_200d\_change": 2282.33681679488 \`\`\` 3. \[Exchange Tickers by ID\](https://docs.coingecko.com/reference/exchanges-id-tickers) endpoint now supports to sort tickers based on market cap, by flagging the \`order\` parameter. \* Available options: \`market\_cap\_desc\`, \`market\_cap\_asc\` \## Improved Update Frequency for selected Pro-API On-chain Endpoints 🗓️ \*\*August 18, 2025\*\* \\\[Changes below are applicable to all \[paid plan subscribers\](https://www.coingecko.com/en/api/pricing).\] Dear CoinGecko API paid plan subscribers, We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting \*\*02:00 UTC, September 2, 2025\*\*, the edge cache duration for the following endpoints will be reduced from \\\*\\\*30s \\\*\\\*to \*\*10s\*\*, allowing you to retrieve updated data more frequently. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :----------------------------------------------------------------------------------------------------------- | :-------------------------------------- | :----------------------- | :------------------- | | \[Token Price by Token Addresses\](https://docs.coingecko.com/reference/onchain-simple-price) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | \[Token Data by Token Address\](https://docs.coingecko.com/reference/token-data-contract-address) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s | | \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s | | \[Pool OHLCV chart by Pool Address\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | \[Token OHLCV chart by Token Address\](https://docs.coingecko.com/reference/token-ohlcv-token-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | \[Past 24 Hour Trades by Pool Address\](https://docs.coingecko.com/reference/pool-trades-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | \[Past 24 Hour Trades by Token Address\](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | \*\*What This Means for You:\*\* \* \*\*Fresher Data, Quicker\*\*: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! \* \*\*No Extra Credits for Cached Data\*\*: If your request hits the cache (now updated every 10 seconds for endpoints above), there will be no additional credits charged - just like before. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to \[soonaik@coingecko.com\](mailto:soonaik@coingecko.com) . \*\*CoinGecko API Team\*\* \## Now Supported: Launchpad Data (Pump.fun & More), Granular OHLCV, and Honeypot Info 🗓️ \*\*August 05, 2025\*\* We're excited to announce a major update to our on-chain API endpoints! This release introduces support for popular token launchpads, adds high-frequency OHLCV data, and enhances our honeypot detection capabilities to give you deeper and more timely on-chain insights. ### 🚀 Now Supporting Launchpad Data (Pump.fun & More!) In addition to the 1,600+ DEXes already integrated with GeckoTerminal.com, you can now track token data from popular launchpad platforms directly through the CoinGecko API. More launchpads will be supported soon! \*\*New Supported Launchpads:\*\* | Launchpad | network id (API) | dex id (API) | | :---------------------------------------------------------------------------------------------- | :--------------- | :---------------- | | \[Meteora DBC\](https://www.geckoterminal.com/solana/meteora-dbc/pools) | solana | meteora-dbc | | \[Pump.fun\](https://www.geckoterminal.com/solana/pump-fun/pools) | solana | pump-fun | | \[Raydium Launchpad\](https://www.geckoterminal.com/solana/raydium-launchlab/pools) (LetsBonkFun) | solana | raydium-launchlab | | \[Boop.fun\](https://www.geckoterminal.com/solana/boop-fun/pools) | solana | boop-fun | | \[Virtuals (Base)\](https://www.geckoterminal.com/base/virtuals-base/pools) | base | virtuals-base | \*\*Improved endpoints to track launchpad data:\*\* \* \[Token Data by Token Address\](https://docs.coingecko.com/reference/token-data-contract-address) \* \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) More launchpad-specific data will be supported soon for the endpoints above! \*\*Tips:\*\* use \[megafilter endpoint\](https://docs.coingecko.com/reference/pools-megafilter) to retrieve latest launchpad data, by flagging \`sort=pool\_created\_at\_desc\` \*\*Request example\*\* (Get latest pools on Pump.fun): \`\`\`curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool\_created\_at\_desc&x\_cg\_pro\_api\_key=YOUR\_KEY \`\`\` ### \\\[Pro-API Exclusive\] More Granular OHLCV Data On-chain OHLCV endpoints now support higher frequency intervals, down to 1-second granularity. | Timeframe | Aggregate (Before) | Aggregate (New) | | :-------- | :----------------- | :-------------- | | day | 1 | 1 | | hour | 1, 4, 12 | 1, 4, 12 | | minute | 1, 5, 15 | 1, 5, 15 | | second | n/a | 1, 15, 30 | \*\*Improved Endpoints:\*\* \* \[Pool OHLCV chart by Pool Address\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) \* \[Token OHLCV chart by Token Address\](https://docs.coingecko.com/reference/token-ohlcv-token-address) \*\*New interval supported:\*\* \* 1s \* 15s \* 30s \*\*Example Request (Get the last 100 1-second intervals for a pool on Ethereum):\*\* \`\`\`curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/second?aggregate=1&limit=100&include\_empty\_intervals=false&x\_cg\_pro\_api\_key=YOUR\_KEY \`\`\` ### 🍯 Enhanced Honeypot Information We've expanded our honeypot detection features to provide more comprehensive risk assessment. You can now check if a token is a potential honeypot using the main info endpoints. \*\*Improved Endpoints:\*\* \* \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) \* \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) \*\*Example Payload:\*\* \`\`\`json theme={null} { "mint\_authority": null, "freeze\_authority": null, "is\_honeypot": true // possible values: true / false / unknown } \`\`\` ### \\\[Pro-API Exclusive\] New Filtering Option in Megafilter Previously, the\[Pools Megafilter\](https://docs.coingecko.com/reference/pools-megafilter) endpoint could only show tokens confirmed as \*\*\*not\*\*\* a honeypot (\`checks=no\_honeypot\`). Now, you can also include tokens where the honeypot status is 'unknown'. \* To use this, set \`include\_unknown\_honeypot\_tokens=true\`. \* Important: This parameter only takes effect when \`checks=no\_honeypot\` is also specified in the request. \*\*Example Request (Get trending pools that are not confirmed honeypots, including those with an unknown status):\*\* \`\`\`curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&sort=h6\_trending&checks=no\_honeypot&include\_unknown\_honeypot\_tokens=true&x\_cg\_pro\_api\_key=YOUR\_KEY \`\`\` ### 📈 Expanded Pool Data \*\*Endpoint\*\*: \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) By adding \`include=pool\` to your request on the pool tokens endpoint, you can now retrieve additional context about the pool itself. \* Base and quote token address \* Sentiment vote percentage (positive and negative) \* Community suspicious reports count \*\*Payload Example\*\*: \`\`\`json theme={null} "included": \[ { "id": "eth\_0x06da0fd433c1a5d7a4faa01111c044910a184553", "type": "pool", "attributes": { "base\_token\_address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "quote\_token\_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "sentiment\_vote\_positive\_percentage": 100, "sentiment\_vote\_negative\_percentage": 0, "community\_sus\_report": 0 } } \] \`\`\` \## SOL Currency Is Now Supported for CoinGecko Endpoints 🗓️ \*\*June 19, 2025\*\* We're excited to announce that you can now obtain real-time and historical price & market data for tokens listed on CoinGecko.com, with the option to return data value in \*\*SOL\*\* (Solana) currency. Note: for dates prior to May 2025, 'SOL' historical data is limited to hourly and daily granularity \*\*Improved endpoints:\*\* \* \[Coin Price by IDs\](https://docs.coingecko.com/reference/simple-price) \* \[Coin Price by Token Addresses\](https://docs.coingecko.com/reference/simple-token-price) \* \[Supported Currencies List\](https://docs.coingecko.com/reference/simple-supported-currencies) \* \[Top Gainers & Losers\](https://docs.coingecko.com/reference/coins-top-gainers-losers) \* \[Coins List with Market Data\](https://docs.coingecko.com/reference/coins-markets) \* \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) \* \[Coin Historical Data by ID\](https://docs.coingecko.com/reference/coins-id-history) \* \[Coin Historical Chart Data by ID\](https://docs.coingecko.com/reference/coins-id-market-chart) \* \[Coin Historical Chart Data within Time Range by ID\](https://docs.coingecko.com/reference/coins-id-market-chart-range) \* \[Coin OHLC Chart by ID\](https://docs.coingecko.com/reference/coins-id-ohlc) \* \[Coin OHLC Chart within Time Range by ID\](https://docs.coingecko.com/reference/coins-id-ohlc-range) \* \[Coin Data by Token Address\](https://docs.coingecko.com/reference/coins-contract-address) \* \[Coin Historical Chart Data by Token Address\](https://docs.coingecko.com/reference/contract-address-market-chart) \* \[Coin Historical Chart Data within Time Range by Token Address\](https://docs.coingecko.com/reference/contract-address-market-chart-range) \* \[Trending Search List\](https://docs.coingecko.com/reference/trending-search) \* \[Crypto Global Market Data\](https://docs.coingecko.com/reference/crypto-global) \*\*Example\*\*: price of Bitcoin in Solana, using \[Coin Price by IDs\](https://docs.coingecko.com/reference/simple-price) endpoint. \`\`\`json theme={null} { "bitcoin": { "sol": 720.21 } } \`\`\` \*\*Example:\*\* historical daily price, market cap and volume of Trump in Solana, using \[Coin Historical Chart Data by ID\](https://docs.coingecko.com/reference/coins-id-market-chart) endpoint. \`\`\`json theme={null} { "prices": \[ \[ 1750118400000, 0.0640701365814472 \], \[ 1750204800000, 0.0644263929356261 \], \[ 1750291200000, 0.0639713357587322 \], \[ 1750326151000, 0.06415963364804504 \] \], "market\_caps": \[ \[ 1750118400000, 12843589.584485611 \], \[ 1750204800000, 12882547.839086628 \], \[ 1750291200000, 12793790.726102708 \], \[ 1750326151000, 12826247.390733324 \] \], "total\_volumes": \[ \[ 1750118400000, 2425793.780846796 \], \[ 1750204800000, 2055697.9106767387 \], \[ 1750291200000, 1871087.4334618242 \], \[ 1750326151000, 2008278.189223005 \] \] } \`\`\` \## New Endpoints & Improvements: Historical Token Holders Chart, OHLCV by Token Address, Multi-pool Token Data Support 🗓️ \*\*June 09, 2025\*\* ### \\\[Pro-API Exclusive\] New Endpoint - Historical Token Holders Chart by Token Address This new endpoint allows you to get the historical token holders chart based on the provided token contract address on a network. \* Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin. Check it out now: \[Historical Token Holders Chart by Token Address\](https://docs.coingecko.com/reference/token-holders-chart-token-address) ### \\\[Pro-API Exclusive\] New Endpoint - Token OHLCV chart by Token Address This endpoint allows you to get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network. \* This endpoint will return OHLCV data of the most liquid pool of the specified token. You may use this endpoint Top Pools by Token Address to check the top pools of a token. Check it out now: \[Token OHLCV chart by Token Address\](https://docs.coingecko.com/reference/token-ohlcv-token-address#/) ### Improved Endpoints - Support Multi-pool Token Data Previously, we only surfaced 1 quote token for pools with more than 2 tokens. With this new improvements, for pools that have 2 or more tokens: \* Extra quote tokens being listed under a new key \`relationships.quote\_tokens\` \* If \`include=quote\_token\` is flagged, the extra quote tokens will be also listed under \`included\` \`\`\`json theme={null} "relationships": { "base\_token": { "data": { "id": "eth\_0x40d16fc0246ad3160ccc09b8d0d3a2cd28ae6c2f", "type": "token" } }, "quote\_token": { "data": { "id": "eth\_0x8353157092ed8be69a9df8f95af097bbf33cb2af", "type": "token" } }, "quote\_tokens": { "data": \[ { "id": "eth\_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" }, { "id": "eth\_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token" } \`\`\` This improvement is applicable to all onchain pool endpoints that support \`relationships.quote\_token\`, including but not limited to: \* \[Top Pools by Token Address\](https://docs.coingecko.com/reference/top-pools-contract-address#/) \* \[Search Pools\](https://docs.coingecko.com/reference/search-pools#/) \* \[Megafilter for Pools\](https://docs.coingecko.com/reference/pools-megafilter#/) \* \[Trending Pools List\](https://docs.coingecko.com/reference/trending-pools-list#/) \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address#/) \* \[Top Pools by Network\](https://docs.coingecko.com/reference/top-pools-network#/) \* \[New Pools List\](https://docs.coingecko.com/reference/latest-pools-list#/) \## Upcoming Change Notice: Removal of normalized\\\_volume\\\_btc Data 🗓️ \*\*May 30, 2025\*\* \*\*\`Notice: Upcoming Change to CoinGecko API Endpoints - Removal ofnormalized\_volume\_btc Data\`\*\* \*\*Effective Date: 16 June 2025\*\* \*\*Affected Endpoints:\*\* \* \[Exchange Data by ID\](https://docs.coingecko.com/reference/exchanges-id) \* \[Exchanges List with Data\](https://docs.coingecko.com/reference/exchanges#/) \*\*Details of the Change:\*\* Please be advised that the \`normalized\_volume\_btc\` data point will be removed from the above-listed API endpoints, effective 16 June 2025. This change is being implemented due to significant recent change to a 3rd party data source provider, which have fundamentally altered how this specific data can be accessed. Example of Affected Data Structure: \`\`\`json theme={null} { "trade\_volume\_24h\_btc\_normalized": 47765.5886637453 }, \`\`\` After the effective date, the \`trade\_volume\_24h\_btc\_normalized\` field will no longer be present in the API responses for these endpoints. \*\*Action Required:\*\* If your applications or integrations currently rely on the \`trade\_volume\_24h\_btc\_normalized\` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 16 June 2025 to avoid potential errors or data discrepancies. \## New Endpoint & Improvements: On-Chain Trades, Net Buy Volume, and More 🗓️ \*\*May 29, 2025\*\* ### \\\[Pro-API Exclusive\] New Endpoint - On-chain Trades by Token Address Previously, the \[Past 24 Hour Trades by Pool Address\](https://docs.coingecko.com/reference/pool-trades-contract-address) endpoint allows you to retrieve the last 300 trades of a specific pool only. With this new endpoint \[Past 24 Hour Trades by Token Address\](https://docs.coingecko.com/reference/token-trades-contract-address), you can now retrieve the last 300 trades \*\*across different pools\*\*, based on the provided \*\*token contract address\*\* on a network. ### Improved Endpoints - Support Net Buy Volume Data The following endpoints now support more volume breakdown data: \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses#/) By flagging \`include\_volume\_breakdown=true\` , you can surface the following data: \* net\\\_buy\\\_volume\\\_usd \* buy\\\_volume\\\_usd \* sell\\\_volume\\\_usd Sample Response: \`\`\`json JSON theme={null} { "data": { "id": "eth\_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { ... }, "net\_buy\_volume\_usd": { "m5": "-40796.577553965", "m15": "-69765.771189161", "m30": "-88014.095440243", "h1": "0.000000000000", "h6": "1884879.921855301", "h24": "17555422.243003801" }, "buy\_volume\_usd": { "m5": "30597.433165473", "m15": "139531.542378324", "m30": "396063.429481099", "h1": "969922.728762430", "h6": "10366839.570204150", "h24": "52666266.729011402" }, "sell\_volume\_usd": { "m5": "71394.010719438", "m15": "209297.313567485", "m30": "484077.524921342", "h1": "969922.728762430", "h6": "8481959.648348849", "h24": "35110844.486007601" }, \`\`\` ### Improved Endpoint - On-Chain OHLCV endpoint \[Pool OHLCV chart by Pool Address\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) endpoint now supports to include empty intervals by flagging \`include\_empty\_intervals=true\` . \* By default, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded (or \*\*skipped\*\*) from the response. \* This new parameter option provides the flexibility to get \*\*padded\*\* data, when there's no trade data. Sample Response: \`\`\`json theme={null} { "data": { "id": "81da0682-1c4f-445a-9bed-9b5454004df5", "type": "ohlcv\_request\_response", "attributes": { "ohlcv\_list": \[ \[ 1744712700, 0.000212149802253853, 0.000212173305907688, 0.000212149802253853, 0.000212173305907688, 46.48164903882 \], \[ 1744712400, 0.000212149802253853, 👈 O — Follow previous Close value 0.000212149802253853, 👈 H — Follow previous Close value 0.000212149802253853, 👈 L — Follow previous Close value 0.000212149802253853, 👈 C — Follow previous Close value 0.0 👈 V — Set to zero \], \[ 1744712100, 0.000210532522666822, 0.000212149802253853, 0.000210532522666822, 0.000212149802253853, 👈 Previous Close value 46.4765 \], ... } \`\`\` ### Improved Endpoints - Support Large Images The following endpoints now support more size options for coin logo image: \* \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) \* \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-addres) Sample Response: \`\`\`json theme={null} "data": { "id": "eth\_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token", "attributes": { ... "image\_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", "image": { "thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661", "small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", "large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661" }, \`\`\` ### Improved Endpoints - Support Normalized Supply Data The following endpoints now support \`normalized\_total\_supply\`: \* \[Token Data by Token Address\](https://docs.coingecko.com/reference/token-data-contract-address) \* \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) Sample Response: \`\`\`json theme={null} "decimals": 6, "total\_supply": "49999156520373530.0", "normalized\_total\_supply": "49999156520.37353", \`\`\` ### Improved Endpoints - Support Pool 'Name' and 'Fee' Data The following endpoints now support \`pool\_name\` and \`pool\_fee\`: \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) Sample Response: \`\`\`json theme={null} "name": "WETH / USDC 0.05%", "pool\_name": "WETH / USDC", "pool\_fee\_percentage": "0.05", \`\`\` ### Improved Endpoints - Support Symbols of DEX Pairs The following endpoints now allow to flag \`dex\_pair\_format=symbol\` to return DEX pair symbols instead of contract address. \* \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) \* \[Coin Tickers by ID\](https://docs.coingecko.com/reference/coins-id-tickers) \* \[Exchange Tickers by ID\](https://docs.coingecko.com/reference/exchanges-id-tickers) \* \[Exchange Data by ID\](https://docs.coingecko.com/reference/exchanges-id) Sample Response: \`\`\`json theme={null} // before { "base": "0X8FC8F8269EBCA376D046CE292DC7EAC40C8D358A", "target": "0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48", "market": { "name": "Uniswap V2 (Ethereum)", "identifier": "uniswap\_v2", ... } // now when "dex\_pair\_format=symbol" is flagged { "base": "DFI", "target": "USDC", "market": { "name": "Uniswap V2 (Ethereum)", "identifier": "uniswap\_v2", ... } \`\`\` \## New Endpoint & Improvements: On-Chain Trending Data, Enhanced Trending Search, and Improved Token Lookup 🗓️ \*\*April 25, 2025\*\* ### \\\[Pro-API Exclusive\] New Endpoint - On-chain Trending Search Data With this new endpoint \[Trending Search Pools\](https://docs.coingecko.com/reference/trending-search-pools), you can now retrieve the on-chain trending search pools and tokens data, as seen on GeckoTerminal.com . By default, this endpoint returns the top 4 trending pools data, you may specify the \`pools\` parameter to retrieve up to top 10 pools data. Tips: you may flag \`include=base\_token\` to retrieve the trending tokens data. Note: this exclusive endpoint is available for our API \[paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). ### \\\[Pro-API Exclusive\] Improved Endpoint - Trending Search List \[Paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above) can now use \[Trending Search List\](https://docs.coingecko.com/reference/trending-search) endpoint and flag \`show\_max\` parameter to retrieve more trending coins, NFTs and coin categories on CoinGecko.com. | Trending Data | Public API (Demo plan) | Paid API (Analyst plan & above) | | :-------------- | :--------------------- | :------------------------------ | | Coins | 15 | 30 | | NFTs | 7 | 10 | | Coin Categories | 6 | 10 | ### Improved Endpoints - Support Token Lookup by Symbol and Name The following endpoints now support token lookup by symbol and name, in addition to the existing API ID support: \* \[Coin Price by IDs and Symbols\](https://docs.coingecko.com/reference/simple-price) \* \[Coins List with Market Data\](https://docs.coingecko.com/reference/coins-markets) Previously, these endpoints only supported token lookup by \\\[API IDs\]\\(\[https://docs.coingecko.com/docs/1-get-data-by-id-or-address#/methods-to-query-price--market-data-of-coins\](https://docs.coingecko.com/docs/1-get-data-by-id-or-address#/methods-to-query-price--market-data-of-coins\\)). This enhancement streamlines token data retrieval and eliminates the need for manual coin ID mapping. Example Mapping: | API Ids | Symbol | Name | | :------- | :----- | :------ | | bitcoin | btc | Bitcoin | | tether | usdt | Tether | | usd-coin | usdc | USDC | Lookup Priority: When multiple lookup parameters are provided, the system applies the following priority order: id (highest) > name > symbol (lowest). \*\*\`Filtering by Symbol withinclude\_tokens\`\*\* The \`include\_tokens\`parameter has been added to provide flexibility when filtering by symbol: \* \`include\_tokens=top\` : Returns only the top market cap token for the specified symbol. \* \`include\_tokens=all\`: Returns all tokens that share the specified symbol. Example Request & Data: | Request Example | Token Data Returned | Remarks | | :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | pro-api.coingecko.com/api/v3/coins/markets?vs\\\_currency=usd\\&symbols=btc\\&include\\\_tokens=top | 1. Bitcoin | When symbols and 'include\\\_tokens=\*\*top\*\*' is specified, only the top market cap tokens will be returned. | | pro-api.coingecko.com/api/v3/coins/markets?vs\\\_currency=usd\\&symbols=btc\\&include\\\_tokens=all | 1. Bitcoin \
2\. Osmosis allBTC \
3\. atcat \
4\. Meld Bridged BTC (Meld) \
5\. BlackrockTradingCurrency | When symbols and 'include\\\_tokens=\*\*all\*\*' is specified, all the coins that share the same symbol will be returned. \
\
All the 5 coins stated in the example have the same symbol 'btc'. | ### /coins/markets Endpoint Improvement We've enhanced the\`/coins/markets\` endpoint \[Coins List with Market Data\](https://docs.coingecko.com/reference/coins-markets), by including 'total' and 'per-page' values in the Response Headers. This addition to the Response Headers enables developers to identify the total number of active coins on coingecko.com and specify the required pagination to retrieve all available data. \`\`\`Text Response Header (Example) theme={null} per-page: 250 total:16989 \`\`\` \## Upcoming Change Notice: Removal of twitter\\\_followers Data 🗓️ \*\*April 25, 2025\*\* \*\*\`Notice: Upcoming Change to CoinGecko API Endpoints - Removal oftwitter\_followers Data\`\*\* \*\*Effective Date: 15 May 2025\*\* \*\*Affected Endpoints:\*\* \* \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) \* \[Coin Data by Token Address\](https://docs.coingecko.com/reference/coins-contract-address) \* \[Coin Historical Data by ID\](https://docs.coingecko.com/reference/coins-id-history) \*\*Details of the Change:\*\* Please be advised that the \`twitter\_followers\` data point within the \`community\_data\` object will be removed from the above-listed API endpoints, effective 15 May 2025. This change is being implemented due to significant recent changes to the X (formerly Twitter) API, which have fundamentally altered how this specific data can be accessed. Example of Affected Data Structure: \`\`\`json theme={null} "community\_data": { "twitter\_followers": 7694251, // ... other community data points ... } \`\`\` After the effective date, the \`twitter\_followers\` field will no longer be present in the API responses for these endpoints. \*\*Action Required:\*\* If your applications or integrations currently rely on the \`twitter\_followers\` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 15 May 2025 to avoid potential errors or data discrepancies. \*\*\`Important Note Regarding Previously Storedtwitter\_followers Data:\`\*\* Please be aware that if you have previously stored \`twitter\_followers\` data obtained from the CoinGecko API and archived it within your own systems, you are solely responsible for its continued use and any implications thereof. We appreciate your understanding as we adapt to changes in third-party platforms to maintain the stability and reliability of our API. If you have any questions or require further clarification, please do not hesitate to contact our support team. \## New Endpoint & Multiple Improvements: On-Chain Top Token Holder Address, Security Data, Historical Supply. 🗓️ \*\*March 28, 2025\*\* ### \\\[Pro-API Exclusive\] New Endpoint - Top Token Holder Address Data You can now access the top 50 token holder address data for tokens, as seen on GeckoTerminal.com. By default, this endpoint returns the top 10 holders data, you can also specify the \`holders\` parameter to retrieve up to top 50 holders data. \*\*Network supported:\*\* \* EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base \* Solana \* Sui \* TON \* Ronin 👉 Visit the endpoint reference page - \[Top Token Holders by Token Address\](https://docs.coingecko.com/reference/top-token-holders-token-address) to learn more and try it out now! \*\*Note:\*\* this exclusive endpoint is available for our API \[paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). \* The holders data is currently in \*\*Beta\*\*, with ongoing improvements to data quality, coverage, and update frequency. \* For Solana tokens, the maximum number of retrievable top holders data is 40 instead of 50. \*\*Tips:\*\* You may also use the following endpoints to retrieve \*\*token holders count\*\* and \*\*top holders distribution percentage data\*\*: \* \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) \* \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) ### Historical Supply endpoints - Support for Inactive Coins You may now access historical total and circulating supply data of inactive coins using the following endpoints. To check for list of inactive coins, you may use \[Coin List (ID Map)\](https://docs.coingecko.com/reference/coins-list) endpoint and flag \`status=inactive\`. Note: these endpoints below are exclusive for \[Enterprise plan\](https://www.coingecko.com/en/api/pricing) customers only. \*\*Improved endpoints:\*\* \* \[Circulating Supply Chart by ID\](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) \* \[Circulating Supply Chart within Time Range by ID\](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) \* \[Total Supply Chart by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart) \* \[Total Supply Chart within time range by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) ### Onchain Pool Data endpoints - Locked Liquidity Now support \*\*\`locked\_liquidity\_percentage\`\*\* data. \*\*Improved endpoints:\*\* \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) \`\`\`json theme={null} { "data": \[ { "id": "eth\_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { "base\_token\_price\_usd": "3653.12491645176", "base\_token\_price\_native\_currency": "1.0", .. "volume\_usd": { "m5": "868581.7348314", "h1": "16798158.0138526", "h6": "164054610.850188", "h24": "536545444.904535" }, "reserve\_in\_usd": "163988541.3812", "locked\_liquidity\_percentage": "99.82" }, \`\`\` ### Onchain Token Info endpoints - GT Score, Mint Authority, Freeze Authority The following Token Info endpoints now provide more security related information: \* \*\*GeckoTerminal Score Details\*\* - Learn more about GT Score \[here\](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). \* \*\*Pool\*\* - Combination of pool signals such as honeypot risk, buy/sell tax, proxy contract, liquidity amount, and whether the liquidity is locked. \* \*\*Transaction\*\* - Total number of transactions and trading volume in the last 24 hours. \* \*\*Creation\*\* - Age of the pool since creation. The longer, the better it is for the score. \* \*\*Info\*\* - Submitted social info and metadata to the token. \* \*\*Holders\*\* - Distribution of tokens among unique addresses. \* \*\*Mint Authority\*\* \* \*\*Freeze Authority\*\* \*\*Improved endpoints:\*\* \* \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) \* \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) \`\`\`json theme={null} "gt\_score": 92.6605504587156, "gt\_score\_details": { "pool": 0, "transaction": 32.2, "creation": 0, "info": 0, "holders": 0 } "mint\_authority": "no", "freeze\_authority": "no" \`\`\` ### Onchain Simple Token Price endpoint - Market Cap to FDV Fallback The \[Onchain Simple Token Price\](https://docs.coingecko.com/reference/onchain-simple-price) endpoint now supports fallback option for Market Cap to return FDV value, when the Market Cap value is not available. Notes: \* If the token's market cap is not verified by the CoinGecko team, the onchain endpoints 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. If you require the Market Cap key (\`market\_cap\_usd\`) to return FDV value (as seen on GeckoTerminal.com) when Market Cap data is unavailable, please specify this parameter \`marketcap\_fdv\_fallback=true\`. \## Update Frequency Improvements for selected Pro-API endpoints (March 2025) 🗓️ \*\*March 14, 2025\*\* \\\[Changes below are applicable to Analyst/Lite/Pro/Enterprise \[plan subscribers\](https://www.coingecko.com/en/api/pricing) only.\] Dear CoinGecko API paid plan subscribers, We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting \*\*02:00 UTC, March 25, 2025\*\*, the edge cache duration for the following endpoints will be reduced from 60s to 30s, allowing you to retrieve updated data more frequently. 1. Effective from 02:00 UTC, March 25, 2025: 1. \[Trending Pools List\](https://docs.coingecko.com/reference/trending-pools-list) 2. \[Trending Pools by Network\](https://docs.coingecko.com/reference/trending-pools-network) 3. \[Top Pools by Network\](https://docs.coingecko.com/reference/top-pools-network) 4. \[Top Pools by Dex\](https://docs.coingecko.com/reference/top-pools-dex) 2. Effective from 02:00 UTC, March 26, 2025: 1. \[New Pools by Network\](https://docs.coingecko.com/reference/latest-pools-network) 2. \[New Pools List\](https://docs.coingecko.com/reference/latest-pools-list) 3. \[ Megafilter for Pools\](https://docs.coingecko.com/reference/pools-megafilter) 4. \[Search Pools\](https://docs.coingecko.com/reference/search-pools) 3. Effective from 02:00 UTC, March 27, 2025: 1. \[Top Pools by Token Address\](https://docs.coingecko.com/reference/top-pools-contract-address) 2. \[Most Recently Updated Tokens List\](https://docs.coingecko.com/reference/tokens-info-recent-updated) 3. \[Pools by Category ID\](https://docs.coingecko.com/reference/pools-category) \*\*What This Means for You:\*\* \* \*\*Fresher Data, Quicker\*\*: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! \* \*\*No Extra Credits for Cached Data\*\*: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits charged—just like before. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to \[soonaik@coingecko.com\](mailto:soonaik@coingecko.com) . \*\*CoinGecko API Team\*\* \## Multiple Improvement: Holders data, Pool Stats, Simple Token Price 🗓️ \*\*March 14, 2025\*\* ### Onchain Token Info endpoints - Holders data Now support the following holder data \*\*(Beta)\*\*: \* holders count \* top holders distribution percentage \*\*Improved endpoints:\*\* \* \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) \* \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) \`\`\`json theme={null} "holders": { "count": 1432761, "distribution\_percentage": { "top\_10": "1.3019", "11\_20": "0.1024", "21\_40": "0.095", "rest": "98.5007" }, "last\_updated": "2025-03-06T01:21:18Z" \`\`\` ### Onchain Pool Data endpoints - More Data Support Now support the following data: \* \`price\_change\_percentage\`: m15, m30 \* \`volume\_usd\`: m15, m30 \* \`transactions\`: h6 \*\*Improved endpoints:\*\* \* \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) \* \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) \`\`\`json theme={null} "price\_change\_percentage": { "m5": "0.06", "m15": "0.06", "m30": "0.89", "h1": "-4.31", "h6": "-1.02", "h24": "3.32" }, "transactions": { "m5": { "buys": 0, "sells": 2, "buyers": 0, "sellers": 2 }, "m15": { "buys": 0, "sells": 2, "buyers": 0, "sellers": 2 }, "m30": { "buys": 0, "sells": 3, "buyers": 0, "sellers": 3 }, "h1": { "buys": 1, "sells": 23, "buyers": 1, "sellers": 7 }, "h6": { "buys": 60, "sells": 38, "buyers": 23, "sellers": 18 }, "h24": { "buys": 206, "sells": 138, "buyers": 96, "sellers": 77 } }, "volume\_usd": { "m5": "130.5119858698", "m15": "130.5119858698", "m30": "177.109036156", "h1": "4942.2463835639", "h6": "28362.2127269542", "h24": "112426.585893123" } \`\`\` ### Onchain Simple Token Price endpoint - Liquidity & Price Change Percentage data Now supports the following optional parameter to return more data. \* \`include\_24hr\_price\_change\` (24hr price change percentage) \* \`include\_total\_reverse\_in\_usd\` (token liquidity data - total liquidity portion attributable to a specific token across all available pools) \*\*Improved Endpoint:\*\* \* \[Token Price by Token Addresses\](https://docs.coingecko.com/reference/onchain-simple-price) \`\`\`json theme={null} { "data": { "id": "e58258f7-8368-4968-bbe1-b5343540cd71", "type": "simple\_token\_price", "attributes": { "token\_prices": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00276143983565", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3175.22870146126" }, "market\_cap\_usd": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "25000000000", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "500000000000" }, "h24\_volume\_usd": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "50000000", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10000000000" }, "h24\_price\_change\_percentage": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "-0.15", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1.15" }, "total\_reserve\_in\_usd": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "417994486.4342195821530162288", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "417994486.4342195821530162288" } } } \`\`\` \## New Megafilter Endpoint, 200+ Chains Supported: Hyperliquid, Abstract, Berachain & MOAR! 🗓️ \*\*February 27, 2025\*\* Powered by GeckoTerminal, the CoinGecko API now supports on-chain data across \*\*200+ blockchain networks\*\*, including the latest additions: Hyperliquid, HyperEVM, Abstract, Berachain, Story, Monad, Unichain, and Soneium. While we offer the widest on-chain data coverage, we understand that you may have specific needs when slicing and dicing data for your use case. That's why we're introducing Megafilter, an exclusive endpoint available for our API paid plan subscribers (Analyst plan & above). ### 🔥 What's Megafilter? This new endpoint provides unmatched flexibility, allowing you to query and filter data exactly the way you want. 🔗 Docs: \[Megafilter for Pools\](https://docs.coingecko.com/reference/pools-megafilter) ### 👀 What Can You Do? With the /megafilter endpoint, you can slice and dice on-chain data your way across: \* 200+ blockchain networks, 1,400+ dexes, 6M+ pools, and 5M+ tokens \* Advanced filtering options based on liquidity, FDV, volume, transactions, buy/sell trends, and time range \* Custom sorting, including trending pools (5m), newest pools, or liquidity growth \* Fraud detection filters: Exclude honeypots, check GT Score, verify CG listings, and track social metrics Here's some quick examples: \* Track fresh pools on Uniswap V4 & Aerodrome with liquidity above \\$1,000 \* Discover trending DEX pools across Solana, Base, and other chains with a high GT Score. \* Filter out risky pools with built-in honeypot protection & fraud checks \* Customize data retrieval based on your strategy: time-based, volume-based, or trend-driven ### Try it out now! 🚀 API Docs: \[Megafilter for Pools\](https://docs.coingecko.com/reference/pools-megafilter)\\ 🔗 Live Filtering on \[GeckoTerminal\](https://www.geckoterminal.com/) \## Update Frequency Improvements for selected Pro-API endpoints 🗓️ \*\*February 14, 2025\*\* \\\[Changes below are applicable to Analyst/Lite/Pro/Enterprise \[plan subscribers\](https://www.coingecko.com/en/api/pricing) only.\] Dear CoinGecko API paid plan subscribers, We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting \*\*02:00 UTC, February 24, 2025\*\*, the edge cache duration for the following endpoints will be reduced to 30s, allowing you to retrieve updated data more frequently. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- | :----------------------- | :------------------- | | Onchain \[/networks/../tokens/\](https://docs.coingecko.com/reference/token-data-contract-address) | 02:00 UTC, February 24, 2025 | 60s | 30s | | Onchain \[/networks/../tokens/multi/\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | 06:00 UTC, February 24, 2025 | 60s | 30s | | Onchain \[/networks/../pools/../ohlcv\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 25, 2025 - Enterprise plan subscribers only | 60s | 30s | | Onchain \[/networks/../pools/../ohlcv\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 26, 2025 - Analyst/Lite/Pro plan subscribers | 60s | 30s | \*\*What This Means for You:\*\* \* \*\*Fresher Data, Quicker\*\*: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! \* \*\*No Extra Credits for Cached Data\*\*: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits charged—just like before. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to \[soonaik@coingecko.com\](mailto:soonaik@coingecko.com) . \*\*CoinGecko API Team\*\* \## Enhanced Onchain Metadata, Increased Max Address Limit for Multi Endpoints, Improved Exchange Tickers Sorting 🗓️ \*\*February 09, 2025\*\* ### Onchain Metadata: Improved Coverage \*\*Previously:\*\* Payload may return 'missing.png' for \`image\_url\` for tokens that do not have image data. \*\*Now:\*\* Coverage of metadata (images, websites, description, socials) is now improved for tokens on Solana, Ton, Base, and Sui networks. For tokens that do not contain image data, 'null' value will be returned for \`image\_url\`. \*\*Improved endpoints with image data:\*\* 1. \[Trending Pools List\](https://docs.coingecko.com/reference/trending-pools-list) 2. \[Trending Pools by Network\](https://docs.coingecko.com/reference/trending-pools-network) 3. \[Specific Pool Data by Pool Address\](https://docs.coingecko.com/reference/pool-address) 4. \[Multiple Pools Data by Pool Addresses\](https://docs.coingecko.com/reference/pools-addresses) 5. \[Top Pools by Network\](https://docs.coingecko.com/reference/top-pools-network) 6. \[Top Pools by Dex\](https://docs.coingecko.com/reference/top-pools-dex) 7. \[New Pools by Network\](https://docs.coingecko.com/reference/latest-pools-network) 8. \[New Pools List\](https://docs.coingecko.com/reference/latest-pools-list) 9. \[Search Pools\](https://docs.coingecko.com/reference/search-pools) 10. \[Top Pools by Token Address\](https://docs.coingecko.com/reference/top-pools-contract-address) 11. \[Token Data by Token Address\](https://docs.coingecko.com/reference/token-data-contract-address) 12. \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) 13. \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) 14. \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) 15. \[Most Recently Updated Tokens List\](https://docs.coingecko.com/reference/tokens-info-recent-updated) \*\*Improved endpoints with metadata (images, websites, description, socials):\*\* 1. \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) 2. \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) 3. \[Most Recently Updated Tokens List\](https://docs.coingecko.com/reference/tokens-info-recent-updated) Note: Metadata 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: \* \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) \* \[Coin Data by Token Address\](https://docs.coingecko.com/reference/coins-contract-address) ### Improved Max Address Limit for onchain /multi endpoints \*\*Previously:\*\* Onchain /multi endpoints support up to 30 token or pool contract addresses per request. \*\*Now:\*\* Onchain /multi endpoints support up to 50 token or pool contract addresses per request. \*\*Improved endpoints:\*\* 1. \[Tokens Data by Token Addresses\](https://docs.coingecko.com/reference/tokens-data-contract-addresses) 2. \[Multiple Pools Data by Pool Addresses \](https://docs.coingecko.com/reference/pools-addresses) Note: this new max address input limit is exclusive for paid plan subscribers (Analyst plan & above) only. ### Improved Data Consistency for Exchange Tickers by ID For \[Exchange Tickers by ID\](https://docs.coingecko.com/reference/exchanges-id-tickers) endpoint, the order is sorted by \*\*trust\\\_score\\\_desc\*\* by default. \* Sometimes duplicate or missing data may occur due to paginated cached response, especially when a ticker's rank changes between 2 paginated requests, e.g. it might shift from Page 2 to Page 1, vice versa. \* We've added a new \`order\` option: \*\*base\\\_target\*\*, which will sort the tickers by \*\*base\*\* symbol, then \*\*target\*\* symbol, in lexicographical order, i.e. \`0->9\`, then \`a->Z\`. Example: flagging ?order=base\\\_target \`\`\` pro-api.coingecko.com/api/v3/exchanges/binance/tickers?order=base\_target \`\`\` This sorting method ensures stable pagination, reducing issues where cached responses may cause duplicate or missing tickers across pages. \## Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter 🗓️ \*\*January 27, 2025\*\* ### Onchain Pools Data: Supports more than 10 pages of data \*\*Previously:\*\* There was a limitation of a maximum of 10 pages for accessing pools data in the related endpoints. \*\*Now:\*\* All paid plan subscribers (Analyst & above) can access more than 10 pages of pools data for the endpoints below. \*\*Improved Endpoints:\*\* 1. \[Search Pools\](https://docs.coingecko.com/reference/search-pools) 2. \[Top Pools by Token Address\](https://docs.coingecko.com/reference/top-pools-contract-address) 3. \[Trending Pools List\](https://docs.coingecko.com/reference/trending-pools-list) 4. \[Trending Pools by Network\](https://docs.coingecko.com/reference/trending-pools-network) 5. \[New Pools by Network\](https://docs.coingecko.com/reference/latest-pools-network) 6. \[New Pools List\](https://docs.coingecko.com/reference/latest-pools-list) 7. \[Top Pools by Network\](https://docs.coingecko.com/reference/top-pools-network) 8. \[Top Pools by Dex\](https://docs.coingecko.com/reference/top-pools-dex) ### Onchain Trades: Added Token Filter \*\*Endpoint:\*\* \[Past 24 Hour Trades by Pool Address\](https://docs.coingecko.com/reference/pool-trades-contract-address) \*\*Previously:\*\* There was no way to filter trades data by base or quote token. \*\*Now\*\*: A new optional parameter has been added to allow filtering by base or quote token of a pool. \* Parameter: \`token\` \* Value options: \* \`base\` \* \`quote\` \* \`{token\_address}\` \*\*Example\*\*: \`\`\`json Example theme={null} ?token=base // get the trades data of base token ?token=quote // get the trades data of quote token ?token=8FqXr6dw5NHA2TtwFeDz6q9p7y9uWyoEdZmpXqqUpump // get the trades data of specific token based on address \`\`\` \## Multiple Improvements: Onchain Token Price, NFT Market Cap 🗓️ \*\*January 24, 2025\*\* ### Onchain Simple Token Price: Added Market Cap and 24h Volume Data \*\*Endpoint:\*\* \[Token Price by Token Addresses\](https://docs.coingecko.com/reference/onchain-simple-price) \* You can now flag \`include\_market\_cap=true\` and \`include\_24hr\_vol=true\` to retrieve market cap and 24h trading volume data. e.g. \`\`\`json json theme={null} { "data": { "id": "e1979db1-5c3e-4ba8-b103-cb0258af4a7c", "type": "simple\_token\_price", "attributes": { "token\_prices": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "0.999365729816931", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3399.24368371279" }, "market\_cap\_usd": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "51963214441.24363", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10005535878.50094" }, "h24\_volume\_usd": { "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "2095689865.85327", "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2544539948.02599" } } } } \`\`\` ### NFT Data: Added 'Market Cap Rank' You can now obtain the \`market\_cap\_rank\` data of NFT collections via the following endpoints: \* \[NFTs Collection Data by ID\](https://docs.coingecko.com/reference/nfts-id) \* \[NFTs Collection Data by Contract Address\](https://docs.coingecko.com/reference/nfts-contract-address) \`\`\`json example theme={null} "market\_cap\_rank": 75, \`\`\` \## Removal of Unsupported Categories 🗓️ \*\*January 23, 2025\*\* ### Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API We are announcing the removal of certain categories from CoinGecko and CoinGecko API. These categories will no longer be supported across all API endpoints starting \*\*February 12, 2025\*\*. | No | Category Name | Category ID | | :- | :--------------------- | :------------------ | | 1 | US Election 2020 | us-election-2020 | | 2 | Governance | governance | | 3 | Cryptocurrency | cryptocurrency | | 4 | Technology and Science | technology-science | | 5 | Presale Meme | presale-meme-coins | | 6 | Business Platform | business-platform | | 7 | Number | number | | 8 | Structured Product | structured-products | | 9 | Investment | investment | | 10 | Niftex Shards | niftex-shards | | 11 | Ethereum POW IOU | ethereum-pow-iou | | 12 | Mirrored Assets | mirrored-assets | | 13 | Remittance | remittance | | 14 | Protocol | protocol | | 15 | Unicly Ecosystem | utokens | | 16 | Finance and Banking | finance-banking | | 17 | Eth 2.0 Staking | eth-2-0-staking | \*\*Reason for Removal:\*\* Many of these categories no longer have associated coins. Some categories are outdated and no longer relevant in the crypto space. The changes align with updated category topology standards to maintain data accuracy and relevance. \*\*Impact:\*\* API responses for the \`/coins/markets\` \[endpoint\](https://docs.coingecko.com/reference/coins-markets) will no longer support data of the categories above. Any requests specifying these categories will return an error. \*\*Action Required:\*\* Ensure applications using the \`/coins/markets\` \[endpoint\](https://docs.coingecko.com/reference/coins-markets) are not querying these removed categories. Please update any code or documentation referencing these categories to prevent errors. \## Extended Historical Data for Onchain OHLCV Endpoint 🗓️ \*\*January 15, 2025\*\* We've improved the \[Pool OHLCV Chart by Pool Address\](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) endpoint to provide access to a much broader range of historical data. \*\*Key Updates\*\* \* \*\*Previous Behavior:\*\* Users could only query data for the past 6 months from today. \* \*\*New Behavior\*\*: Users can now access data from September 2021 to the present, depending on the pool's tracking start date on GeckoTerminal. \* Each API request is \*\*limited to a 6-month date range\*\*, but users can query older data by using the before\\\_timestamp parameter. Note: access to data beyond the past 6 months is only available to \[Paid Plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). \*\*Action Required\*\* No changes are required for existing integrations. However, users who need data beyond the past 6 months should adjust their queries to use the \`before\_timestamp\` parameter to fetch additional data. \## Update to Total Supply of POW Coins 🗓️ \*\*January 15, 2025\*\* \*\*What's Changing?\*\* We are updating the definition of Total Supply for PoW (Proof-of-Work) coins to reflect the actual number of mined coins rather than the maximum supply. This change ensures consistency and accuracy in representing the supply data. \*\*Key Updates\*\* \* \*\*Previous Behavior:\*\* \* Total Supply: Displayed as the maximum possible supply (e.g., Bitcoin: 21,000,000). \* \*\*New Behavior:\*\* \* Total Supply: Now reflects the actual number of mined coins.\\ For example: Bitcoin: \\~19,500,000 (as of January 2025). This update will also affect historical Total Supply data for consistency. This change applies to all affected PoW coins, including Bitcoin, Bitcoin Cash, Litecoin, Ethereum Classic, and more. \*\*Affected endpoints\*\* that contain "total\\\_supply" data: \* \*\*Current Data\*\* \* \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) \* \[Coins List with Market Data\](https://docs.coingecko.com/reference/coins-markets) \* \*\*Historical Darta\*\* \* \[Total Supply Chart by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart) \* \[Total Supply chart within time range by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) \*\*Timeline:\*\* \*\*Bitcoin:\*\* Updated on Jan 14, 2025 \*\*Other PoW Coins\*\*: Scheduled for Jan 22, 2025 \* \[Bitcoin Cash\](https://www.coingecko.com/en/coins/bitcoin-cash) \* \[Litecoin\](https://www.coingecko.com/en/coins/litecoin) \* \[Ethereum Classic\](https://www.coingecko.com/en/coins/ethereum-classic) \* \[Bitcoin SV\](https://www.coingecko.com/en/coins/bitcoin-sv) \* \[Zcash\](https://www.coingecko.com/en/coins/zcash) \* \[eCash\](https://www.coingecko.com/en/coins/ecash) \* \[Dash\](https://www.coingecko.com/en/coins/dash) \* \[Verus Coin\](https://www.coingecko.com/en/coins/verus-coin) \* \[Ravencoin\](https://www.coingecko.com/en/coins/ravencoin) \* \[Kadena\](https://www.coingecko.com/en/coins/kadena) \* \[Decred\](https://www.coingecko.com/en/coins/decred) \* \[Flux (Zelcash)\](https://www.coingecko.com/en/coins/flux-zelcash) \* \[DigiByte\](https://www.coingecko.com/en/coins/digibyte) \* \[Quantum Resistant Ledger\](https://www.coingecko.com/en/coins/quantum-resistant-ledger) \* \[Komodo\](https://www.coingecko.com/en/coins/komodo) \* \[Groestlcoin\](https://www.coingecko.com/en/coins/groestlcoin) \* \[Firo\](https://www.coingecko.com/en/coins/firo) \* \[Litecoin Cash\](https://www.coingecko.com/en/coins/litecoin-cash) \* \[LuckyCoin\](https://www.coingecko.com/en/coins/luckycoin) \* \[Enecuum\](https://www.coingecko.com/en/coins/enecuum) \* \[Wownero\](https://www.coingecko.com/en/coins/wownero) \* \[Radiant\](https://www.coingecko.com/en/coins/radiant) \* \[Tidecoin\](https://www.coingecko.com/en/coins/tidecoin) \* \[Handshake\](https://www.coingecko.com/en/coins/handshake) \* \[Neoxa\](https://www.coingecko.com/en/coins/neoxa) \* \[Vertcoin\](https://www.coingecko.com/en/coins/vertcoin) \* \[Feathercoin\](https://www.coingecko.com/en/coins/feathercoin) \* \[Bitcore\](https://www.coingecko.com/en/coins/bitcore) \* \[Phoenixcoin\](https://www.coingecko.com/en/coins/phoenixcoin) \* \[BitcoinZ\](https://www.coingecko.com/en/coins/bitcoinz) \* \[Hush\](https://www.coingecko.com/en/coins/hush) \* \[DigitalNote\](https://www.coingecko.com/en/coins/digitalnote) \* \[EquityPay\](https://www.coingecko.com/en/coins/equitypay) \* \[Evadore\](https://www.coingecko.com/en/coins/evadore) \* \[Swap\](https://www.coingecko.com/en/coins/swap) \* \[DeVault\](https://www.coingecko.com/en/coins/devault) \* \[AXE\](https://www.coingecko.com/en/coins/axe) \* \[Iridium\](https://www.coingecko.com/en/coins/iridium) \* \[X-Cash\](https://www.coingecko.com/en/coins/x-cash) \* \[Bolivarcoin\](https://www.coingecko.com/en/coins/bolivarcoin) \* \[uPlexa\](https://www.coingecko.com/en/coins/uplexa) \* \[WorldCoin (WDC)\](https://www.coingecko.com/en/coins/worldcoin-wdc) \## Improved Update Frequency for selected Pro-API endpoints 🗓️ \*\*January 13, 2025\*\* \\\[Changes below are applicable to Analyst/Lite/Pro/Enterprise \[plan subscribers\](https://www.coingecko.com/en/api/pricing) only.\] The edge cache duration for the following endpoints are now reduced to 20-30s, allowing you to retrieve updated data more frequently. | Endpoints | Previous Update Frequency | Current Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :------------------------ | :----------------------- | | CoinGecko \[/simple/price\](https://docs.coingecko.com/reference/simple-price) | 30s | 20s | | CoinGecko \[/simple/token\\\_price\](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s | | Onchain \[/simple/networks/../token\\\_price\](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s | | Onchain \[/networks/../pools/../trades\](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s | | Onchain \[/networks/../pools/..\](https://docs.coingecko.com/reference/pool-address) | 60s | 30s | | Onchain \[/networks/../pools/multi/..\](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s | \*\*What This Means for You:\*\* \* \*\*Fresher Data, Quicker\*\*: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! \* \*\*No Extra Credits for Cached Data\*\*: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits charged—just like before. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to \[soonaik@coingecko.com\](mailto:soonaik@coingecko.com) . \*\*CoinGecko API Team\*\* \## Improved 5-minutely data for Historical Chart Data endpoints 🗓️ \*\*January 09, 2025\*\* For the following 4 historical chart endpoints, the data of the \*last 48 hours from now\* is no longer excluded. \* \[Coin Historical Chart Data by ID\](https://docs.coingecko.com/reference/coins-id-market-chart) \* \[Coin Historical Chart Data within Time Range by ID\](https://docs.coingecko.com/reference/coins-id-market-chart-range) \* \[Coin Historical Chart Data by Token Address\](https://docs.coingecko.com/reference/contract-address-market-chart) \* \[Coin Historical Chart Data within Time Range by Token Address\](https://docs.coingecko.com/reference/contract-address-market-chart-range) \*\*Note:\*\* The \*\*5-minutely\*\* and \*\*hourly\*\* interval params are exclusively available to Enterprise plan subscribers, bypassing auto-granularity: \* \`interval=5m\`: 5-minutely historical data, supports up to any 10 days date range per request. \* \`interval=hourly\`: hourly historical data, supports up to any 100 days date range per request. \* \*\*Data availability:\*\* \* \`interval=5m\`: Available from 9 February 2018 onwards \* \`interval=hourly\`: Available from 30 Jan 2018 onwards For non-Enterprise plan subscribers who would like to get hourly data, please leave the \`interval\` params empty for auto granularity: \* 1 day from current time = 5-minutely data \* 1 day from any time (except current time) = hourly data \* 2 - 90 days from any time = hourly data \* above 90 days from any time = daily data (00:00 UTC) \## Added: Onchain Categories Data, CG data improvements 🗓️ \*\*December 24, 2024\*\* ### NEW: Onchain Categories : Get Categories on GeckoTerminal.com This new \[Categories List\](https://docs.coingecko.com/reference/categories-list) endpoint allows you to query all the categories supported on GeckoTerminal.com such as 'Pump Fun' and 'Animal'. \* This endpoint is exclusively available for \[Analyst/Lite/Pro/Enterprise plan\](https://www.coingecko.com/en/api/pricing) subscribers only. ### NEW: Onchain Catergory Pools: Get Pools of a specific Category This new \[Pools by Category ID\](https://docs.coingecko.com/reference/pools-category) endpoint allows you to query all the pools of a specific category on GeckoTerminal.com. \* This endpoint is exclusively available for \[Analyst/Lite/Pro/Enterprise plan\](https://www.coingecko.com/en/api/pricing) subscribers only. \* You can also obtain tokens of a specific category, by flagging \`include=base\_token\` ### Onchain Token Info: Added Categories Data You can now obtain the categories of a token via the following endpoints: 1. \[Token Info by Token Address\](https://docs.coingecko.com/reference/token-info-contract-address) 2. \[Pool Tokens Info by Pool Address\](https://docs.coingecko.com/reference/pool-token-info-contract-address) Payload example: \`\`\`yaml json theme={null} "categories": \[ "Doge", "Baby", "Animal" \], "gt\_category\_ids": \[ "doge", "baby", "animal" \`\`\` ### Onchain New Pools Data: Bug Fixed Previously, this \[/networks/new\\\_pools\](https://docs.coingecko.com/reference/latest-pools-network) endpoint omitted new pools that are created within the last 24 hours. It now returns all newly created pools in the last 48 hours. ### CoinGecko Exchange Data: Added support of inactive exchange id You now query the the list of id of delisted exchanges with \[Exchanges List (ID Map)\](https://docs.coingecko.com/reference/exchanges-list) endpoint, by flagging \`status=inactive \` Payload example: \`\`\`yaml json theme={null} { "id": "ftx", "name": "FTX (Derivatives)" }, { "id": "ftx\_spot", "name": "FTX" }, { "id": "ftx\_tr", "name": "FTX TR" }, { "id": "ftx\_us", "name": "FTX.US" }, \`\`\` \*\*Tips\*\*: you may query to get historical volume delisted exchanges for via the following endpoints: \* \[Exchange Volume Chart by ID\](https://docs.coingecko.com/reference/exchanges-id-volume-chart) \* \[Exchange Volume Chart within Time Range by ID\](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range) ### CoinGecko Historical Chart Data: Faster Last UTC Day (00:00) Data Update For \[Coin Historical Chart Data by ID\](https://docs.coingecko.com/reference/coins-id-market-chart) endpoint, the last completed UTC day (00:00) data is now available \*\*10 minutes after midnight\*\* on the next UTC day (00:10). Previously, the last completed UTC day (00:00) was only made available \*\*35 minutes\*\* after midnight. \## \\\[Updated: Q4 2024\] CoinGecko Asset Issuance Standardisation Initiative Updates 🗓️ \*\*December 17, 2024\*\* As part of our commitment to improving data quality and enhancing the consistency of asset information, we are rolling out an asset standardization initiative at CoinGecko. \*\*What is asset standardization?\*\*\\ Standardization involves refining how we classify and display assets. By systematically organizing asset listings into more precise categories - such as native, bridged, or wrapped tokens each following specific naming conventions, we aim to eliminate confusion and enhance data reliability. \*\*What changes should I expect?\*\*\\ The most notable change is that non-native token contracts previously grouped under native asset listings will now be assigned their own distinct pages. For example, a bridged version of USDT that might have been aggregated under the original, native USDT page, will now be featured on a dedicated page specifically for that bridged variant. Additionally, there may be varying levels of changes in various aggregated data points of the standardized assets, including trading volume, supply, market cap rankings, etc., due to misplaced contracts being transitioned away from the original page to accurately reflect their true metrics. \*\*Focus for Q3 2024\*\* \*\*\\\[Completed ✅\]\*\* \* \[Wrapped Bitcoin (WBTC)\](https://www.coingecko.com/en/coins/wrapped-bitcoin) \* \[Wrapped Ethereum (WETH)\](https://www.coingecko.com/en/coins/weth) \* \[Dai (DAI)\](https://www.coingecko.com/en/coins/dai) \\\*\\\*For full list of FAQs and updated infomation, please refer \[here\](https://support.coingecko.com/hc/en-us/articles/35555248857497-CoinGecko-Asset-Issuance-Standardisation-Initiative-Updates-and-FAQ) ### What's New in Q4 2024? 👈 Building on Q3's achievements, we're expanding the scope of Standardization to include four additional Coins this quarter, selected based on their significance and impact on the DeFi ecosystem. \* \[Frax (FRAX)\](https://www.coingecko.com/en/coins/frax) \* \[Wrapped AVAX (WAVAX)\](https://www.coingecko.com/en/coins/wrapped-avax) \* \[Wrapped BNB (WBNB)\](https://www.coingecko.com/en/coins/wbnb) \* \[Wrapped stETH (wstETH)\](https://www.coingecko.com/en/coins/wrapped-steth) ### Tips and FAQs for API users #### \*\*1. How does this affect my current API setup?\*\* The following CoinGecko API endpoints will be impacted, with full details tracked in \[this spreadsheet\](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing). We encourage you to make the necessary adjustments and enable edit notifications on the Google Sheets, to receive real-time updates when non-native token contracts have been successfully standardized. \*\*Simple\*\* \* /simple/price \* /simple/token\\\_price/id \*\*Coins\*\* \* /coins/markets \* /coins/id \* /coins/id/tickers \* /coins/id/history \* /coins/id/market\\\_chart \* /coins/id/market\\\_chart/range \* /coins/id/ohlc \* /coins/id/ohlc/range \* /coins/id/circulating\\\_supply\\\_chart \* /coins/id/circulating\\\_supply\\\_chart/range \* /coins/id/total\\\_supply\\\_chart \* /coins/id/total\\\_supply\\\_chart/range \*\*Contract\*\* \* /coins/id/contract/contract\\\_address \* /coins/id/contract/contract\\\_address/market\\\_chart \* /coins/id/contract/contract\\\_address/market\\\_chart/range \*\*Exchange\*\* \* /exchanges/id/tickers \* /exchanges/id/volume\\\_chart \* /exchanges/id/volume\\\_chart/range #### \*\*2. Do I have to make changes to my API?\*\* \*\*No changes are necessary\*\* if you do not need data for non-native token contracts that will be separated away from the native tokens. #### \*\*3. What will happen to the coins that are separated into a new coin page?\*\* Historical data for new non-native or bridged assets will only be available from the date of asset page creation (i.e. stnadardized). To access historical data prior to the asset standardization, we recommend retrieving data from the original native assets. #### \*\*4. How do I identify the list of coins that will be separated?\*\* For a finalised list of token contracts and API IDs that have been separated from its native asset page and listed individually, please refer to this \[Google Sheets\](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing) You may also identify the list of bridged coins via API: you may also use \[/categories/list endpoint\](/reference/coins-categories-list) to look for bridged categories such as: 1. bridged-usdc 2. bridged-wbtc 3. bridged-weth Then you may use \[/coins/market endpoint\](/reference/coins-markets) to retrieve the list of coins \## Enhancing Your Access to Even Fresher Data! 🗓️ \*\*December 16, 2024\*\* \\\[Changes below are applicable to Analyst/Lite/Pro/Enterprise \[plan subscribers\](https://www.coingecko.com/en/api/pricing) only.\] \*\*Dear CoinGecko API paid plan subscribers,\*\* We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting \*\*02:00 UTC, January 13, 2025\*\*, the edge cache duration for the following endpoints will be reduced to 20-30s, allowing you to retrieve updated data more frequently. | Endpoints | Current Update Frequency | New Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :----------------------- | :------------------- | | CoinGecko \[/simple/price\](https://docs.coingecko.com/reference/simple-price) | 30s | 20s | | CoinGecko \[/simple/token\\\_price\](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s | | Onchain \[/simple/networks/../token\\\_price\](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s | | Onchain \[/networks/../pools/../trades\](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s | | Onchain \[/networks/../pools/..\](https://docs.coingecko.com/reference/pool-address) | 60s | 30s | | Onchain \[/networks/../pools/multi/..\](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s | \*\*What This Means for You:\*\* \* \*\*Fresher Data, Quicker\*\*: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! \* \*\*No Extra Credits for Cached Data\*\*: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits charged—just like before. \*\*Things to Keep in Mind:\*\* \* If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. \* To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to \[soonaik@coingecko.com\](mailto:soonaik@coingecko.com) . \*\*CoinGecko API Team\*\* \## Multiple Improvements: Onchain Trending Pools, CG New Currencies Support, Snapshot, Exchange Info 🗓️ \*\*December 15, 2024\*\* ### Onchain Trending Pools: Added Support to Filter by Duration You can now query trending pools with the following endpoints, and filter them by different duration: 5m, 1h, 6h, 24h, using \`duration\` parameter. e.g. \`duration=5m\` \* \[Trending Pools List\](https://docs.coingecko.com/reference/trending-pools-list): query all the trending pools across all networks on GeckoTerminal \* \[Trending Pools by Network\](https://docs.coingecko.com/reference/trending-pools-network): query the trending pools based on the provided network ### CG Coin Prices: Added Support for New Fiat Currencies You can now query coin prices in the 13 new currencies for the following 3 endpoints: \* \[Coin Price by IDs\](https://docs.coingecko.com/reference/simple-price): query latest price in selected currencies, by coin id \* \[Coin Price by Token Addresses\](https://docs.coingecko.com/reference/simple-token-price): query latest price in selected currencies, by token address \* \[BTC-to-Currency Exchange Rates\](https://docs.coingecko.com/reference/exchange-rates): query BTC exchange rates with other currencies \*\*New supported currencies:\*\* 1. Colombia | COP 2. Kenya | KES 3. Romania | RON 4. Dominican Republic | DOP 5. Costa Rica | CRC 6. Honduras | HNL 7. Zambia | ZMW 8. El Salvador | SVC 9. Bosnia and Herzegovina | BAM 10. Peru | PEN 11. Guatemala | GTQ 12. Lebanon | LBP 13. Armenian Dram | AMD ### CG Coin Info: Included Snapshot URL \[Coin Data by ID\](https://docs.coingecko.com/reference/coins-id) now includes Snapshot link, e.g. \`\`\`asp json theme={null} "snapshot\_url": "https://snapshot.org/#/lido-snapshot.eth", \`\`\` ### CG Exchange Info: Included Number of Coins and Pairs \[https://docs.coingecko.com/reference/exchanges-id\](https://docs.coingecko.com/reference/exchanges-id) now includes "coins" and "pairs", e.g. \`\`\`asp json theme={null} "coins": 384, "pairs": 1281, \`\`\` \## Multiple Improvements: Onchain Simple Price, Onchain Recently Updated Info, NFT Collection Data 🗓️ \*\*October 09, 2024\*\* ### Onchain: Simple Price - Increased Token Address Limit from 30 to 100 \[Token Price by Token Addresses\](/reference/onchain-simple-price) now allows to input up to 100 contract addresses, instead of 30. \* You may now retrieve data of up to 100 token prices of a specific network, in one single request. \* Available exclusively to Pro API paid plan subscribers. ### Onchain: Recently Updated Info - Added Filter by Network \[Most Recently Updated Token List\](/reference/tokens-info-recent-updated) now allows to filter by blockchain network, by flagging the \`network\` parameter. e.g. \`network=eth\`. \* You can use the \`network\` parameter to retrieve the 100 most recently updated token info of a specific network. \* View list of supported network via \[Supported Networks List\](https://docs.coingecko.com/reference/networks-list) endpoint. ### NFT Collection Data - Included Banner Image \[NFTs Collection Data by ID\](/reference/nfts-id) now provides banner image of a NFT collection. View banner image \[example\](https://coin-images.coingecko.com/nft\_contracts/images/38/pudgy-penguins-banner.png?1708416126) on: \[https://www.coingecko.com/en/nft/pudgy-penguins\](https://www.coingecko.com/en/nft/pudgy-penguins) \`\`\`json theme={null} { "symbol": "PPG", "image": { "small": "https://coin-images.coingecko.com/nft\_contracts/images/38/small/da64989d9762c8a61b3c65917edfdf97.png?1707287183" }, "banner\_image": "https://coin-images.coingecko.com/nft\_contracts/images/38/pudgy-penguins-banner.png?1708416126", .. \`\`\` \## Multiple Improvements: Global Market Chart, Asset Platforms, Coin Categories, Historical Supply Chart 🗓️ \*\*September 26, 2024\*\* ### Global Market Chart - Improved Daily Data Update Previously, for \[Global Market Cap Chart Data endpoint\](https://docs.coingecko.com/reference/global-market-cap-chart) , the daily data is returned at 23:00 UTC. We've made improvement to return daily data at 00:00 UTC. The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). The cache will \*\*always expire at 00:05 UTC\*\*. If you wish to get the latest daily data (00:00 UTC), you can make request at 00:05 UTC or later. ### Asset Platforms - Included Images of Blockchain Network Logos \[Asset Platforms List (ID Map)\](/reference/asset-platforms-list) now provides the logos of blockchain networks. For example: \`\`\`json theme={null} "image": { "thumb": "https://coin-images.coingecko.com/asset\_platforms/images/93/thumb/AN\_logomark.png?1706606703", "small": "https://coin-images.coingecko.com/asset\_platforms/images/93/small/AN\_logomark.png?1706606703", "large": "https://coin-images.coingecko.com/asset\_platforms/images/93/large/AN\_logomark.png?1706606703" } \`\`\` ### Coins Categories - Included Ids of Top 3 Coins \[Coins Categories List with Market Data\](/reference/coins-categories) now provides coins id of the top 3 coins of a category. For example: \`\`\`json theme={null} "top\_3\_coins\_id": \[ "bitcoin", "ethereum", "binancecoin" \], \`\`\` ### Circulating Supply Chart and Total Supply Chart - Fixed '0' data issue For the following \*\*Enterprise-plan\*\* exclusive endpoints below, there was a bug that returned wrong '0' value in the payload. This is fixed and will no longer return wrong '0' value in the payload. 1. \[👑 Circulating Supply Chart by ID\](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) 2. \[👑 Circulating Supply chart within Time Range by ID\](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) 3. \[👑 Total Supply Chart by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart) 4. \[👑 Total Supply Chart within time range by ID\](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) \## Improvement of update frequency for OHLC endpoints 🗓️ \*\*September 04, 2024\*\* The cache & update frequency of the following endpoints have been improved from every 30 minutes to every 15 minutes: \* \[/coins//ohlc\](/reference/coins-id-ohlc) \* \[/coins//ohlc/range\](/reference/coins-id-ohlc-range) \## Included new fields - NFT data 🗓️ \*\*August 18, 2024\*\* We've added 'user\\\_favorites\\\_count', and 'ath' (all-time-high) related data to the following NFT endpoints: \* \[/nfts/\](/reference/nfts-id) \* \[/nfts//contract/\](/reference/nfts-contract-address) \*\*Example of responses:\*\* \`\`\`json theme={null} { "user\_favorites\_count": 3660, "ath": { "native\_currency": 22.9, "usd": 67535 }, "ath\_change\_percentage": { "native\_currency": -59.825327510917, "usd": -64.3396788440525 }, "ath\_date": { "native\_currency": "2024-02-17T09:25:05.056Z", "usd": "2024-02-29T11:45:08.150Z" } \`\`\` \## Introduced /coins/id/ohlc/range endpoint 🗓️ \*\*May 10, 2024\*\* We've introduced a new endpoint \[/coins//ohlc/range\](/reference/coins-id-ohlc-range). 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. Please note that this endpoint is available exclusively for \*\*paid plan subscribers only\*\*. \## Added interval hourly params to /coins/id/ohlc 🗓️ \*\*May 04, 2024\*\* We've expanded functionality to include support for the \`interval=hourly\` parameter within the \[/coins//ohlc\](/reference/coins-id-ohlc) endpoint. Users can use this parameter to retrieve OHLC (Open/High/Low/Close) data on a hourly interval for up to 90 days of the date range. Example of endpoint request: \`https://pro-api.coingecko.com/api/v3/coins/bitcoin/ohlc?vs\_currency=usd&days=1&interval=hourly&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` \## Added support for inactive coins in /coins/list and historical data endpoints 🗓️ \*\*April 30, 2024\*\* We've now enhanced the \[/coins/list\](/reference/coins-list) endpoint to include inactive coins \* You may access the inactive coins by specifying \`status=inactive\` in your query \* Example of endpoint request:\\ \`https://pro-api.coingecko.com/api/v3/coins/list?include\_platform=false&status=inactive&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` Additionally, historical data for inactive coins can be queried using their IDs in the following endpoints: \* \[/coins//history\](/reference/coins-id-history) \* \[/coins//market\\\_chart\](/reference/coins-id-market-chart) \* \[/coins//market\\\_chart/range\](/reference/coins-id-market-chart-range) \* \[/coins//contract//market\\\_chart\](/reference/contract-address-market-chart) \* \[/coins//contract//market\\\_chart/range\](/reference/contract-address-market-chart-range) Please note that these features are available exclusively for \*\*paid plan subscribers only\*\* \## Introduced /key endpoint 🗓️ \*\*March 27, 2024\*\* We've introduced a new endpoint \[/key\](/reference/api-usage) for conveniently monitoring your account's API usage, including rate limits and remaining credits. \*\*Example of responses\*\*: \`\`\`json theme={null} { "plan": "Other", "rate\_limit\_request\_per\_minute": 1000, "monthly\_call\_credit": 1000000, "current\_total\_monthly\_calls": 307, "current\_remaining\_monthly\_calls": 999693 } \`\`\` \## Multiple Improvements (Onchain/GT) 🗓️ \*\*February 28, 2024\*\* \* image\\\_url is now returned in the token response for pools and tokens endpoints: Example of responses: \`\`\`json JSON theme={null} "data": { "id": "eth\_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token", "attributes": { "address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "name": "Tether USD", "symbol": "USDT", "image\_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", 👈 ...... "market\_cap\_usd": "100719721661.467" }, "relationships": {} } \`\`\` \* We've added sorting parameters such as order= \`h24\_volume\_usd\_desc\` and order=\` h24\_tx\_count\_desc\` for /pools endpoints \* The 'token' parameter within the \[/ohlcv \](/reference/pool-ohlcv-contract-address) endpoint can now accept a token address, provided it exists in the queried pool, to return OHLCV data\\ Example of endpoint request (\*\*token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\*\*):\\ \`https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/day?token=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` \* \[/ohlcv \](/reference/pool-ohlcv-contract-address) endpoint now includes the base and target token metadata in the response\\ Example of responses: \`\`\`json JSON theme={null} { "data": { "id": "46303eb4-fba1-44f3-a3c8-c542e4cd5d1a", "type": "ohlcv\_request\_response", "attributes": { "ohlcv\_list": \[\] } }, "meta": { "base": { "address": "0xdac17f958d2ee523a2206206994597c13d831ec7", "name": "Tether USD", "symbol": "USDT", "coingecko\_coin\_id": "tether" }, "quote": { "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "name": "Wrapped Ether", "symbol": "WETH", "coingecko\_coin\_id": "weth" } } } \`\`\` \## Introduced /networks/network/trending\\\_pools endpoint (Onchain/GT) 🗓️ \*\*February 19, 2024\*\* Trending Pools endpoint, \[/networks//trending\\\_pools\](/reference/trending-pools-network) is now available to fetch a list of pools that are trending as seen on GeckoTerminal based on web visits and on-chain activities. \## Introduced /search/pools endpoint (Onchain/GT) 🗓️ \*\*February 19, 2024\*\* Added new endpoint to search for pools /search/pools based on keywords passed into query. \## Included new field for /coins/id endpoint 🗓️ \*\*January 18, 2024\*\* We've included a new field "whitepaper" under "links" section for \[/coins/\](/reference/coins-id) endpoint \*\*Example of responses:\*\* \`\`\`json theme={null} { "id": "bitcoin", ...... "links": { "homepage": \[\], "whitepaper": "https://bitcoin.org/bitcoin.pdf", 👈 "blockchain\_site": \[\], "official\_forum\_url": \[\], "chat\_url": \[\], "announcement\_url": \[\], "twitter\_screen\_name": "bitcoin", "facebook\_username": "bitcoins", "bitcointalk\_thread\_identifier": null, "telegram\_channel\_identifier": "", "subreddit\_url": "https://www.reddit.com/r/Bitcoin/", "repos\_url": {} }, ....... } \`\`\` \## Deprecated response fields for /coins/id 🗓️ \*\*December 13, 2023\*\* The following data is now deprecated for \[/coins/\](/reference/coins-id) endpoint: \* coingecko\\\_rank \* coingecko\\\_score \* developer\\\_score \* community\\\_score \* liquidity\\\_score \* public\\\_interest\\\_score \* public\\\_interest\\\_stats \* alexa\\\_rank \* bing\\\_matches \## Introduced new historical total supply endpoints 🗓️ \*\*December 12, 2023\*\* We've introduced Historical Total Supply data to Enterprise plan subscribers via these 2 exclusive endpoints: \* \[/coins//total\\\_supply\\\_chart\](/reference/coins-id-total-supply-chart) : get historical total supply of a coin, by number of days away from now. \* \[/coins//total\\\_supply\\\_chart/range\](/reference/coins-id-total-supply-chart-range) : get historical total supply of a coin, within a range of timestamp. \## Included more trending coins 🗓️ \*\*December 07, 2023\*\* We've expanded the capabilities of the \[/search/trending\](/reference/trending-search) endpoint. It now supports up to 15 trending coins, a significant increase from the previous limit of 7. \## Improvement on pool data (Onchain/GT) 🗓️ \*\*December 03, 2023\*\* Pool data now returns transaction stats for the last 1 hour. Unique buyers and sellers in the last 1 hour and 24 hours are now returned in the response \## Multiple Improvements 🗓️ \*\*November 21, 2023\*\* The web\\\_slug data is now available in the following endpoints. \* \[/coins/\](/reference/coins-id) \* \[/coins//contract/\](/reference/coins-contract-address) This addition allows users to accurately link to a CoinGecko coin page using \[www.coingecko.com/en/\](http://www.coingecko.com/en/\\{web\_slug}). \*\*Example of responses:\*\* \`\`\`Text JSON theme={null} { "id": "bitcoin", "symbol": "btc", "name": "Bitcoin", "web\_slug": "bitcoin", 👈 ...... "tickers": \[...\] } \`\`\` For the \[/asset\\\_platforms\](/reference/asset-platforms-list) endpoint, we've introduced the native\\\_coin\\\_id data. This enables users to obtain the coin ID of different blockchain networks or asset platforms that may not have a contract address to look up \*\*Example of responses:\*\* \`\`\`Text JSON theme={null} { "id": "polygon-pos", "chain\_identifier": 137, "name": "Polygon POS", "shortname": "MATIC", "native\_coin\_id": "matic-network" 👈 }, \`\`\` \## Introduced /simple/networks/network/token\\\_price/addresses endpoint (Onchain/GT) 🗓️ \*\*November 10, 2023\*\* Inspired by CoinGecko API most popular endpoint, we have launched the \[/simple/networks//token\\\_price/\](/reference/onchain-simple-price), simple endpoint. Simply pass in addresses of any tokens on supported blockchain and get price data for it \## Introduced /networks/network/pools/pool\\\_address/trades endpoint (Onchain/GT) 🗓️ \*\*November 08, 2023\*\* You can now get the latest 300 trades in the past 24 hours of a given pool from this endpoint \[/networks//pools//trades\](/reference/pool-trades-contract-address). You may optionally filter by trade size as well. You can now build your own telegram bot alert! \## Introduced new endpoints (Onchain/GT) 🗓️ \*\*October 23, 2023\*\* You can now fetch token information such as name, image, social links, and description via these endpoints: \* To fetch information of tokens inside a pool, use \[/networks//pools//info\](/reference/pool-token-info-contract-address) \* To fetch information of a specific token use \[/networks//tokens//info\](/reference/token-info-contract-address) \* If you like to get token information of the most recently updated tokens, use \[/tokens/info\\\_recently\\\_updated\](/reference/tokens-info-recent-updated) \## Included new fields (Onchain/GT) 🗓️ \*\*September 11, 2023\*\* Pool response data now returns price in the base and quote token of the pool base\\\_token\\\_price\\\_quote\\\_token and quote\\\_token\\\_price\\\_base\\\_token for your convenience without the need to do additional calculation to derive these values \## Introduced new endpoints (Onchain/GT) 🗓️ \*\*September 06, 2023\*\* Added new endpoints to allow querying multiple pools and tokens in a single API call. /networks/network/pools/multi/addresses and /networks/network/tokens/multi/addresses \## Included new fields (Onchain/GT) 🗓️ \*\*June 23, 2023\*\* \* More data added to the Pool response such as FDV, market cap (from CoinGecko if available), price change percentage, volume, number of buy/sell transactions \* More data added when querying for token such as FDV, volume, market cap, and the top 3 pools \## Introduced precision params for other endpoints 🗓️ \*\*June 15, 2023\*\* The uses of 'precision' parameter allows to specify price data in full or 0-18 decimals, and previously was only made available for \[/simple/price\](/reference/simple-price) and \[/simple/token\\\_price/\](/reference/simple-token-price) endpoints. This parameter is now supported for more endpoints as listed below: \* \[/coins/markets\](/reference/coins-markets) \* \[/coins/market\\\_chart\](/reference/coins-id-market-chart) \* \[/coins/market\\\_chart/range\](/reference/coins-id-market-chart) \* \[/coins//contract//market\\\_chart\](/reference/contract-address-market-chart) \* \[/coins//contract//market\\\_chart/range\](/reference/contract-address-market-chart-range) \* \[/coins//ohlc\](/reference/coins-id-ohlc) \## Multiple Improvements 🗓️ \*\*June 01, 2023\*\* We've made enhancements to the /search/trending and /coins/asset\\\_platform\\\_id/contract/contract\\\_address endpoints: \* Top 5 trending NFT data (based on high trading volume in the last 24 hours) is now included in the \[/search/trending\](/reference/trending-search) endpoint \* Near Protocol contract address (e.g. wrap.near) is now supported for \[/coins//contract/ \](/reference/coins-contract-address) endpoint \## Multiple Improvements (Onchain/GT) 🗓️ \*\*May 28, 2023\*\* \* Token metadata such as name, symbol, and CoinGecko ID are now returned in the responses for pools endpoints. Users will need to pass in this attribute include=base\\\_token, quote\\\_token \* CoinGecko asset platform ID added to the response for \[/networks\](/reference/networks-list) endpoint \## Added interval daily params to /coins/id/ohlc 🗓️ \*\*May 22, 2023\*\* The \[/coins//ohlc\](/reference/coins-id-ohlc) endpoint now supports the "interval=daily" parameter for Paid Plan Subscribers Users can use this parameter to retrieve OHLC (Open/High/Low/Close) data on a daily interval for up to 180 days of date range. \## Included new fields 🗓️ \*\*April 26, 2023\*\* We've added 'watchlist\\\_portfolio\\\_users' field to \[/coins/\](/reference/coins-id) endpoint responses. This refers to number of users who added the coin into a watchlist or portfolio. \*\*Example of responses:\*\* \`\`\`json JSON theme={null} { "id": "bitcoin", ...... "watchlist\_portfolio\_users": 1449601, 👈 "market\_cap\_rank": 1, ...... "tickers": \[\] } \`\`\` \## Increased Rate Limit (Onchain/GT) 🗓️ \*\*April 19, 2023\*\* We've increased the rate limit of Public Plan from 10 calls per minute to 30 calls per minute \## Multiple Improvements (Onchain/GT) 🗓️ \*\*April 18, 2023\*\* \* base\\\_token\\\_native\\\_currency and quote\\\_token\\\_native\\\_currency added to the pools endpoint response. This allows you to obtain price in the network's native currency in addition to in USD \* reserve\\\_in\\\_usd added to the pools endpoint response. This returns the total liquidity/reserve of the pool in USD \* pool\\\_created\\\_at added to the pools endpoint response Example of responses for \[/networks//pools/\](/reference/pool-address) : \`\`\`json theme={null} { "data": { "id": "eth\_0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f", "type": "pool", "attributes": { "base\_token\_price\_usd": "0.0000186523882966482", "base\_token\_price\_native\_currency": "0.00000000647822280242372", 👈 "quote\_token\_price\_usd": "2881.71870575097", "quote\_token\_price\_native\_currency": "1.0", 👈 "base\_token\_price\_quote\_token": "0.000000006478222802", "quote\_token\_price\_base\_token": "154363323", "address": "0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f", "name": "DGX-1 / WETH", "pool\_created\_at": "2024-02-18T08:10:59Z", 👈 "fdv\_usd": "784687", "market\_cap\_usd": null, "price\_change\_percentage": { "h1": "34.67", "h24": "8406.81" }, "transactions": {}, "volume\_usd": {}, "reserve\_in\_usd": "110214.6247" 👈 }, "relationships": {} } } \`\`\` \* \[/networks//new\\\_pools\](/reference/latest-pools-network) endpoint added to query new pools discovered for a network \* \[/networks/new\\\_pools\](/reference/latest-pools-list) endpoint added to query new pools discovered across all networks \## Included new fields 🗓️ \*\*April 03, 2023\*\* We've added "symbol" field to these NFT endpoints responses: \* \[/nfts/markets\](/reference/nfts-markets) \* \[/nfts/ \](/reference/nfts-id) \* \[/nfts//contract/\](/reference/nfts-contract-address) \*\*Example of responses:\*\* \`\`\`Text JSON theme={null} { "id": "pudgy-penguins", "contract\_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8", "asset\_platform\_id": "ethereum", "name": "Pudgy Penguins", "symbol": "PPG", 👈 .... }, \`\`\` \## Included new fields 🗓️ \*\*March 27, 2023\*\* We've added "links" field (e.g. homepage, twitter, discord) to these NFT endpoints responses: \* \[/nfts/\](/reference/nfts-id) \* \[/nfts//contract/\](/reference/nfts-contract-address) \*\*Example of responses:\*\* \`\`\`json theme={null} { "id": "pudgy-penguins", "contract\_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8", ....... "links": { "homepage": "https://www.pudgypenguins.com/", 👈 "twitter": "https://twitter.com/pudgypenguins",👈 "discord": "https://discord.gg/pudgypenguins" 👈 }, ....... } \`\`\` \## Introduced /coins/top\\\_gainer\\\_losers endpoint 🗓️ \*\*March 23, 2023\*\* We've added \[/coins/top\\\_gainers\\\_losers\](/reference/coins-top-gainers-losers) endpoint exclusively for Paid Plan Subscribers. Users can now get the top 30 coins with largest price gain and loss by a specific time duration with this endpoint. \## Improved OHLCV endpoint (Onchain/GT) 🗓️ \*\*March 23, 2023\*\* \[/networks//pools//ohlcv/\](/reference/pool-ohlcv-contract-address) now returns more granularity \`day,\` \`hour\`, \`minute\` and multiple aggregates \## Multiple Improvements 🗓️ \*\*February 23, 2023\*\* We've made some updates to the /coins/categories and /simple/token\\\_price/id endpoints: \* Market cap and volume data for 'ecosystem' categories in the \[/coins/categories\](/reference/coins-categories) endpoint will now return 'null' until further notice. The CoinGecko team is actively working on improvements to provide more accurate data. If you have any feedback or suggestions, please reach out via \[api@coingecko.com\](mailto:api@coingecko.com). \* Previously, the \[/simple/token\\\_price/\](/reference/simple-token-price) endpoint was unable to return data for some Solana coins. This issue has been resolved, and users can now expect accurate data for Solana coins from this endpoint. \## Introduced /exchange/id/volume\\\_chart/range endpoint 🗓️ \*\*February 15, 2023\*\* We've introduced the \[/exchange//volume\\\_chart/range\](/reference/exchanges-id-volume-chart-range) endpoint for Paid Plan Subscribers. This exclusive feature allows users to query full historical volume data of an exchange. \## Introduced /coins/list/new endpoint 🗓️ \*\*January 09, 2023\*\* We've introduced the \[/coins/list/new\](/reference/coins-list-new) endpoint for Paid Plan Subscribers. This exclusive feature allows users to query the latest 200 coins on CoinGecko. \# 1. Get data by ID or Address Source: https://docs.coingecko.com/docs/1-get-data-by-id-or-address ## Methods to query price & market data of coins ### a. Coin ID Using \[/simple/price\](/reference/simple-price) endpoint as example: \* \`https://pro-api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs\_currencies=usd&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` \* The provided endpoint URL includes parameters such as \`ids=bitcoin\` and \`vs\_currencies=usd\`, indicating that the intention to retrieve the current price of Bitcoin in US Dollars. \*\*How to obtain Coin ID aka API ID?\*\* There are 3 options: \* Use \[/coins/list\](/reference/coins-list) endpoint, example of responses: \`\`\`json JSON theme={null} \[ ...... { "id": "bitcoin", 👈 "symbol": "btc", "name": "Bitcoin" }, ...... \] \`\`\` \* View the full list of coins with API ID, symbol and name using this \[Google Sheet\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* Look for the "API ID“ by visiting the info section of a coin page on CoinGecko:  ### b. Contract Address Other than using Coin ID, you may also query price & market data of a coin using contract address, using \[/simple/token\\\_price/\\{id\](/reference/simple-token-price)} endpoint as example: \* \`https://pro-api.coingecko.com/api/v3/simple/token\_price/ethereum?contract\_addresses=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&vs\_currencies=usd&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` There are 3 parameters values required to apply for this endpoint: \* \`id\`: \`Ethereum\` (Asset Platform ID) \* \`contract\_addresses\`: \`0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\` (Contract Address) \* \`vs\_currencies\`: \`usd\` (Target Currencies) \*\*How to obtain Coins/Tokens Contract Address\*\* \* Use \[/coins/list\](/reference/coins-list) endpoint (\`include\_platform=true\`), example of responses: \`\`\`json JSON theme={null} \[ ...... { "id": "1inch", "symbol": "1inch", "name": "1inch", "platforms": { "ethereum": "0x111111111117dc0aa78b770fa6a738034120c302", "avalanche": "0xd501281565bf7789224523144fe5d98e8b28f267", "binance-smart-chain": "0x111111111117dc0aa78b770fa6a738034120c302", "near-protocol": "111111111117dc0aa78b770fa6a738034120c302.factory.bridge.near", "energi": "0xdda6205dc3f47e5280eb726613b27374eee9d130", "harmony-shard-0": "0x58f1b044d8308812881a1433d9bbeff99975e70c", "polygon-pos": "0x9c2c5fd7b07e95ee044ddeba0e97a665f142394f" } }, ...... \] \`\`\` \* Look for the "Contract“ by visiting the info section of a coin page on CoinGecko. \### Notes \* Not all coins will have a contract address listed on the CoinGecko site. \* If an address is not shown on the CoinGecko page, you will not be able to query the coin by its contract address via the API. \* The contract addresses are curated by the CoinGecko team, if you find out any missing contract address, feel free to \[share\](https://support.coingecko.com/hc/en-us/requests/new) with us to review.  \* Get the token contract address from project website, white-paper, documentation, or block explorer site: \* \[Uniswap Documentation\](https://docs.uniswap.org/protocol/concepts/governance/overview#uni-address) \* \[Block Explorer (Etherscan)\](https://etherscan.io/token/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984) ## Specify target currency to return In the 2 examples above, both queries for Coin ID and Contract Address contain \`vs\_currencies=usd\`. Most of the CoinGecko API endpoints will require you to specify the currency. CoinGecko API data supports all major fiat currencies and some famous crypto currencies like the following: | Type | Currency | vs\\\_currencies (Param value) | | -------------- | ------------ | ---------------------------- | | Fiat | US Dollar | \`usd\` | | Fiat | Japanese Yen | \`jpy\` | | Fiat | Euro | \`eur\` | | Cryptocurrency | Bitcoin | \`btc\` | | Cryptocurrency | Ether | \`eth\` | | Cryptocurrency | Binance Coin | \`bnb\` | For full list of supported currencies, please go to \[/simple/supported\\\_vs\\\_currencies\](/reference/simple-supported-currencies) endpoint ## Other way to obtain coin prices & market data Using \[/coins/market \](/reference/coins-markets) endpoint as example to query prices and market data of coins in bulk \* \`https://pro-api.coingecko.com/api/v3/coins/markets?vs\_currency=usd&order=market\_cap\_desc&per\_page=100&page=1&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` There are 4 parameters values applied for this endpoint: \* \`vs\_currency\`: \`usd\` \* \`order\`: \`market\_cap\_desc\` — The endpoint response will be sorted in descending order, from the coins with the largest market cap to those with the smallest. \* \`per\_page\`: \`100\` — The results of coins per page are set at 100 in this case (maximum is 250). \* \`page\`: \`1\` — The page number of the results is determined by the parameter \`per\_page\`. In the case of \`per\_page=100\` and \`page=2\`, the responses will include coins ranked 101 to 200 on CoinGecko, sorted by market cap, as per the specified endpoint. # 10-mins Tutorial Guide Source: https://docs.coingecko.com/docs/10-mins-tutorial-guide New to CoinGecko API? Fret not. Whether you're a programmer or someone with zero coding experience, we've got you covered! If you are not a developer and prefer to learn only specific tutorials on Google Sheet/Excel, feel free to check \[👶 Tutorials (Beginner-friendly)\](/docs/tutorials-beginner-friendly) | Tutorial Steps | Description | | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | \[1. Get data by ID or Address\](/docs/1-get-data-by-id-or-address) | Learn how to use different endpoints by obtaining Coin ID and token's contract address at first. | | \[2. Get Historical Data\](/docs/2-get-historical-data) | Learn how to get historical data of a coin by using different historical endpoints. | | \[3. Get Exchanges & NFT Data\](/docs/3-get-exchanges-nft-data) | Learn how to query exchanges and NFT data by accessing different endpoints. | | \[4. Get On-chain Data\](/docs/4-get-on-chain-data) | Learn how to use \`/onchain\` GT endpoints to query onchain data. | # 2. Get Historical Data Source: https://docs.coingecko.com/docs/2-get-historical-data \### \*\*Tips\*\* \* Most of the historical data are returned and queried using UNIX Timestamp. \* If you are not familiar with UNIX Timestamp, you may use tool like \[epochconverter.com\](https://www.epochconverter.com/) to convert between UNIX Timestamp and human readable date. \* You may use either coin ID or contract address to get the historical data. There are five different endpoints to get historical data of a coin: | Endpoint | Description | | ---------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[/coins/\\{id}/history\](/reference/coins-id-history) | Get the historical data (price, market cap, 24hrs volume, etc.) at a given date for a coin based on a particular coin ID. | | \[/coins/\\{id}/market\\\_chart\](/reference/coins-id-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hrs volume based on particular coin ID. | | \[/coins/\\{id}/market\\\_chart/range\](/reference/coins-id-market-chart-range) | Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hrs volume based on particular coin ID. | | \[/coins/\\{id}/contract/\\{contract\\\_address}/market\\\_chart\](/reference/contract-address-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hrs volume based on token contract address. | | \[/coins/\\{id}/contract/\\{contract\\\_address}/market\\\_chart/range\](/reference/contract-address-market-chart-range) | Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hrs volume based on token contract address. | \### \*\*Notes\*\* The data granularity (interval) for \[/market\\\_chart\](/reference/coins-id-market-chart) and \[/market\\\_chart/range\](/reference/coins-id-market-chart-range) endpoints is automatic and based on the date range: \* 1 day from current time = 5-minutely data \* 1 day from anytime (except from current time) = hourly data \* 2-90 days from current time or anytime = hourly data \* above 90 days from current time or anytime = daily data (00:00 UTC) \# 3. Get Exchanges & NFT Data Source: https://docs.coingecko.com/docs/3-get-exchanges-nft-data You can get Exchange and NFT data just like how you get the coins data: 1. Get the ID (exchange or NFT) from \`/list\` endpoint. 2. Use the ID to query latest or historical market data | Type | Coins | NFTs | Exchanges | Derivatives | | ---------------------- | -------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------- | ---------------------------------------------------------------------- | | Get Full List with IDs | \[/coins/list\](/reference/coins-list) | \[/nfts/list\](/reference/nfts-list) | \[/exchanges/list\](/reference/exchanges-list) | \[/derivatives/exchanges/list\](/reference/derivatives-exchanges-list) | | Get latest market data | \[/coins/\\{id}\](/reference/coins-id) | \[/nfts/\\{id}\](/reference/nfts-id) | \[/exchanges/\\{id}\](/reference/exchanges-id) | \[/derivatives/exchanges/\\{id}\](/reference/derivatives-exchanges-id) | | Get Historical Data | \[/coins/\\{id}/market\\\_chart\](/reference/coins-id-market-chart) | \[/nfts/\\{id}/market\\\_chart\](/reference/nfts-id-market-chart) | \[/exchanges/\\{id}/volume\\\_chart\](/reference/exchanges-id-volume-chart) | \[/exchanges/\\{id}/volume\\\_chart\](/reference/exchanges-id-volume-chart) | # 4. Get On-chain Data Source: https://docs.coingecko.com/docs/4-get-on-chain-data Here are some of the important parameters to take note while using Onchain DEX API Endpoints: \* Blockchain Networks \* DEXs \* Pool Contract Address \* Token Contract Address ## Blockchain Networks \### Notes \* Please do not use CoinGecko Asset Platform ID as the Network ID in Onchain DEX API Endpoints (CoinGecko Asset Platform ID ≠ GT Network ID) \* Example: \* Asset Platform on CoinGecko: \`ethereum\` \* Onchain Network ID: \`eth\` \*\*How to obtain Network ID?\*\* \* Use \[/onchain/networks\](/reference/networks-list) endpoint, example of response: \`\`\`json JSON theme={null} { "data": \[ { "id": "eth", 👈 Network ID "type": "network", "attributes": { "name": "Ethereum", "coingecko\_asset\_platform\_id": "ethereum" 👈 CoinGecko Asset Platform ID } }, ...... \] } \`\`\` \* Go to \[GeckoTerminal\](https://www.geckoterminal.com/) 1. Select or search for a blockchain network. 2. Copy the slug from the URL:  ## DEXs Some of the pools endpoints require you to provide DEX ID along with Network ID to query the pools on a particular DEX (Decentralized Exchange). Using \[/onchain/networks/\\{network}/dexes/\\{dex}/pools\](/reference/top-pools-dex) as example: \* \`https://pro-api.coingecko.com/api/v3/onchain/networks/eth/dexes/uniswap\_v3/pools?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` There are 2 parameter values required to apply for this endpoint: \* \`network\`: \`eth\` (network ID) \* \`dex\`: \`uniswap\_v3\` (DEX ID) \*\*How to obtain DEX ID?\*\* \* Use \[/onchain/networks/\\{network}/dexes\](/reference/dexes-list) endpoint, example of response: \`\`\`json JSON theme={null} { "data": \[ { "id": "uniswap\_v2", 👈 DEX ID "type": "dex", "attributes": { "name": "Uniswap V2" } }, ...... \] } \`\`\` \* Go to \[GeckoTerminal\](https://www.geckoterminal.com/) 1. Select or search for a blockchain network. 2. Choose the DEX from the DEXs List on the top (e.g. Uniswap V3). 3. Copy the slug from the URL:  ## Methods to query Onchain Data ### a. Pool Contract Address Most of the time, you will need a pool contract address along with Network ID to query the onchain data, especially when using the Pools Endpoints. Using \[/onchain/networks/\\{network}/pools/\\{address}\](/reference/pool-address) as example: \* \`https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` There are 2 parameter values required to apply for this endpoint: \* \`network\`: \`eth\` (network ID) \* \`address\`: \`0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc\` (pool contract address) \*\*How to obtain the pool contract address? (e.g.\`WETH/USDC\`)\*\* \* Look for the contract address section of pool page on \[GeckoTerminal\](https://www.geckoterminal.com/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640):  \* Get the pool contract address from the project website, white-paper, documentation, or block explorer site: \* \[Block Explorer (Etherscan)\](https://etherscan.io/address/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640) \* \[DEX (Uniswap)\](https://info.uniswap.org/#/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640) ### b. Token Contract Address Apart from the pool contract address, you also have the option to query onchain data by using the token contract address, using \[/onchain/networks/\\{network}/tokens/\\{token\\\_address}/pools\](/reference/top-pools-contract-address) as example: \* \`https://pro-api.coingecko.com/api/v3/onchain/networks/eth/tokens/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/pools?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` There are 2 parameter values required to apply for this endpoint: \* \`network\`: \`eth\` (network ID) \* \`address\`: \`0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48\` (token contract address) \*\*How to obtain tokens contract address (e.g. UNI):\*\* \* Look for the contract address section of pool page on GeckoTerminal:  \* Get the token contract address from the project website, white-paper, documentation, or block explorer site. For example: \* \[Uniswap Documentation\](https://docs.uniswap.org/protocol/concepts/governance/overview#uni-address) \* \[DEX (Uniswap)\](https://info.uniswap.org/#/tokens/tokens/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984) \* \[Block Explorer (Etherscan)\](https://etherscan.io/token/0x1f9840a85d5af5bf1d1762f925bdaddc4201f984) # AI Prompts Source: https://docs.coingecko.com/docs/ai-prompts CoinGecko API AI prompt library Accelerate your development with CoinGecko's curated AI prompts. These prompts are designed to guide AI-powered coding assistants in correctly implementing our official API SDKs (libraries), helping you spend less time debugging and more time building. ## How to Use Our Prompts Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant. 1. For \*\*Chat Interfaces (Claude, ChatGPT, etc.)\*\*: Paste the prompt at the beginning of your conversation before asking the AI to write code. 2. For \*\*Cursor IDE\*\*: Add the prompt to your project's \`Rules\` to enforce the guidelines across all AI interactions. 3. For \*\*GitHub Copilot\*\*: Save the prompt to a file (e.g. \`coingecko\_rules.md\`) and reference it in your chat with \`@workspace #coingecko\_rules.md\`. ## Available Prompts Select the prompt that matches your project's tech stack. \* 🐍 \*\*\[Python\](/docs/python-ai-prompts)\*\*: A complete guide for implementing the CoinGecko API using our official \[coingecko-sdk\](https://pypi.org/project/coingecko-sdk/). \* 🟦 \*\*\[TypeScript\](/docs/typescript-ai-prompts#/)\*\*: The definitive prompt for integrating the CoinGecko API with our official \[@coingecko/coingecko-typescript\](https://www.npmjs.com/package/@coingecko/coingecko-typescript) package. ## Best Practices To get the most out of our AI prompts, keep these tips in mind: \* \*\*Be Specific\*\*: After providing the main prompt, give the AI a clear, specific task (e.g. "Write a function to fetch the price of Bitcoin and Ethereum in EUR"). \* \*\*Customize\*\*: Feel free to modify the prompts to fit your project's unique requirements or coding standards. \* \*\*Version Control\*\*: Store your customized prompts in your repository to ensure your entire team benefits from consistent AI-generated code. \* \*\*Always Review\*\*: Treat AI-generated code as a starting point. Always review it for security, performance, and correctness. # API Status Source: https://docs.coingecko.com/docs/api-status CoinGecko's API status page provides information on the current status and incident history of CoinGecko API (Public & Pro) \### \*\*Tips\*\* \* You can view our live updates, and subscribe to updates via Email, Slack and Discord. \* Instead of subscribing to all updates, you may click on 'Select services' to subscribe to either Public or Pro API updates.  \* CoinGecko API Status — \[https://status.coingecko.com\](https://status.coingecko.com) \* Incident & Maintenance History — \[https://status.coingecko.com/incidents\](https://status.coingecko.com/incidents) \* Uptime Calendar — \[https://status.coingecko.com/incidents/uptime-calendar\](https://status.coingecko.com/incidents/uptime-calendar) # Best Practices Source: https://docs.coingecko.com/docs/best-practices Wonder how to use different endpoints together? This is the perfect place for you ## User Journey for CoinGecko API Endpoints  ### "Discovery/Navigational Endpoints" \*\*Examples:\*\* \* \[/coins/list\](/reference/coins-list) — can be used to query all the supported coins on CoinGecko with names, symbols and coin IDs that can be used in other endpoints. \* \[/search/trending\](/reference/trending-search) — can be used to query trending search coins, categories and NFTs on CoinGecko. ### "Supporting Endpoints" \*\*Examples:\*\* \* \[/simple/supported\\\_vs\\\_currencies\](/reference/simple-supported-currencies) — can be used to query the list of currencies for other endpoints that include parameters like \`vs\_currencies\`, allowing to obtain the corresponding data for those currencies. \* \[/asset\\\_platforms\](/reference/asset-platforms-list) — can be used to query the list of asset platforms for other endpoints that contain parameters like \`id\` or \`ids\` (asset platforms), allowing the retrieval of corresponding data for these asset platforms. ### "Data Endpoints" \*\*Examples:\*\* \* \[/simple/price\](/reference/simple-price) — can be used to query the prices of coins using the unique coin IDs that can be obtained from the "Discovery/Navigational Endpoints" mentioned above. \* \[/coins/\\{id}\](/reference/coins-id) — can be used to query the coin data using the unique coin IDs that can be obtained from the "Discovery/Navigational Endpoints" mentioned above. ## User Journey for Onchain DEX API Endpoints (GeckoTerminal data)  ### "Discovery/Navigational Endpoints" \*\*Examples:\*\* \* \[/onchain/trending\\\_pools\](/reference/trending-pools-list) - can be used to query trending pools across all networks on GeckoTerminal. \* \[/onchain/search/pools\](/reference/search-pools) - can be used to search for any pools on GeckoTerminal. ### "Supporting Endpoints" \*\*Examples:\*\* \* \[/onchain/networks-list\](/reference/networks-list) - can be used to query all the supported networks on GeckoTerminal. \* \[/onchain/networks/\\{network}/dexes\](/reference/dexes-list) - can be used to query all the supported decentralized exchanges (DEXs/\`dexes\`) on GeckoTerminal based on network id that can be obtained from the endpoint mentioned above. ### "Data Endpoints" \*\*Examples:\*\* \* \[/onchain/simple/networks/\\{network}/token\\\_price/\\{addresses}\](/reference/onchain-simple-price) - can be used to query any token price using the token address and network id that can be obtained from the "Discovery/Navigational Endpoints" and "Supporting Endpoints" mentioned above. \* \[/onchain/networks/\\{network}/pools/\\{address}\](/reference/pool-address) - can be used to query the data of a specific pool based on the pool address and network id that can be obtained from the "Discovery/Navigational Endpoints" and "Supporting Endpoints" mentioned above. # Building with AI Source: https://docs.coingecko.com/docs/building-with-ai Quick tips to empower your AI applications with CoinGecko API, and leverage our AI capabilities to help you build better and easier. CoinGecko provides a powerful suite of AI-native tools to help you integrate real-time, historical, and onchain market data into your applications. Whether you're building a sophisticated trading bot, a market analysis tool, or a simple portfolio tracker, our AI toolkit is here to accelerate your development. ## Using \`llms.txt\` To help AI models interact with CoinGecko data effectively, we provide an \`llms.txt\` file at \[/llms-full.txt\](/llms-full.txt). This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations of MCP and AI applications. ## CoinGecko MCP Server The \*\*MCP (Model-Context-Protocol)\*\* Server is your gateway for connecting AI agents and large language models, like Claude and Gemini, directly to CoinGecko's live data streams. It's ideal for building conversational applications that can perform complex, real-time crypto analysis and answer user queries with up-to-the-minute information. Learn how to connect your AI agent by checking out \[CoinGecko MCP Server\](/docs/mcp-server) ## Tools for Your Workflow We've integrated AI assistance directly into our documentation to help you find answers and ship faster. 1. Use the \*\*'Copy page'\*\* button to copy endpoint-specific markdown prompts. You can take these prompts to your favorite LLM chat interface to explore use cases or generate boilerplate code. 2. Stuck on a problem? Click the \*\*'AI Support'\*\* button anywhere in our docs to chat with our AI Assistant. It's trained to resolve your inquiries instantly.  # Clients Source: https://docs.coingecko.com/docs/clients Explore client resources, including official Swagger JSON and unofficial Python wrapper ## API Swagger JSON (OAS) [](https://github.com/coingecko/coingecko-api-oas)\
\* \[CoinGecko Pro OAS\](https://docs.coingecko.com/reference/endpoint-overview) \* CoinGecko Pro API — \[coingecko-pro.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-pro.json) \* GeckoTerminal Onchain API (Pro) — \[onchain-pro.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-pro.json) \* \[CoinGecko Public/Demo OAS\](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview) \* CoinGecko Public/Demo API — \[coingecko-demo.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-demo.json) \* GeckoTerminal Onchain API (Demo) — \[onchain-demo.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-demo.json) \*\*\* ## Official CoinGecko API SDK Here are the official API SDKs maintained by us. \* \[🐍 coingecko-python (Python)\](https://github.com/coingecko/coingecko-python) \* \[🟦 coingecko-typescript (Typescript)\](https://github.com/coingecko/coingecko-typescript) Want us to support your favorite programming language? Let us know \[here\](https://forms.gle/JJLH3SXiL2eJaGzBA)! \*\*Not a developer?\*\* Fred not, check our no-code tutorial for beginners here: \[Tutorials (Beginner-friendly)\](/docs/tutorials-beginner-friendly) # Common Errors & Rate Limit Source: https://docs.coingecko.com/docs/common-errors-rate-limit ## Common Errors The server responds to a user’s request by issuing status codes when the request is made to the server. Kindly refer to the table below to further understand the status codes when indicating the success or failure of an API call. | Status Codes | Description | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \`400\` (Bad Request) | This is due to an invalid request and the server could not process the user's request | | \`401\` (Unauthorized) | This is due to the lack of valid authentication credentials for the requested resource by the user | | \`403\` (Forbidden) | This is likely indicating that your access is blocked by our server, and we're unable to authorize your request | | \`408\` (Timeout) | This error indicates that our server did not receive your complete request within our allowed time frame. This is usually caused by a slow network connection on your end or network latency. Please check your connection and try sending the request again. | | \`429\` (Too many requests) | This is likely indicating that the rate limit has reached. The user should reduce the number of calls made, or consider scaling their service plan that has much higher rate limits and call credits | | \`500\` (Internal Server Error) | This is a generic error response indicating that the server has encountered an unexpected issue that prevented it from fulfilling the request | | \`503\` (Service Unavailable) | The service is currently unavailable. Please check the API status and updates on \[https://status.coingecko.com\](https://status.coingecko.com) | | \`1020\` (Access Denied) | This is due to violation of CDN firewall rule | | \`10005\` | You may not have access to this endpoint. e.g. 'This request is limited Pro API subscribers'. You may wanna subscribe to a paid plan \[here\](https://www.coingecko.com/en/api/pricing) | | \`10002\` (Missing API Key) | API Key Missing. Please make sure you're using the right authentication method. \
For Pro API, ensure you pass in \`x\_cg\_pro\_api\_key\` parameter with a Pro Key. \
For Demo API, ensure you pass in \`x\_cg\_demo\_api\_key\` parameter with a Demo Key. | | \`10010\` (Invalid API Key) | You have provided incorrect API key credentials. If you are using Pro API key, please change your root URL from \`api.coingecko.com\` to \`pro-api.coingecko.com\` | | \`10011\` (Invalid API Key) | You have provided incorrect API key credentials. If you are using Demo API key, please change your root URL from \`pro-api.coingecko.com\` to \`api.coingecko.com\` | | CORS error | Occurs when the server doesn't return the CORS headers required. You may learn more and attempt the recommended solutions \[here\](https://www.bannerbear.com/blog/what-is-a-cors-error-and-how-to-fix-it-3-ways/#how-to-fix-a-cors-error) | ## Rate Limit \### \*\*Notes\*\* \* If you're using the Public API with Google Sheet and got hit with error, this is due to the IP sharing among Google Sheet users, and we have no control over this. \* If you need reliable performance, please \*\*register for a demo account\*\* or \*\*subscribe to a paid plan\*\* that comes with dedicated infra (API key) to prevent rate limit issues. \* For more details, please go to the page \[here\](https://www.coingecko.com/en/api/pricing). \* For Public API user (Demo plan), the rate limit is \\~30 calls per minutes and it varies depending on the traffic size. \* If you're Pro API user (any paid plan), the rate limit is depending on the paid plan that you're subscribed to. \* Regardless of the HTTP status code returned (including \`4xx\` and \`5xx\` errors), all API requests will count towards your \*\*minute rate limit\*\*. # Common Use Cases Source: https://docs.coingecko.com/docs/common-use-cases Discover the common use cases of CoinGecko API by our users ## 1. Get Coins Logo Images \* Use \[/coins/id\](/reference/coins-id) endpoint. \* This endpoint can be used to query other coin's metadata like: links, categories, contract address, community, description in different languages and many more. \* Coin descriptions may include newline characters represented as \`\\r\\n\` (escape sequences), which may require processing for proper formatting. \* Use \[Token Info by Token Address\](/reference/token-info-contract-address) endpoint to get metadata of tokens listed on GeckoTerminal.com. ## 2. Best Endpoint for Latest Crypto Price \* Use \[/simple/price\](/reference/simple-price) endpoint. \* This endpoint can be used to query other market data like market cap, 24-hour trading volume and 24-hour price change percentage. ## 3. Get All Trading Pairs (Tickers) of a Coin \* Use \[/coins/id/tickers\](/reference/coins-id-tickers) endpoint. ## 4. Get Trading Pairs of Specific Coins from a Specific Exchange \* Use\[ /coins/id/tickers\](/reference/coins-id-tickers) endpoint by supplying specific exchange ID. ## 5. Building Telegram Bot for Latest Coin Listings \* Use \[/coins/list/new\](/reference/coins-list-new) endpoint. ## 6. Get List of Coins Under Specific Category \* For CoinGecko \[categories\](https://www.coingecko.com/en/categories), use \[/coins/markets\](/reference/coins-markets) endpoint by supplying specific category. \* For GeckoTerminal \[categories\](https://www.geckoterminal.com/category), use \[Pools by Category ID\](/reference/pools-category) endpoint by supplying specific category. ## 7. Identify DEX Decentralized Exchanges \* Use \[/exchanges/list\](/reference/exchanges-list) endpoint to get full list of exchanges with ID on CoinGecko. \* Use \[/exchanges/id\](/reference/exchanges-id) to find out whether the exchange is centralized or decentralized. \* Example of responses (using Uniswap V3 as example) : Since Uniswap is a DEX, therefore it shows \`"centralized": false\` \`\`\`json JSON theme={null} { "name": "Uniswap V3 (Ethereum)", ...... "centralized": false, 👈 ...... "tickers": \[\], "status\_updates": \[\] } \`\`\` \## 8. Get Bitcoin Dominance Data (BTC.D) \* Use \[/global \](/reference/crypto-global)endpoint. \* Example of responses: \`\`\`json JSON theme={null} { "data": { "active\_cryptocurrencies": 12414, ...... "market\_cap\_percentage": { 👈 "btc": 47.82057011844006,👈 "eth": 16.943340351591583, ...... }, "market\_cap\_change\_percentage\_24h\_usd": -5.032104325648996, "updated\_at": 1706002730 } } \`\`\` \## 9. Get Market Cap or Dominance of a Specific Ecosystem \* Use \[/coins/categories\](/reference/coins-categories). \* The endpoint also returns the 24-hour percentage change, offering insights into the traction of different categories or ecosystems. ## 10. Get Token Lists of a Specific Blockchain Network \* Use \[/token\\\_lists/asset\\\_platforms\\\_id/all.json\](/reference/token-lists) endpoint. \* Supply asset platform id to the endpoint. ## 11. Get 7-Day Sparkline Price Data of a Coin \* Use \[/coins/id\](/reference/coins-id) or \[/coins/markets\](/reference/coins-markets) endpoints by flagging \`sparkline = true\`. ## 12. Get Link to Individual CoinGecko Coin Page \* Use \[/coins/list\](/reference/coins-list) endpoint to get the coin \*\*\`{ID}\`\*\*. \* Supply API ID in this URL path format: \`www.coingecko.com/en/coins/{ID}\` \* If you wish to the obtain the URL slug of a specific CoinGecko Coin Page, e.g. \`www.coingecko.com/en/coins/{web\_slug}\` you may use \[/coin/id\](/reference/coins-id) endpoint and obtain the \*\*\`{web\_slug}\`\*\* value. ## 13. Check Coin Status and Stale Price Updates \* Active: use \[/coins/list\](/reference/coins-list) endpoint, only active coins will be shown by default. You may also flag \*\*\`status=inactive\`\*\* to get a list of inactive coins. \* Price Stale: use \[/simple/price\](/reference/simple-price) endpoint, flag \`include\_last\_updated\_at=true\` to check latest update time. ## 14. Get Real-Time and Historical Exchange of BTC in USD \* Current exchange rate: use \[/exchange\\\_rates\](/reference/exchange-rates) endpoint. \* Historical exchange rate: use \[/coins/id/history\](/reference/coins-id-history) or \[/coins/id/market\\\_chart\](/reference/coins-id-market-chart) endpoints. ## 15. Get Watchlist Portfolio Data of a Coin \* Use \[/coins/id\](/reference/coins-id) endpoint by supplying coin ID. \* Example of responses: \`\`\`json JSON theme={null} { "id": "bitcoin", ...... "watchlist\_portfolio\_users": 1487932, 👈 "market\_cap\_rank": 1, ...... } \`\`\` \## 16. Get Historical Data for Inactive Coins \*\*Note\*\*: This is available for paid plan subscribers only. \* Use \[/coins/list\](/reference/coins-list) endpoint, specifying the status param as \`inactive\`. \* Example of endpoint request: \`https://pro-api.coingecko.com/api/v3/coins/list?include\_platform=false&status=inactive&x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` \* Retrieve the coin's ID from the endpoint mentioned above and use it to access historical data via the following endpoints: \* \[/coins/id/history\](/reference/coins-id-history) \* \[/coins/id/market\\\_chart\](/reference/coins-id-market-chart) \* \[/coins/id/market\\\_chart/range\](/reference/coins-id-market-chart-range) \* \[/coins/id/contract/contract\\\_address/market\\\_chart\](/reference/contract-address-market-chart) \* \[/coins/id/contract/contract\\\_address/market\\\_chart/range\](/reference/contract-address-market-chart-range) ## 17. Get TVL (Total Value Locked) data of a Coin \* Use \[/coins/id\](/reference/coins-id) endpoint by supplying coin ID. \* Example of responses: \`\`\`json JSON theme={null} "total\_value\_locked": { "btc": 72324, "usd": 4591842314 } \`\`\` \## 18. Query Search for Coins, Categories, NFTs, Exchanges, and Pools We have 2 Search endpoints: \* \[/search\](/reference/search-data) endpoint allows you to search for coins, categories, exchanges (markets), and NFTs listed on CoinGecko.com. You may query by name or symbol. \* \[/search-pools\](/reference/search-pools) endpoint allows you to search for pools listed on GeckoTerminal.com. You may query by pool contract address, token contract address, or token symbol. ## 19. Get List of Blockchain Networks supported on CoinGecko and GeckoTerminal. CoinGecko and GeckoTerminal support different sets of blockchain networks. You can use the following endpoints to find the list of supported networks and their respective IDs: \* CoinGecko: \[/asset-platforms-list\](/reference/asset-platforms-list) \* GeckoTerminal (\[onchain endpoints\](/reference/endpoint-overview#-onchain-dex-endpoints-geckoterminal)): \[/networks-list\](/reference/networks-list) ## 20. Get Native Coin of a Blockchain Network (Asset Platform) You may use the \[/asset-platforms-list\](/reference/asset-platforms-list) endpoint to obtain the native coin ID of all networks (asset platforms) listed on \[www.coingecko.com\](http://www.coingecko.com.). ## 21. Get Liquidity data of a Liquidity Pool or Token There are multiple onchain endpoints that provide the liquidity data (\`reserve\_in\_usd\`) of a pool, for example: \[Specific Pool Data by Pool Address\](/reference/pool-address). You may also get liquidity data (\`total\_reserve\_in\_usd\`) of a token, using endpoints like: \[Token Data by Token Address\](/reference/token-data-contract-address). Note: \`reserve\_in\_usd\` (pool) represents the total liquidity of all tokens within a specific pool, whereas \`total\_reserve\_in\_usd\` (token) refers to the total liquidity portion attributable to a specific token across all available pools. ## 22. Get list of onchain DEX pools based on specific criteria \* Use \[/pools/megafilter\](/reference/pools-megafilter) to retrieve data for onchain DEX pools that match a given set of filters. \* Example of use cases: \* Custom filtering: Combine multiple params — like liquidity thresholds, FDV ranges, 24-hour volume, and more — to extract the precise datasets you need. \* Risk and Quality checks: Apply fraud filters to weed out risky projects. \* For more details on examples and available filters, refer to: \* \[Changelog — New Megafilter Endpoint\](/changelog#february-2025) \* \[Live Filtering on GeckoTerminal\](https://www.geckoterminal.com/) ## 23. Get List of Trending Coins \* Use the following endpoints to get trending coins and pools: \* \[Trending Search List\](/reference/trending-search/) — Trending Coins, NFTs, Categories on CoinGecko.com, based on user searches. \* \[Trending Search Pools\](/reference/trending-search-pools/) — Trending Pools and Tokens on GeckoTerminal.com, based on user searches. \* Other useful endpoints: \* \[Top Gainers & Losers\](/reference/coins-top-gainers-losers) on CoinGecko.com, by specific time duration. \* \[Trending Pools List\](/reference/trending-pools-list) and \[Trending Pools by Network\](/reference/trending-pools-network) on GeckoTerminal.com, by specific time duration. ## 24. Get Security Info of Tokens \* By using \[Token Info by Token Address\](/reference/token-info-contract-address) endpoint, you can obtain the following security related data: \* GeckoTerminal Score (Pool, Transaction, Creation, Info, Holders) \* Holders count, and distribution percentage based on the total supply \
(includes all wallet types: CEX, treasury/issuer, etc.) \* Mint and Freeze Authority ## 25. Get Latest Token/Pool Data from Launchpad \* Use \[megafilter\](/reference/pools-megafilter) endpoint to retrieve latest launchpad data, by flagging \`sort=pool\_created\_at\_desc\`. Learn more on \[changelog\](/changelog#now-supported%3A-launchpad-data-pump-fun-%26-more-%2C-granular-ohlcv%2C-and-honeypot-info). \* \*\*Request example (Get latest pools on Pump.fun)\*\*: \`\`\`bash Bash theme={null} https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool\_created\_at\_desc&x\_cg\_pro\_api\_key=YOUR\_API\_KEY \`\`\` \## 26. Get Latest Price/Data for Tokens Not Actively Traded \* When a token has no active pools (no valid swaps in the past 7 days), you can still retrieve the latest available price and data by using the \`include\_inactive\_source=true\` parameter. \* This parameter sources data from the pool with the most recent swap, regardless of how long ago it occurred. \* The \`last\_trade\_timestamp\` field in the response indicates when the most recent trade took place. \* Supported endpoints: \* \[Token Data by Token Address\](/reference/token-data-contract-address) — \`/onchain/networks/../tokens/..\` \* \[Tokens Data by Token Addresses\](/reference/tokens-data-contract-addresses) — \`/onchain/networks/../tokens/multi/..\` \* \[Top Pools by Token Address\](/reference/top-pools-contract-address) — \`/onchain/networks/../tokens/../pools\` \* \[Token Price by Token Addresses\](/reference/onchain-simple-price) — \`/onchain/simple/networks/../token\_price/..\` \* \[Token OHLCV chart by Token Address\](/reference/token-ohlcv-token-address) — \`/onchain/networks/../tokens/../ohlcv/..\` \
⚡️ Need Real-time Data Streams? Try \[WebSocket API\](https://docs.coingecko.com/websocket) [](https://docs.coingecko.com/websocket)\
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data. \
Subscribe to our \[paid API plan\](https://www.coingecko.com/en/api/pricing) (Analyst plan & above) to access WebSocket and REST API data delivery methods. # Endpoint Showcase Source: https://docs.coingecko.com/docs/endpoint-showcase Discover how CoinGecko API is used at CoinGecko.com and GeckoTerminal.com ## CoinGecko ### \[Home Page\](https://www.coingecko.com)  1. \[/global\](/reference/crypto-global) — Display global crypto data such as number of active cryptocurrencies, exchanges and etc. 2. \[/search/trending\](/reference/trending-search) — Display trending search coins, NFTs and categories. 3. \[/coins/top\\\_gainers\\\_losers\](/reference/coins-top-gainers-losers) — Display the largest gainers in 24hr. 4. \[/coins/categories\](/reference/coins-categories) — Display all the categories list. 5. \[/coins/markets\](/reference/coins-markets) — Display all the supported coins with market related data. ### \[Coin Page\](https://www.coingecko.com/en/coins/bitcoin)  1. \[/coins/\\{id} \](/reference/coins-id)— Display all the coin data including name, price, market related data, website, explorers and etc. 2. \[/simple/price\](/reference/simple-price) — Display data such as latest coin price, market cap and 24hr trading volume. 3. \* \[/coins/\\{id}/history\](/reference/coins-id-history) — Display the historical price data. \* \[/coins/\\{id}/market\\\_chart\](/reference/coins-id-market-chart) — Display the historical data in line chart. \* \[/coins/\\{id}/ohlc\](/reference/coins-id-ohlc) — Display the historical data in candlestick chart. ### \[Exchanges Page\](https://www.coingecko.com/en/exchanges/hyperliquid-spot)  1. \[/exchanges/\\{id}\](/reference/exchanges-id) — Display the exchange information such as name, type, market related data such as trading volume and etc. 2. \[/exchanges/\\{id}/volume\\\_chart\](/reference/exchanges-id-volume-chart) — Display the historical volume chart data. 3. \[/exchanges/\\{id}/tickers\](/reference/exchanges-id-tickers) — Display the exchange's tickers. ### \[NFTs Page\](https://www.coingecko.com/en/nft/pudgy-penguins)  1. \[/nfts/\\{id}\](/reference/nfts-id) — Display NFT data such as name, contract address, website, market related data such as floor price, market cap, volume and etc. 2. \[/nfts/\\{id}/market\\\_chart\](/reference/nfts-id-market-chart) — Display the historical market data in chart. 3. \[/nfts/\\{id}\](/reference/nfts-id) — Display the description of the NFT collection. 4. \[/nfts/\\{id}/tickers\](/reference/nfts-id-tickers) — Display the tickers of the NFT collection on different NFT marketplace. ## GeckoTerminal ### \[Home Page\](https://www.geckoterminal.com/)  1. \[/onchain/search/pools \](/reference/search-pools)— Allow users to search for pools on GeckoTerminal. 2. \[/onchain/networks\](/reference/networks-list) — Display a list of supported networks on GeckoTerminal. 3. \[/onchain/networks/trending\\\_pools\](/reference/trending-pools-list) — Display a list of trending pools across all networks on GeckoTerminal. 4. \[/onchain/networks/new\\\_pools\](/reference/latest-pools-list) — Display all the latest pools across all networks on GeckoTerminal. 5. \[/onchain/categories\](/reference/categories-list) — Display all the onchain categories on GeckoTerminal. ### \[Chain Page\](https://www.geckoterminal.com/eth/pools)  1. \[/onchain/networks/\\{network}/dexes\](/reference/dexes-list) — Display all the supported dex on a network on GeckoTerminal. 2. \[/onchain/networks/\\{network}/trending\\\_pools\](/reference/trending-pools-network) — Display a list of trending pools on a network on GeckoTerminal. 3. \[/onchain/networks/\\{network}/new\\\_pools\](/reference/latest-pools-network) — Display a list of new pools on a network on GeckoTerminal. 4. \[/onchain/networks/\\{network}/pools\](/reference/top-pools-network) — Display all the top pools on a network on GeckoTerminal. 5. \[/onchain/categories/\\{category\\\_id}/pools\](/reference/pools-category) — Display all the pools under a specific onchain category on GeckoTerminal. ### \[Pool Page\](https://www.geckoterminal.com/eth/pools/0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640)  1. \* \[/onchain/networks/\\{network}/pools/\\{address}\](/reference/pool-address) — Display pool data such as price, transactions, volume and etc. \* \[/onchain/networks/\\{network}/pools/\\{pool\\\_address}/info\](/reference/pool-token-info-contract-address) — Display pool information such as name, symbol, image URL, description and etc. 2. \[/onchain/networks/\\{network}/pools/\\{pool\\\_address}/ohlcv/\\{timeframe}\](/reference/pool-ohlcv-contract-address) — Display the OHLCV chart of the pool. 3. \[/onchain/networks/\\{network}/pools/\\{pool\\\_address}/trades\](/reference/pool-trades-contract-address) — Display the trades of the pool in the past 24 hours. ### \[Categories Page\](https://www.geckoterminal.com/category)  1. \[/onchain/categories\](/reference/categories-list) — Display list of onchain categories with market data. 2. \[/onchain/categories/\\{id}/pools\](/reference/pools-category) — Display list of pools with market data of a specific onchain category. # CoinGecko MCP Server (Beta) Source: https://docs.coingecko.com/docs/mcp-server MCP Server for Crypto Price & Market Data. MCP (Model Context Protocol) is an open standard that allows Large Language Model (LLM) and other AI agents to securely and intelligently interact with external data sources and tools.  \### Welcome to the CoinGecko MCP Server! \*\*CoinGecko MCP Server is currently in Beta.\*\* We're constantly improving, and your feedback is crucial. Please share any thoughts or suggestions via \[this feedback form\](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform). \# 📕 Overview The official CoinGecko MCP Server is now live, making CoinGecko data readily available to your AI models and applications. With the CoinGecko MCP, you can empower your agents to: \* \*\*Access real-time market data\*\*: Get aggregated prices, market cap, and trading volume for over 15k+ coins on CoinGecko, integrated across 1,000+ exchanges. \* \*\*Dive into onchain analytics\*\*: Query onchain DEX price and liquidity data for more than 8M tokens across 200+ networks via GeckoTerminal. \* \*\*Discover market trends\*\*: Instantly find trending coins, new token listings, top gainers/losers, and popular NFT collections. \* \*\*Retrieve rich metadata\*\*: Pull essential details like project descriptions, logos, social links, contract addresses, security info, and more. \* \*\*Analyze historical performance\*\*: Access historical price, market data, and OHLCV for any cryptocurrency. \* \*\*Explore crypto categories\*\*: Effortlessly list coins within specific sectors like Meme, DeFi, Layer 1, AI agent, and more.  # 🔥 Getting Started Connecting your AI to CoinGecko is simple. We offer several MCP server options to fit your needs, from keyless access for testing to authenticated connections for production applications. Most MCP-compatible clients, like Claude Desktop, Gemini CLI, and Cursor, can be configured using a simple JSON file (e.g., \`claude\_desktop\_config.json\`) \### Prerequisites \* Make sure your device has \`node\` installed. You can download it from \[nodejs.org/download\](https://nodejs.org/en/download) \## Which MCP Server Should You Use? Here's a breakdown of the available options to help you choose the right one: | MCP Server Type | Best For | Endpoints | Status | Setup Details | | ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ----------- | ----------------------------------------------------------------------------- | | Remote Server (Public, Keyless) | - First-time users, quick tests, and basic queries \
\- Connect instantly without any registration \
\- Subject to shared rate limits, not for heavy use | Primary: \`/mcp\` \
Alternative: \`/sse\` | Public Beta | \[mcp.api.coingecko.com\](https://mcp.api.coingecko.com/) | | Remote Server (Authenticated) | - Scalable apps, AI agent integrations \
\- Unlocks 76+ tools available under your Demo/Pro plan \
\- Higher, reliable rate limits with 24/7 uptime. Get your API key \[here\](https://www.coingecko.com/en/api/pricing) | Primary: \`/mcp\` \
Alternative: \`/sse\` | Public Beta | \[mcp.pro-api.coingecko.com\](https://mcp.pro-api.coingecko.com/) | | Local Server | - Ideal for local development, desktop AI apps \
\- Build/test your AI app even without an active internet connection \
\- Demo/Pro API key to access more tools. Get your API key \[here\](https://www.coingecko.com/en/api/pricing) | Local server instance | Beta | \[npmjs/coingecko-mcp\](https://www.npmjs.com/package/@coingecko/coingecko-mcp) | ## 🔗 Endpoint Options Each remote server offers two connection methods to ensure compatibility with various MCP clients: ### Primary Endpoint (HTTP Streaming) \* \*\*Public Server\*\*: \`https://mcp.api.coingecko.com/mcp\` \* \*\*Pro Server\*\*: \`https://mcp.pro-api.coingecko.com/mcp\` \* Uses HTTP streaming protocol for real-time data transfer. \* Recommended for most modern MCP clients. ### Alternative Endpoint (SSE — Server-Sent Events) \* \*\*Public Server\*\*: \`https://mcp.api.coingecko.com/sse\` \* \*\*Pro Server\*\*: \`https://mcp.pro-api.coingecko.com/sse\` \* Uses Server-Sent Events for compatibility. \* Use this if you encounter connection issues with the primary endpoint. Most clients work with either endpoint. The configuration examples below use the SSE endpoint by default for maximum compatibility. \## Remote Server (Public, Keyless) The easiest way to get started. Just add the following to your client's \`mcp\_config.json\` file. \### Client-Specific Config The file name and location depend on your client. Find your config file here: \[modelcontextprotocol.io/quickstart\](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) Add the following configuration to your \`mcp\_config.json\`: \`\`\`json JSON theme={null} { "mcpServers": { "coingecko\_mcp": { "command": "npx", "args": \[ "mcp-remote", "https://mcp.api.coingecko.com/mcp" \] } } } \`\`\` Here's a quick 2-minute tutorial for setting up the public server with Claude Desktop: \## Remote Server (Authenticated) To access more tools and higher rate limits, use your CoinGecko API key with our hosted "Bring Your Own Key" (BYOK) server. Get your API key \[here\](https://www.coingecko.com/en/api/pricing) ### Step 1: Add the configuration Add the following configuration to your \`mcp\_config.json\`: \`\`\`json JSON theme={null} { "mcpServers": { "coingecko\_mcp": { "command": "npx", "args": \[ "mcp-remote", "https://mcp.pro-api.coingecko.com/mcp" \] } } } \`\`\` ### Step 2: Authorize your MCP access After adding the config, the first time your client tries to use the CoinGecko MCP, a new browser tab will open, redirecting you to our authentication page: 
\* Simply paste in your CoinGecko API key, and authorize to link your key to the MCP session. ✨ Don't have an API key yet? Upgrade to Pro today! Read more \[here\](https://www.coingecko.com/en/api/pricing). \* You can also toggle between dynamic/static tools here. Learn more about \[Dynamic Tools\](#dynamic-vs-static-tools). ## Local Server (API Key Required) For local development and maximum control, run the MCP server directly on your machine. This method offers the rate limits based on your API plan. \`\`\`json JSON theme={null} { "mcpServers": { "coingecko\_mcp\_local": { "command": "npx", "args": \[ "-y", "@coingecko/coingecko-mcp" \], "env": { "COINGECKO\_PRO\_API\_KEY": "YOUR\_PRO\_API\_KEY", "COINGECKO\_ENVIRONMENT": "pro" } } } } \`\`\` ✨ Don't have an API key yet? Get your free Demo key or upgrade to Pro! Read more \[here\](https://www.coingecko.com/en/api/pricing). \* Configure the \`env\` based on your API key tier: \* Pro API access: \`\`\`json JSON theme={null} ... "env": { "COINGECKO\_PRO\_API\_KEY": "YOUR\_PRO\_API\_KEY", "COINGECKO\_ENVIRONMENT": "pro" } ... \`\`\` \* Demo API access: \`\`\`json JSON theme={null} ... "env": { "COINGECKO\_DEMO\_API\_KEY": "YOUR\_DEMO\_API\_KEY", "COINGECKO\_ENVIRONMENT": "demo" } ... \`\`\` # 🚀 Connecting with Claude Connecting CoinGecko MCP to Claude is straightforward. The method varies slightly depending on your Claude plan. ## For Claude Free Users (via Claude Desktop) You \*\*must use the Claude Desktop app\*\* and modify the configuration file. 1. \*\*Locate\`claude\_desktop\_config.json\`\*\*: Follow the instructions \[here\](https://modelcontextprotocol.io/quickstart/user) to find the file on your system. 2. \*\*Add a server config\*\*: Copy and paste one of the server configs above that matches your use case. 3. \*\*Restart Claude Desktop\*\*: Close and reopen the app for the changes to take effect. ## For Claude Pro Users ### Tips You can also follow the same steps as the Free users by modifying the \`claude\_desktop\_config.json\` file. 1. In Claude (\[claude.ai\](https://claude.ai/) or the Desktop app), click on 'Add connectors' in your chat. 
2. Click on 'Add custom connector' 
3. Remote MCP server URL: \* Keyless access: \`https://mcp.api.coingecko.com/mcp\` \* Authenticated access (BYOK): \`https://mcp.pro-api.coingecko.com/mcp\` 
4. Click on 'Add', and you're ready to go! # 🚀 Connecting with ChatGPT OpenAI ChatGPT have just launched an MCP connector, but requires \[developer mode\](https://platform.openai.com/docs/guides/developer-mode) toggle turned on. 1. Open your profile > Connectors > Advanced Settings > Toggle Developer Mode On 2. In the Connectors modal, choose "Create" and enter the CoinGecko MCP server info 
3. Before prompting, choose "+" > More > Developer Mode > CoinGecko MCP tool must be turned on 
# 💡 Example Prompts Tap into the full potential of CoinGecko data — use these prompts to kickstart your next AI build. ### Simple Queries > \* What is the current price of Bitcoin in USD? > \* What is the market cap of Ethereum? > \* What are the top 3 trending coins on CoinGecko right now? > \* What are the top AI coins on GeckoTerminal now? > \* What is the floor price of the Pudgy Penguins NFT collection? ### Advanced Queries > \* Show me the current top 10 cryptocurrencies by market cap. Include their price, 24h change, and total volume. Display this in an interactive table. > > 
> > \* Generate a 30-day price chart for Ethereum (ETH) against USD, showing both price and trading volume. > > 
### Creative and Fun Ideas > \* Create a quiz to tell me which cryptocurrency I am based on my personality. > > 
> > Try it here: \[claude.ai/public/artifacts\](https://claude.ai/public/artifacts/586275b9-9ff8-4d9f-9b43-0c080f6e9c80) > > \* Build a Wordle-style game where the answer is a crypto asset's name or symbol, like 'BITCOIN' or 'SHIBA'. > > 
> > Try it here: \[claude.ai/public/artifacts\](https://claude.ai/public/artifacts/41efabb7-76b9-43c7-8349-cbbe1d52a022) # ⚙️ Tips ## API Key Differences (Demo vs. Pro) Choosing between a Demo and Pro key for your MCP server impacts your access to data and tools. | Feature | Demo (\[Guide here\](https://support.coingecko.com/hc/en-us/articles/21880397454233-User-Guide-How-to-sign-up-for-CoinGecko-Demo-API-and-generate-an-API-key)) | Pro | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | \*\*Rate Limit\*\* | 30 calls/min | Starts at 500 calls/min | | \*\*Monthly Credits\*\* | 10,000 | Starts at 500,000 | | \*\*Historical Data\*\* | Past 1 year | From 2013 until now | | \*\*MCP Tools\*\* | Limited access | Full access, including exclusive tools:
- \[Top Gainers & Losers\](/reference/coins-top-gainers-losers)
- \[NFTs Collection Historical Chart\](/reference/nfts-id-market-chart)
- \[🔥 Megafilter for Pools\](/reference/pools-megafilter)
- \[Pools by Category ID\](/reference/pools-category) | 🔥 Ready to upgrade? Explore \[our API plans\](https://www.coingecko.com/en/api/pricing). ## Dynamic vs. Static Tools When running our CoinGecko MCP server, you can choose how the LLM client discovers tools. \* \*\*Static (Default)\*\*: The AI is given a complete list of tools and their functions upfront. This is faster for specific, known tasks. \* \*\*Dynamic\*\*: The AI first asks the server for available tools based on a keyword search, then learns how to use them. This is flexible but can be slower. For a deeper dive, read the \[official documentation\](https://www.stainless.com/changelog/mcp-dynamic-tools) from Stainless. ## Using \`llms.txt\` To help AI models interact with CoinGecko data effectively, we provide an \`llms.txt\` file at \[/llms-full.txt\](/llms-full.txt). This file gives models context on how to best query our API, ensuring more accurate and efficient data retrieval. We recommend utilizing this in your integrations. \*\*\* CoinGecko MCP Server is powered by \[Stainless\](https://www.stainless.com/) ✱ Have feedback, a cool idea, or need help? Reach out to \`soonaik@coingecko\[dot\]com\` or fill in \[this feedback form\](https://docs.google.com/forms/d/e/1FAIpQLSf06DOBauiZ8XS6NwWXUUwhFluH7jKHOAa3y4VsrkyGbLKyfA/viewform). # Python AI Prompts Source: https://docs.coingecko.com/docs/python-ai-prompts A comprehensive AI prompt to guide coding assistants in correctly implementing the official CoinGecko Python SDK for reliable API integration. ## How to Use Our Prompts Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant. 1. For \*\*Chat Interfaces (Claude, ChatGPT, etc.)\*\*: Paste the prompt at the beginning of your conversation before asking the AI to write code. 2. For \*\*Cursor IDE\*\*: Add the prompt to your project's \`Rules\` to enforce the guidelines across all AI interactions. 3. For \*\*GitHub Copilot\*\*: Save the prompt to a file (e.g. \`coingecko\_rules.md\`) and reference it in your chat with \`@workspace #coingecko\_rules.md\`. 4. For \*\*Claude Code\*\*: Include the prompt in your CLAUDE.md file. \`\`\`\`markdown Markdown theme={null} # Goal: Generate Python code for the CoinGecko API using ONLY the official \`coingecko\_sdk\`. ## 🚨 Critical Rules 1. \*\*SDK Exclusivity\*\*: - \*\*ALWAYS\*\* use the official \`coingecko\_sdk\` package. - \*\*NEVER\*\* use the old \`pycoingecko\` library or make direct HTTP requests with \`requests\`, \`httpx\`, or \`urllib\`. 2. \*\*Authentication\*\*: - \*\*ALWAYS\*\* load the API key from environment variables (e.g., \`os.environ.get("COINGECKO\_PRO\_API\_KEY")\`). - \*\*NEVER\*\* hardcode API keys or any other credentials in the source code. 3. \*\*Client Implementation\*\*: - \*\*ALWAYS\*\* initialize a single, reusable client instance (\`Coingecko\` or \`AsyncCoingecko\`) for the application. - \*\*ALWAYS\*\* configure automatic retries by setting the \`max\_retries\` parameter on the client. - \*\*NEVER\*\* implement manual retry loops using \`time.sleep()\`. The SDK handles this internally. 4. \*\*Error Handling\*\*: - \*\*ALWAYS\*\* catch specific SDK exceptions (e.g., \`coingecko\_sdk.RateLimitError\`, \`coingecko\_sdk.NotFoundError\`). - \*\*NEVER\*\* use a generic \`except Exception:\` block to catch known API errors. ## ✅ Correct Implementation Example This is the standard for all generated code. \`\`\`python # src/api/client.py import os from coingecko\_sdk import Coingecko, AsyncCoingecko # Initialize a single, reusable client. This should be imported and used application-wide. client = Coingecko( pro\_api\_key=os.environ.get("COINGECKO\_PRO\_API\_KEY"), environment="pro", max\_retries=3, # Rely on the SDK's built-in retry mechanism. ) # Optional: Initialize a single async client for concurrent applications. async\_client = AsyncCoingecko( pro\_api\_key=os.environ.get("COINGECKO\_PRO\_API\_KEY"), environment="pro", max\_retries=3, ) # src/main.py from api.client import client from coingecko\_sdk import RateLimitError, APIError def get\_bitcoin\_price(): try: price\_data = client.simple.price.get( ids="bitcoin", vs\_currencies="usd", ) # Access data using Pydantic models or dictionary keys return price\_data\['bitcoin'\].usd except RateLimitError: print("Rate limit exceeded. Please try again later.") return None except APIError as e: print(f"An API error occurred: {e}") return None if \_\_name\_\_ == "\_\_main\_\_": price = get\_bitcoin\_price() if price: print(f"The current price of Bitcoin is: ${price}") \`\`\` ## ❌ Deprecated Patterns to AVOID You \*\*MUST NOT\*\* generate code that includes any of the following outdated patterns. \`\`\`python # ❌ NO direct HTTP requests. import requests response = requests.get('\[https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs\_currencies=usd\](https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs\_currencies=usd)') # ❌ NO use of the outdated \`pycoingecko\` library. from pycoingecko import CoinGeckoAPI cg = CoinGeckoAPI() # ❌ NO hardcoded API keys. client = Coingecko(pro\_api\_key='CG-abc123xyz789') # ❌ NO manual retry loops. The SDK's \`max\_retries\` handles this. import time for i in range(3): try: data = client.simple.price.get(ids='bitcoin', vs\_currencies='usd') break except: time.sleep(5) # ❌ NO generic exception handling for API errors. try: data = client.simple.price.get(ids='bitcoin', vs\_currencies='usd') except Exception as e: print(f"An error occurred: {e}") \`\`\` ## 📝 Final Check Before providing a response, you \*\*MUST\*\* verify that your generated code: 1. Imports and uses \`coingecko\_sdk\`. 2. Loads the API key from environment variables. 3. Follows all other Critical Rules. 4. Does \*\*NOT\*\* contain any Deprecated Patterns. \`\`\`\` ## Resources \* \*\*GitHub\*\*: \[github.com/coingecko/coingecko-python\](https://github.com/coingecko/coingecko-python) \* \*\*PyPI\*\*: \[pypi.org/project/coingecko-sdk/\](https://pypi.org/project/coingecko-sdk/) Notice something off or missing? Let us know by opening an \[Issue here\](https://github.com/coingecko/coingecko-python/issues). \*\*\* Have feedback, a cool idea, or need help? Reach out to \`soonaik@coingecko\[dot\]com\` # CoinGecko SDK (Beta) Source: https://docs.coingecko.com/docs/sdk Official CoinGecko Typescript and Python SDKs — Crypto Price & Market Data API 
# Unlock the Power of CoinGecko API with Unprecedented Ease The official CoinGecko Typescript and Python SDK are now available for all developers! These SDKs dramatically streamline your integration process, enabling you to build powerful crypto applications faster and more reliably than ever before, regardless of your preferred language. ### Designed to make your life easier: Common Benefits of Our SDKs \* \*\*Official Support\*\*: Both SDKs are maintained by the CoinGecko team, ensuring up-to-date features, reliable access, and dedicated support. \* \*\*Reduced Boilerplate\*\*: Say goodbye to manual request construction and parsing. Our SDKs handle the complexities, allowing you to focus on your application logic. \* \*\*Faster Development\*\*: Build and iterate quicker with intuitive methods, clear documentation, and pre-built functionalities tailored for each language. \* \*\*Seamless Integration\*\*: Effortlessly incorporate CoinGecko data into your existing Python or TypeScript projects. # 🟦 CoinGecko TypeScript SDK Purpose-built to unlock the full capabilities of TypeScript for seamless integration with CoinGecko's API. \* \*\*Full Type Safety\*\*: Catch errors at compile time and write cleaner, more predictable code with strict TypeScript support. \* \*\*Developer-Centric Design\*\*: Enjoy a streamlined developer experience with intuitive interfaces, strong typings, and structured classes. ## Install via \`npm\` \`\`\`bash Bash theme={null} npm install @coingecko/coingecko-typescript \`\`\` ### Resources \* \*\*GitHub\*\* — \[github.com/coingecko/coingecko-typescript\](https://github.com/coingecko/coingecko-typescript) \* \*\*npm\*\* — \[npmjs.com/package/@coingecko/coingecko-typescript\](https://www.npmjs.com/package/@coingecko/coingecko-typescript) Notice something off or missing? Let us know by opening an \[Issue here\](https://github.com/coingecko/coingecko-typescript/issues). # 🐍 CoinGecko Python SDK Built to seamlessly integrate with the Python ecosystem, enabling fast and intuitive access to CoinGecko's API. \* \*\*Pythonic Simplicity\*\*: Leverage idiomatic Python to interact with the API effortlessly—ideal for data analysis, prototyping, or production use. \* \*\*Streamlined Development\*\*: Clean and consistent interface designed to accelerate workflows and reduce boilerplate in your Python projects. ## Install via \`pip\` \`\`\`bash Bash theme={null} pip install coingecko-sdk \`\`\` ### Resources \* \*\*GitHub\*\* — \[github.com/coingecko/coingecko-python\](https://github.com/coingecko/coingecko-python) \* \*\*PyPI\*\* — \[pypi.org/project/coingecko-sdk/\](https://pypi.org/project/coingecko-sdk/) Notice something off or missing? Let us know by opening an \[Issue here\](https://github.com/coingecko/coingecko-python/issues). \*\*\* CoinGecko SDK is powered by \[Stainless\](https://www.stainless.com/) ✱ Have feedback, a cool idea, or need help? Reach out to \`soonaik@coingecko\[dot\]com\` # Setting Up Your API Key Source: https://docs.coingecko.com/docs/setting-up-your-api-key 👋 \*\*New to CoinGecko API?\*\* Sign up for an account \[here\](https://www.coingecko.com/en/api/pricing) ## 1. Creating a new API Key \* Once you have signed up and logged in to your CoinGecko account, go to \[Developer Dashboard\](https://www.coingecko.com/en/developers/dashboard): 
\* Click on \*\*+ Add New Key\*\* button to create a new API key: 
## 2. Making API Request \* \*\*Root URLs:\*\* \* Pro API: \`https://pro-api.coingecko.com/api/v3/\`, refer to \[Pro API Authentication\](/reference/authentication). \* Demo API: \`https://api.coingecko.com/api/v3/\`, refer to \[Demo API Authentication\](/v3.0.1/reference/authentication). \* \*\*Example using the \`/ping\` endpoint:\*\* \* Pro API: \`https://pro-api.coingecko.com/api/v3/ping?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` \* Demo API: \`https://api.coingecko.com/api/v3/ping?x\_cg\_demo\_api\_key=YOUR\_API\_KEY\` 
## 3. Edit or Delete API Key \* Go to Developer's Dashboard and click “Edit” button on a specific API Key. \* In case the API Key is compromised, you may delete the API Key by clicking the "Delete" button. \* You may also update the label and save the changes by clicking "Save" button. 
## 4. API Usage Report \* You can monitor your API usage in the Usage Report section, which provides details such as: \* Total Monthly API Calls. \* Remaining Monthly API Calls. \* Rate Limit (Request Per Minute) — maximum number of API requests allowed in one minute. \* Last Used — the timestamp of the last used instance. 
\* You can also check your full historical usage by specifying "API Keys", "timeframe" or "date range". You may export as CSV for more comprehensive view. 
## 5. Others ### Call Consumption Alerts You may enable or disable call consumption alerts in the tab below to receive emails when specific credit usage thresholds are reached. 
### Overage Option (Beta) \* The overage option enables you to make API calls when your usage exceeds the monthly credits. \* You can activate the overage option by clicking the "Turn On Overage" button, ensuring uninterrupted service and allowing you to continue making API calls or vice versa. 
# Tutorials (Beginner-friendly) Source: https://docs.coingecko.com/docs/tutorials-beginner-friendly Using CoinGecko API is super easy, even if you have no programming experience! ## 🔤 No Code \* \[Import Crypto Prices in Google Sheets\](https://www.coingecko.com/learn/import-crypto-prices-google-sheets) 
\* \[Import Crypto Prices in Microsoft Excel\](https://www.coingecko.com/learn/import-crypto-prices-excel) 
## 💻 Low Code \* \[Create Portfolio Tracker in Microsoft Excel\](https://www.coingecko.com/learn/crypto-portfolio-tracker-google-sheets) 
## 👨💻 Code \* \[Fetch Crypto Data Using Python\](https://www.coingecko.com/learn/python-query-coingecko-api) 
# TypeScript AI Prompts Source: https://docs.coingecko.com/docs/typescript-ai-prompts A comprehensive AI prompt to guide coding assistants in correctly implementing the official CoinGecko TypeScript SDK. ## How to Use Our Prompts Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant. 1. For \*\*Chat Interfaces (Claude, ChatGPT, etc.)\*\*: Paste the prompt at the beginning of your conversation before asking the AI to write code. 2. For \*\*Cursor IDE\*\*: Add the prompt to your project's \`Rules\` to enforce the guidelines across all AI interactions. 3. For \*\*GitHub Copilot\*\*: Save the prompt to a file (e.g. \`coingecko\_rules.md\`) and reference it in your chat with \`@workspace #coingecko\_rules.md\`. 4. For \*\*Claude Code\*\*: Include the prompt in your CLAUDE.md file. \`\`\`\`markdown Markdown theme={null} # Goal: Generate TypeScript code for the CoinGecko API using ONLY the official \`@coingecko/coingecko-typescript\` package. ## 🚨 Critical Rules 1. \*\*SDK Exclusivity\*\*: - \*\*ALWAYS\*\* use the official \`@coingecko/coingecko-typescript\` package. - \*\*NEVER\*\* use \`axios\`, \`fetch\`, or any other method to make direct HTTP requests. 2. \*\*Authentication\*\*: - \*\*ALWAYS\*\* load the API key from environment variables (e.g., \`process.env.COINGECKO\_PRO\_API\_KEY\` or \`dotenv\`). - \*\*NEVER\*\* hardcode API keys or any other credentials in the source code. 3. \*\*Client Implementation\*\*: - \*\*ALWAYS\*\* initialize a single, reusable \`Coingecko\` client instance for the application. - \*\*ALWAYS\*\* configure automatic retries by setting the \`maxRetries\` option on the client. - \*\*NEVER\*\* implement manual retry loops using \`setTimeout\`. The SDK handles this internally. 4. \*\*Error Handling & Types\*\*: - \*\*ALWAYS\*\* use \`async/await\` for all API calls. - \*\*ALWAYS\*\* catch specific \`APIError\` subclasses using \`instanceof\` (e.g., \`err instanceof Coingecko.RateLimitError\`). - \*\*ALWAYS\*\* use the built-in request and response types (e.g., \`Coingecko.Simple.PriceGetParams\`). - \*\*NEVER\*\* use generic \`catch (e)\` blocks for known API errors. ## ✅ Correct Implementation Example This is the standard for all generated code. \`\`\`typescript // src/api/client.ts import Coingecko from '@coingecko/coingecko-typescript'; // Initialize a single, reusable client. This should be imported and used application-wide. export const client = new Coingecko({ proAPIKey: process.env.COINGECKO\_PRO\_API\_KEY, environment: 'pro', maxRetries: 3, // Rely on the SDK's built-in retry mechanism. }); // src/main.ts import { client } from './api/client'; import Coingecko from '@coingecko/coingecko-typescript'; // Import the namespace for types async function getBitcoinPrice(): Promise { try { const params: Coingecko.Simple.PriceGetParams = { ids: 'bitcoin', vs\_currencies: 'usd', }; const priceData = await client.simple.price.get(params); return priceData.bitcoin.usd; } catch (err) { if (err instanceof Coingecko.RateLimitError) { console.error('Rate limit exceeded. Please try again later.'); } else if (err instanceof Coingecko.APIError) { console.error( \`An API error occurred: ${err.name} (Status: ${err.status})\` ); } else { console.error('An unexpected error occurred:', err); } return null; } } async function main() { const price = await getBitcoinPrice(); if (price !== null) { console.log(\`The current price of Bitcoin is: $${price}\`); } } main(); \`\`\` ## ❌ Deprecated Patterns to AVOID You \*\*MUST NOT\*\* generate code that includes any of the following outdated patterns. \`\`\`typescript // ❌ NO direct HTTP requests with fetch or axios. import axios from 'axios'; const response = await axios.get( '\[https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs\_currencies=usd\](https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs\_currencies=usd)' ); // ❌ NO hardcoded API keys. const client = new Coingecko({ proAPIKey: 'CG-abc123xyz789' }); // ❌ NO manual retry loops. The SDK's \`maxRetries\` handles this. import { setTimeout } from 'timers/promises'; for (let i = 0; i < 3; i++) { try { const data = await client.simple.price.get({ ids: 'bitcoin', vs\_currencies: 'usd', }); break; } catch (e) { await setTimeout(5000); } } // ❌ NO generic exception handling for API errors. try { const data = await client.simple.price.get({ ids: 'bitcoin', vs\_currencies: 'usd', }); } catch (e) { console.log(\`An error occurred: ${e}\`); // Too broad. Use \`instanceof\` checks. } \`\`\` ## 📝 Final Check Before providing a response, you \*\*MUST\*\* verify that your generated code: 1. Imports and uses \`@coingecko/coingecko-typescript\`. 2. Loads the API key from environment variables (e.g., \`process.env\` or \`dotenv\`). 3. Follows all other Critical Rules. 4. Does \*\*NOT\*\* contain any Deprecated Patterns. \`\`\`\` ## Resources \* \*\*GitHub\*\*: \[github.com/coingecko/coingecko-typescript\](https://github.com/coingecko/coingecko-typescript) \* \*\*npm\*\*: \[npmjs.com/package/@coingecko/coingecko-typescript\](https://www.npmjs.com/package/@coingecko/coingecko-typescript) Notice something off or missing? Let us know by opening an \[Issue here\](https://github.com/coingecko/coingecko-typescript/issues). \*\*\* Have feedback, a cool idea, or need help? Reach out to \`soonaik@coingecko\[dot\]com\` # Useful Links Source: https://docs.coingecko.com/docs/useful-links Some of the useful links to help you navigate while using the CoinGecko API #### Pricing Page and Top FAQs \* \[https://www.coingecko.com/en/api/pricing#general\](https://www.coingecko.com/en/api/pricing#general) #### CoinGecko API Status \* \[https://status.coingecko.com/\](https://status.coingecko.com/) #### CoinGecko API ID List \* \[Google Sheets\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU) #### \[Pro Swagger JSON (OAS)\](https://docs.coingecko.com/reference/endpoint-overview) \* CoinGecko Pro API — \[coingecko-pro.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-pro.json) \* GeckoTerminal Onchain API (Pro) — \[onchain-pro.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-pro.json) #### \[Public/Demo Swagger JSON (OAS)\](https://docs.coingecko.com/v3.0.1/reference/endpoint-overview) \* CoinGecko Public/Demo API — \[coingecko-demo.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/coingecko-demo.json) \* GeckoTerminal Onchain API (Demo) — \[onchain-demo.json\](https://raw.githubusercontent.com/coingecko/coingecko-api-oas/refs/heads/main/onchain-demo.json) #### Subscribe CoinGecko API newsletter update \* \[https://newsletter.coingecko.com/landing/api\\\_updates\\\_subscribe\](https://newsletter.coingecko.com/landing/api\_updates\_subscribe) #### CoinGecko Methodologies (Price, Volume, Trust Score, etc.) \* \[https://www.coingecko.com/en/methodology\](https://www.coingecko.com/en/methodology) #### Using \`llms.txt\` for AI use cases \* \[/llms-full.txt\](/llms-full.txt) #### Attributing CoinGecko Brand \* \[https://brand.coingecko.com/resources/attribution-guide\](https://brand.coingecko.com/resources/attribution-guide) # Introduction Source: https://docs.coingecko.com/index Started in 2014, CoinGecko is the world's largest independent crypto data aggregator that is integrated with more than 1,000 crypto exchanges and lists more than 18,000 coins across 600+ categories. CoinGecko API offers the most comprehensive and reliable crypto market data through RESTful JSON endpoints. CoinGecko API now serves \*\*onchain DEX data\*\* across 250+ blockchain networks, 1,700+ decentralized exchanges (DEXes), and 15M+ tokens, powered by GeckoTerminal. Thousands of forward-thinking projects, Web3 developers, researchers, institutions, and enterprises use our API to obtain \*\*price feeds, market data, metadata, and historical data of crypto assets, NFTs, and exchanges\*\*. Here are some of the \*\*common use cases\*\* for clients who use CoinGecko API: \* Crypto Exchanges (CEX, DEX), Trading Apps \* Wallets (Hot, Cold) \* Data Aggregator, Crypto Screener, Analytics Dashboard \* AI Agents, DeFAI Apps \* Block Explorer, Portfolio Tracker \* DeFi Protocols, NFT Marketplaces, Digital Bank \* Backtesting Trading Strategy \* Accounting, Tax, Audit, HR Payroll \* Research & Analysis: Media, Institution, Academic, VC, Financial \* Oracles, Bots, Payments, E-commerce
🔥 New: \[WebSocket API\](https://docs.coingecko.com/websocket) 
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our \[paid API plan\](https://www.coingecko.com/en/api/pricing) (Analyst plan & above) to access WebSocket and REST API data delivery methods.
Start by creating your CoinGecko API key Bring CoinGecko data to your AI apps export const FooterFix = () => { React.useEffect(() => { const paginationElement = document.getElementById('pagination'); if (paginationElement) paginationElement.remove(); const footerElement = document.getElementById('footer'); if (footerElement) footerElement.style.marginTop = '-40px'; const feedbackToolbarClass = document.querySelector('.feedback-toolbar'); if (feedbackToolbarClass) feedbackToolbarClass.style.paddingBottom = '0px'; }, \[\]); return null; }; # 💼 API Usage Source: https://docs.coingecko.com/reference/api-usage reference/api-reference/coingecko-pro.json get /key This endpoint allows you to \*\*monitor your account's API usage, including rate limits, monthly total credits, remaining credits, and more\*\* ### Note For a more comprehensive overview of your API usage, please log in to \[https://www.coingecko.com/en/developers/dashboard\](https://www.coingecko.com/en/developers/dashboard). # Asset Platforms List (ID Map) Source: https://docs.coingecko.com/reference/asset-platforms-list reference/api-reference/coingecko-pro.json get /asset\_platforms This endpoint allows you to \*\*query all the asset platforms on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of asset platforms for other endpoints that contain params like \`id\` or\`ids\`(asset platforms). \* You may include NFT at the \`filter\` params to get the list of NFT-support asset platforms on CoinGecko. # Authentication (Pro API) Source: https://docs.coingecko.com/reference/authentication Authentication method for CoinGecko Pro API (Paid plan subscribers with Pro-API keys) ### \*\*Notes\*\* \* Pro API Key is only available for \[CoinGecko API paid plan\](https://www.coingecko.com/en/api/pricing) subscribers, the root URL for CoinGecko Pro API must be \`https://pro-api.coingecko.com/api/v3/\`. \* You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL. \* It's highly recommended to use the Headers method when making API requests for better security. Using query string parameters can risk exposing your API key. ## CoinGecko API Authentication Method If this is your first time using the Pro API key, you can supply API Key to the root URL using one of these ways: 1. Header (Recommended): \`x-cg-pro-api-key\` 2. Query String Parameter: \`x\_cg\_pro\_api\_key\` | Authentication Method | Example using \[Ping\](/reference/ping-server) Endpoint | | ---------------------- | --------------------------------------------------------------------------------------------- | | Header (cURL) | \`curl -X GET "https://pro-api.coingecko.com/api/v3/ping" -H "x-cg-pro-api-key: YOUR\_API\_KEY"\` | | Query String Parameter | \`https://pro-api.coingecko.com/api/v3/ping?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` | ## 🔥 Accessing Onchain DEX data You can now use the Pro-API key (exclusive to any paid plan subscriber) to call onchain DEX data powered by \[GeckoTerminal\](https://www.geckoterminal.com/). ### \*\*Notes\*\* \* Authentication method for onchain endpoints is exactly same as other endpoints. \* When using the CG Pro API to access onchain DEX data, include the \`/onchain\` endpoint path in the request. | Authentication Method | Example using \[Simple Token Price\](/reference/onchain-simple-price) Endpoint | | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Header (cURL) | \`curl -X GET "" -H "x-cg-pro-api-key: YOUR\_API\_KEY"\` | | Query String Parameter | \`https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token\_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2?x\_cg\_pro\_api\_key=YOUR\_API\_KEY\` | ## API Key Usage Credits \* Each request made to any endpoint counts as a single call (1 call = 1 credit). \* Each successful API request (Status 200) will deduct 1 credit from your monthly credit allowance. \* Unsuccessful Requests (Status 4xx, 5xx, etc) will not count towards credit deduction. \* Regardless of the HTTP status code returned (including 4xx and 5xx errors), all API requests will count towards your \*\*minute rate limit\*\*. \* Your monthly credit & rate limit are determined by the paid plan to which you subscribe. For more details, please refer to this \[page\](https://www.coingecko.com/en/api/pricing). \* To check the API usage, please go to the \[developer dashboard\](https://www.coingecko.com/en/developers/dashboard) or follow the guide \[here\](/reference/setting-up-your-api-key#4-api-usage-report) # 💼 Categories List Source: https://docs.coingecko.com/reference/categories-list reference/api-reference/onchain-pro.json get /categories This endpoint allows you to \*\*query all the supported categories on GeckoTerminal\*\* ### Tips \* You can retrieve pools or tokens of a specific category with this endpoint: \[Pools by Category ID\](/reference/pools-category). \* GeckoTerminal categories are different from \[CoinGecko categories\](/reference/coins-categories-list). ### Note \* This endpoint returns 50 categories per page. \* GeckoTerminal Equivalent Page: \[https://www.geckoterminal.com/category\](https://www.geckoterminal.com/category) \* Cache/Update frequency: every 60 seconds. \* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # Coins Categories List with Market Data Source: https://docs.coingecko.com/reference/coins-categories reference/api-reference/coingecko-pro.json get /coins/categories This endpoint allows you to \*\*query all the coins categories with market data (market cap, volume, ...) on CoinGecko\*\* ### Note \* CoinGecko Equivalent Page: \[https://www.coingecko.com/en/categories\](https://www.coingecko.com/en/categories). \* Cache / Update Frequency: every 5 minutes for all the API plans. \* CoinGecko categories are different from \[GeckoTerminal categories\](/reference/categories-list). # Coins Categories List (ID Map) Source: https://docs.coingecko.com/reference/coins-categories-list reference/api-reference/coingecko-pro.json get /coins/categories/list This endpoint allows you to \*\*query all the coins categories on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of categories for other endpoints that contain params like \`category\`. ### Note \* CoinGecko Equivalent Page: \[https://www.coingecko.com/en/categories\](https://www.coingecko.com/en/categories). \* Cache / Update Frequency: every 5 minutes for all the API plans. \* CoinGecko categories are different from \[GeckoTerminal categories\](/reference/categories-list). # Coin Data by Token Address Source: https://docs.coingecko.com/reference/coins-contract-address reference/api-reference/coingecko-pro.json get /coins/{id}/contract/{contract\_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\*\* ### Notice \* Please note that the \`twitter\_followers\` data field will no longer be supported by our API starting on May 15, 2025. Please refer to \[changelog\](/changelog#upcoming-change-notice%3A-removal-of-twitter-followers-data) for more details. ### 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\`\](/reference/coins-list) endpoint (\`include platform = true\`). ### Note \* Coin descriptions may include newline characters represented as \`\\r\\n\` (escape sequences), which may require processing for proper formatting. \* Cache / Update Frequency: every 60 seconds for all the API plans. # Coin Data by ID Source: https://docs.coingecko.com/reference/coins-id reference/api-reference/coingecko-pro.json get /coins/{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\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may also flag to include more data such as tickers, market data, community data, developer data and sparkline. \* You may refer to \`last\_updated\` in the endpoint response to check whether the price is stale. ### Note \* Tickers are limited to 100 items, to get more tickers, please go to \[/coins/{id}/tickers\](/reference/coins-id-tickers). \* Coin descriptions may include newline characters represented as \`\\r\\n\` (escape sequences), which may require processing for proper formatting. \* 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. \* Community data for Telegram will be updated on weekly basis (Reddit & Twitter community data are no longer supported). # 👑 Circulating Supply Chart by ID Source: https://docs.coingecko.com/reference/coins-id-circulating-supply-chart reference/api-reference/coingecko-pro.json get /coins/{id}/circulating\_supply\_chart This endpoint allows you to \*\*query historical circulating supply of a coin by number of days away from now based on provided coin ID\*\* ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from now = \*\*5-minutely\*\* data \* 2-90 days from now = \*\*hourly\*\* data \* 91 days & above from now = \*\*daily\*\* data (00:00 UTC) \* Data Availability: from 22 June 2019. \* Cache/Update Frequency: 5 minutes. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Exclusive for Enterprise Plan Subscribers only. # 👑 Circulating Supply Chart within Time Range by ID Source: https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range reference/api-reference/coingecko-pro.json get /coins/{id}/circulating\_supply\_chart/range This endpoint allows you to \*\*query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID\*\* ### Tips \* Supports ISO date strings (\`YYYY-MM-DD\` or\\ \`YYYY-MM-DDTHH:MM\`, recommended for best compatibility) or UNIX timestamps. ### Note \* You may leave the interval params as empty for automatic granularity: \* date range is 1 day from now = \*\*5-minutely\*\* data \* date range is within 2-90 days from now = \*\*hourly\*\* data \* date range is 91 days & above from now = \*\*daily\*\* data (00:00 UTC) \* Data Availability: from 22 June 2019. \* Cache/Update Frequency: 5 minutes. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Exclusive for Enterprise Plan Subscribers only. # Coin Historical Data by ID Source: https://docs.coingecko.com/reference/coins-id-history reference/api-reference/coingecko-pro.json get /coins/{id}/history 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\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* The data returned is at \`00:00:00 UTC\` \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). # Coin Historical Chart Data by ID Source: https://docs.coingecko.com/reference/coins-id-market-chart reference/api-reference/coingecko-pro.json get /coins/{id}/market\_chart 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\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may use tools like \[epoch converter \](https://www.epochconverter.com) to convert human readable date to UNIX timestamp. ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 2 - 90 days from current time = \*\*hourly\*\* data \* above 90 days from current time = \*\*daily\*\* data (00:00 UTC) \* For \*\*non-Enterprise plan subscribers\*\* who would like to get hourly data, please leave the interval params empty for auto granularity. \* The \*\*5-minutely\*\* and \*\*hourly\*\* interval params are also exclusively available to \*\*Enterprise plan subscribers,\*\* bypassing auto-granularity: \* \`interval=5m\`: 5-minutely historical data (responses include information from the past 10 days, up until now). \* \`interval=hourly\`: hourly historical data (responses include information from the past 100 days, up until now). \* Cache / Update Frequency: \* Every 30 seconds for all the API plans (for last data point). \* The last completed UTC day (00:00) data is available \*\*10 minutes after midnight\*\* on the next UTC day (00:10). # Coin Historical Chart Data within Time Range by ID Source: https://docs.coingecko.com/reference/coins-id-market-chart-range reference/api-reference/coingecko-pro.json get /coins/{id}/market\_chart/range 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\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* Supports ISO date strings (\`YYYY-MM-DD\` or\\ \`YYYY-MM-DDTHH:MM\`, recommended for best compatibility) or UNIX timestamps. ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 1 day from any time (except current time) = \*\*hourly\*\* data \* 2 - 90 days from any time = \*\*hourly\*\* data \* above 90 days from any time = \*\*daily\*\* data (00:00 UTC) \* For \*\*non-Enterprise plan subscribers\*\* who would like to get hourly data, please leave the interval params empty for auto granularity. \* The \*\*5-minutely\*\* and \*\*hourly\*\* interval params are also exclusively available to \*\*Enterprise plan subscribers\*\*, bypassing auto-granularity: \* \`interval=5m\`: 5-minutely historical data, supports up to \*\*any 10 days\*\* date range per request. \* \`interval=hourly\`: hourly historical data, supports up to \*\*any 100 days\*\* date range per request. \* Data availability: \* \`interval=5m\`: Available from 9 February 2018 onwards. \* \`interval=hourly\`: Available from 30 Jan 2018 onwards. \* Cache / Update Frequency:\\ Based on days range (all the API plans) \* 1 day = 30 seconds cache \* 2 -90 days = 30 minutes cache \* 90 days = 12 hours cache \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC. # Coin OHLC Chart by ID Source: https://docs.coingecko.com/reference/coins-id-ohlc reference/api-reference/coingecko-pro.json get /coins/{id}/ohlc This endpoint allows you to \*\*get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* For historical chart data with better granularity, you may consider using \[/coins/\\{id}/market\\\_chart\](/reference/coins-id-market-chart) endpoint. ### Note \* The timestamp displayed in the payload (response) indicates the end (or close) time of the OHLC data. \* Data granularity (candle's body) is automatic: \* 1 - 2 days: 30 minutes \* 3 - 30 days: 4 hours \* 31 days and beyond: 4 days \* Cache / Update Frequency: \* Every 15 minutes for all the API plans \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Exclusive \*\*daily\*\* and \*\*hourly\*\* candle interval parameter for all paid plan subscribers (\`interval = daily\`, \`interval=hourly\`) \* '\*\*daily\*\*' interval is available for \*\*1 / 7 / 14 / 30 / 90 / 180\*\* days only. \* '\*\*hourly\*\*' interval is available for \*\*1 / 7 / 14 / 30 / 90\*\* days only. # 💼 Coin OHLC Chart within Time Range by ID Source: https://docs.coingecko.com/reference/coins-id-ohlc-range reference/api-reference/coingecko-pro.json get /coins/{id}/ohlc/range 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\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* For historical chart data with better granularity, you may consider using \[/coins/{\`id\`}/market\\\_chart\](/reference/coins-id-market-chart) endpoint. \* Supports ISO date strings (\`YYYY-MM-DD\` or\\ \`YYYY-MM-DDTHH:MM\`, recommended for best compatibility) or UNIX timestamps. ### Note \* The timestamp displayed in the payload (response) indicates the end (or close) time of the OHLC data. \* Interval Options: \* Daily Interval (\`interval=daily\`): \* up to 180 days per request/ 180 daily interval candles. \* Hourly Interval (\`interval=hourly\`): \* up to 31 days per request/ 744 hourly interval candles. \* Data availability: \* Available from 9 February 2018 onwards (\`1518147224\` epoch time). \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). \* Cache / Update Frequency: \* Every 15 minutes for all the API plans. # Coin Tickers by ID Source: https://docs.coingecko.com/reference/coins-id-tickers reference/api-reference/coingecko-pro.json get /coins/{id}/tickers This endpoint allows you to \*\*query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID\*\* ### 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\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may specify the \`exchange\_ids\` if you want to retrieve tickers for specific exchange only. \* You may include values such as \`page\` to specify which page of responses you would like to show. \* You may also flag to include more data such as exchange logo and depth. ### Note \* The tickers are paginated to 100 items. \* 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. \* When order is sorted by \`volume\`, \*\*\*converted\\\_volume\*\*\* will be used instead of \*\*\*volume\*\*\*. \* Cache / Update Frequency: every 2 minutes for all the API plans. # 👑 Total Supply Chart by ID Source: https://docs.coingecko.com/reference/coins-id-total-supply-chart reference/api-reference/coingecko-pro.json get /coins/{id}/total\_supply\_chart This endpoint allows you to \*\*query historical total supply of a coin by number of days away from now based on provided coin ID\*\* ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from now = \*\*5-minutely\*\* data \* 2-90 days from now = \*\*hourly\*\* data \* 91 days & above from now = \*\*daily\*\* data (00:00 UTC) \* Data Availability: from 22 June 2019 \* Cache/Update Frequency: 5 minutes. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Exclusive for Enterprise Plan Subscribers only. # 👑 Total Supply Chart within time range by ID Source: https://docs.coingecko.com/reference/coins-id-total-supply-chart-range reference/api-reference/coingecko-pro.json get /coins/{id}/total\_supply\_chart/range This endpoint allows you to \*\*query historical total supply of a coin, within a range of timestamp based on the provided coin ID\*\* ### Tips \* Supports ISO date strings (\`YYYY-MM-DD\` or\\ \`YYYY-MM-DDTHH:MM\`, recommended for best compatibility) or UNIX timestamps. ### Note \* Cache/Update Frequency: 5 minutes. \* The data is provided at daily intervals (00:00:00 UTC). \* Data Availability: from 22 June 2019 \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Exclusive for Enterprise Plan Subscribers only. # Coins List (ID Map) Source: https://docs.coingecko.com/reference/coins-list reference/api-reference/coingecko-pro.json get /coins/list This endpoint allows you to \*\*query all the supported coins on CoinGecko with coins ID, name and symbol\*\* ### Tips \* You may use this endpoint to query the list of coins with coin id for other endpoints that contain params like \`id\` or \`ids\` (coin ID). \* By default, this endpoint returns full list of active coins that are currently listed on CoinGecko.com , you can also flag \`status=inactive\` to retrieve coins that are no longer available on CoinGecko.com . The inactive coin IDs can also be used with \[selected historical data\](/changelog#april-2024) endpoints. ### Note \* There is no pagination required for this endpoint. \* Cache/Update Frequency: every 5 minutes for Pro API (Analyst, Lite, Pro, Enterprise). # 💼 Recently Added Coins Source: https://docs.coingecko.com/reference/coins-list-new reference/api-reference/coingecko-pro.json get /coins/list/new This endpoint allows you to \*\*query the latest 200 coins that recently listed on CoinGecko\*\* ### Note \* CoinGecko equivalent page: \[https://www.coingecko.com/en/new-cryptocurrencies\](https://www.coingecko.com/en/new-cryptocurrencies). \* Cache/Update Frequency: Every 30 seconds. \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # Coins List with Market Data Source: https://docs.coingecko.com/reference/coins-markets reference/api-reference/coingecko-pro.json get /coins/markets This endpoint allows you to \*\*query all the supported coins with price, market cap, volume and market related data\*\* ### Tips \* You can retrieve specific coins using their unique \`ids\`, \`names\`, or \`symbols\` instead of returning the whole list. \* To filter results based on the coin's category, use the \`category\` param (refer to \[\`/coins/categories/list\`\](/reference/coins-categories-list) for available categories). \* Use the \`per\_page\` and \`page\` params to manage the number of results you receive and navigate through the data. ### Note \* When multiple lookup params are provided, the following priority order is applied: \`category\` (highest) > \`ids\` > \`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 45 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # 💼 Top Gainers & Losers Source: https://docs.coingecko.com/reference/coins-top-gainers-losers reference/api-reference/coingecko-pro.json get /coins/top\_gainers\_losers This endpoint allows you to \*\*query the top 30 coins with largest price gain and loss by a specific time duration\*\* ### Note \* The endpoint response only includes coins with a 24-hour trading volume of at least \\$50,000. \* CoinGecko equivalent page: \[https://www.coingecko.com/en/crypto-gainers-losers\](https://www.coingecko.com/en/crypto-gainers-losers). \* Cache/Update Frequency: Every 5 minutes. \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # Crypto Treasury Holdings by Coin ID Source: https://docs.coingecko.com/reference/companies-public-treasury reference/api-reference/coingecko-pro.json get /{entity}/public\_treasury/{coin\_id} This endpoint allows you \*\*query public companies & governments' cryptocurrency holdings\*\* by Coin ID ### Note \* The responses are sorted in descending order based on total holdings. \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/bitcoin\](https://www.coingecko.com/en/treasuries/bitcoin) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Coin Historical Chart Data by Token Address Source: https://docs.coingecko.com/reference/contract-address-market-chart reference/api-reference/coingecko-pro.json get /coins/{id}/contract/{contract\_address}/market\_chart 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\*\* ### 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\`\](/reference/coins-list) endpoint (\`include platform = true\`). ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 2 - 90 days from current time = \*\*hourly\*\* data \* above 90 days from current time = \*\*daily\*\* data (00:00 UTC) \* For \*\*non-Enterprise plan subscribers\*\* who would like to get hourly data, please leave the interval params empty for auto granularity. \* The \*\*5-minutely\*\* and \*\*hourly\*\* interval params are also exclusively available to \*\*Enterprise plan subscribers,\*\* bypassing auto-granularity: \* \`interval=5m\`: 5-minutely historical data (responses include information from the past 10 days up until now) \* \`interval=hourly\`: hourly historical data (responses include information from the past 100 days, up until now) \* Cache / Update Frequency: \* Every 5 minutes for all the API plans. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC. # Coin Historical Chart Data within Time Range by Token Address Source: https://docs.coingecko.com/reference/contract-address-market-chart-range reference/api-reference/coingecko-pro.json get /coins/{id}/contract/{contract\_address}/market\_chart/range 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\*\* ### 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\`\](/reference/coins-list) endpoint (\`include platform = true\`). \* Supports ISO date strings (\`YYYY-MM-DD\` or\\ \`YYYY-MM-DDTHH:MM\`, recommended for best compatibility) or UNIX timestamps. ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 1 day from any time (except current time) = \*\*hourly\*\* data \* 2 - 90 days from any time = \*\*hourly\*\* data \* above 90 days from any time = \*\*daily\*\* data (00:00 UTC) \* For \*\*non-Enterprise plan subscribers\*\* who would like to get hourly data, please leave the interval params empty for auto granularity. \* The \*\*5-minutely\*\* and \*\*hourly\*\* interval params are also exclusively available to \*\*Enterprise plan subscribers\*\*, bypassing auto-granularity: \* \`interval=5m\`: 5-minutely historical data (responses include information from the past 10 days, up until now) \* \`interval=hourly\`: hourly historical data (responses include information from the past 100 days, up until now) \* Data availability: \* \`interval=5m\`: Available from 9 February 2018 onwards \* \`interval=hourly\`: Available from 30 Jan 2018 onwards \* Cache / Update Frequency:\\ Based on days range (all the API plans) \* 1 day = 30 seconds cache \* 2 -90 days = 30 minutes cache \* 90 days = 12 hours cache \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC # Crypto Global Market Data Source: https://docs.coingecko.com/reference/crypto-global reference/api-reference/coingecko-pro.json get /global This endpoint allows you \*\*query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc\*\* ### Note \* Cache / Update Frequency: every 10 minutes for all the API plans. # Derivatives Exchanges List with Data Source: https://docs.coingecko.com/reference/derivatives-exchanges reference/api-reference/coingecko-pro.json get /derivatives/exchanges This endpoint allows you to \*\*query all the derivatives exchanges with related data (ID, name, open interest, ...) 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 \* Cache / Update Frequency: every 60 seconds for all the API plans. # Derivatives Exchange Data by ID Source: https://docs.coingecko.com/reference/derivatives-exchanges-id reference/api-reference/coingecko-pro.json get /derivatives/exchanges/{id} This endpoint allows you to \*\*query the derivatives exchange's related data (ID, name, open interest, ...) based on the exchanges' ID\*\* ### Tips \* For \`include\_tickers\` param, you may change the value to either \`all\` to include all the tickers or \`unexpired\` to include unexpired tickers in the responses. You may leave it blank to omit the tickers data. ### Note \* Cache / Update Frequency: every 30 seconds for all the API plans. # Derivatives Exchanges List (ID Map) Source: https://docs.coingecko.com/reference/derivatives-exchanges-list reference/api-reference/coingecko-pro.json get /derivatives/exchanges/list This endpoint allows you to \*\*query all the derivatives exchanges with ID and name on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of exchanges for other endpoints that contain params like \`id\` (derivatives exchange's ID). ### Note \* Cache / Update Frequency: every 5 minutes for all the API plans. # Derivatives Tickers List Source: https://docs.coingecko.com/reference/derivatives-tickers reference/api-reference/coingecko-pro.json get /derivatives This endpoint allows you to \*\*query all the tickers from derivatives exchanges on CoinGecko\*\* ### Note \* Data for \`open\_interest\` and \`volume\_24h\` in the endpoint responses are in USD. \* Cache / Update Frequency: every 30 seconds for all the API plans. # Supported Dexes List by Network (ID Map) Source: https://docs.coingecko.com/reference/dexes-list reference/api-reference/onchain-pro.json get /networks/{network}/dexes This endpoint allows you to \*\*query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal\*\* ### Tips \* You may use this endpoint to query the list of DEXs with DEX ID for other endpoints that contain params like \`dex\`. \* You may include values such as \`page\` to specify which page of responses you would like to show. # Endpoint Overview Source: https://docs.coingecko.com/reference/endpoint-overview ### Notes In the API reference pages, the plan-specific endpoint access will be marked as below: \* 💼 — exclusive for \[Analyst Plan & above\](https://www.coingecko.com/en/api/pricing) subscribers only (excluding Basic plan). \* 👑 — exclusive for \[Enterprise Plan\](https://www.coingecko.com/en/api/enterprise) subscribers only. Some endpoints may have parameters or data access that are exclusive to different plan subscribers, please refer to the endpoint reference page for details. ## CoinGecko Endpoints: Coins | Endpoint | Description | | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[/ping\](/reference/ping-server) | Check the API server status | | 💼 \[/key\](/reference/api-usage) | Check account's API usage | | \[/simple/price\](/reference/simple-price) | Query the prices of one or more coins by using their unique Coin API IDs | | \[/simple/token\\\_price/\\{id}\](/reference/simple-token-price) | Query the prices of one or more coins by using their unique Coin API IDs | | \[/simple/supported\\\_vs\\\_currencies\](/reference/simple-supported-currencies) | Query all the supported currencies on CoinGecko | | \[/coins/list\](/reference/coins-list) | Query all the supported coins on CoinGecko with coins ID, name and symbol | | 💼 \[/coins/top\\\_gainers\\\_losers\](/reference/coins-top-gainers-losers) | Query the top 30 coins with largest price gain and loss by a specific time duration | | 💼 \[/coins/list/new\](/reference/coins-list-new) | Query the latest 200 coins that recently listed on CoinGecko | | \[/coins/markets\](/reference/coins-markets) | Query all the supported coins with price, market cap, volume and market related data | | \[/coins/\\{id}\](/reference/coins-id) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID | | \[/coins/\\{id}/tickers\](/reference/coins-id-tickers) | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID | | \[/coins/\\{id}/history\](/reference/coins-id-history) | Query the historical data (price, market cap, 24hr volume, ...) at a given date for a coin based on a particular coin ID | | \[/coins/\\{id}/market\\\_chart\](/reference/coins-id-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID | | \[/coins/\\{id}/market\\\_chart/range\](/reference/coins-id-market-chart-range) | 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 | | \[/coins-id-ohlc\](/reference/coins-id-ohlc) | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID | | 💼 \[/coins/\\{id}/ohlc/range\](/reference/coins-id-ohlc-range) | Get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamp based on particular coin ID | | 👑 \[/coins/\\{id}/circulating\\\_supply\\\_chart\](/reference/coins-id-circulating-supply-chart) | Query historical circulating supply of a coin by number of days away from now based on provided coin ID | | 👑 \[/coins/\\{id}/circulating\\\_supply\\\_chart/range\](/reference/coins-id-circulating-supply-chart-range) | Query historical circulating supply of a coin, within a range of timestamp based on the provided coin ID | | 👑 \[/coins/\\{id}/total\\\_supply\\\_chart\](/reference/coins-id-total-supply-chart) | Query historical total supply of a coin by number of days away from now based on provided coin ID | | 👑 \[/coins/\\{id}/total\\\_supply\\\_chart/range\](/reference/coins-id-total-supply-chart-range) | Query historical total supply of a coin, within a range of timestamp based on the provided coin ID | | \[/coins/../contract/..\](/reference/coins-contract-address) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address | | \[/coins/../contract/../market\\\_chart\](/reference/contract-address-market-chart) | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address | | \[/coins/../contract/../market\\\_chart/range\](/reference/contract-address-market-chart-range) | 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 | | \[/coins/categories/list\](/reference/coins-categories-list) | Query all the coins categories on CoinGecko | | \[/coins/categories\](/reference/coins-categories) | Query all the coins categories with market data (market cap, volume, ...) on CoinGecko | ## CoinGecko Endpoints: NFT | Endpoint | Description | | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[/nfts/list\](/reference/nfts-list) | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko | | \[/nfts/..\](/reference/nfts-id) | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID | | \[/nfts/../contract/..\](/reference/nfts-contract-address) | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection contract address and respective asset platform | | 💼 \[/nfts/markets\](/reference/nfts-markets) | Query all the supported NFT collections with floor price, market cap, volume and market related data on CoinGecko | | 💼 \[/nfts/../market\\\_chart\](/reference/nfts-id-market-chart) | Query historical market data of a NFT collection, including floor price, market cap, and 24hr volume, by number of days away from now | | 💼 \[/nfts/../contract/../market\\\_chart\](/reference/nfts-contract-address-market-chart) | 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 | | 💼 \[/nfts/../tickers\](/reference/nfts-id-tickers) | Query the latest floor price and 24hr volume of a NFT collection, on each NFT marketplace, e.g. OpenSea and LooksRare | ## CoinGecko Endpoints: Exchanges & Derivatives | Endpoint | Description | | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | \[/exchanges\](/reference/exchanges) | Query all the supported exchanges with exchanges' data (ID, name, country, ...) that have active trading volumes on CoinGecko | | \[/exchanges/list\](/reference/exchanges-list) | Query all the exchanges with ID and name | | \[/exchanges/\\{id}\](/reference/exchanges-id) | Query exchange's data (name, year established, country, ...), exchange volume in BTC and tickers based on exchange's ID | | \[/exchanges/\\{id}/tickers\](/reference/exchanges-id-tickers) | Query exchange's tickers based on exchange's ID | | \[/exchanges/\\{id}/volume\\\_chart\](/reference/exchanges-id-volume-chart) | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID | | 💼 \[/exchanges/\\{id}/volume\\\_chart/range\](/reference/exchanges-id-volume-chart-range) | Query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID | | \[/derivatives\](/reference/derivatives-tickers) | Query all the tickers from derivatives exchanges on CoinGecko | | \[/derivatives/exchanges\](/reference/derivatives-exchanges) | Query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko | | \[/derivatives/exchanges/\\{id}\](/reference/derivatives-exchanges-id) | Query the derivatives exchange's related data (ID, name, open interest, ...) based on the exchanges' ID | | \[/derivatives/exchanges/list\](/reference/derivatives-exchanges-list) | Query all the derivatives exchanges with ID and name on CoinGecko | ## CoinGecko Endpoints: Public Treasuries | Endpoint | Description | | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | \[/entities/list\](/reference/entities-list) | Query all the supported entities on CoinGecko with entities ID, name, symbol, and country | | \[/\\{entity}/public\\\_treasury/\\{coin\\\_id}\](/reference/companies-public-treasury) | Query public companies & governments' cryptocurrency holdings by coin ID | | \[/public\\\_treasury/\\{entity\\\_id}\](/reference/public-treasury-entity) | Query public companies & governments' cryptocurrency holdings by entity ID | | \[/public\\\_treasury/\\{entity\\\_id}/.../holding\\\_chart\](/reference/public-treasury-entity-chart) | Query public companies & governments' cryptocurrency historical holdings by entity ID and coin ID | | \[/public\\\_treasury/\\{entity\\\_id}/transaction\\\_history\](/reference/public-treasury-transaction-history) | Query public companies & governments' cryptocurrency transaction history by entity ID | ## CoinGecko Endpoints: General | Endpoint | Description | | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ | | \[/asset\\\_platforms\](/reference/asset-platforms-list) | Query all the asset platforms (blockchain networks) on CoinGecko | | \[/token\\\_lists/\\{asset\\\_platform\\\_id}/all.json\](/reference/token-lists) | Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard | | \[/exchange\\\_rates\](/reference/exchange-rates) | Query BTC exchange rates with other currencies | | \[/search\](/reference/search-data) | Search for coins, categories and markets listed on CoinGecko | | \[/search/trending\](/reference/trending-search) | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours | | \[/global\](/reference/crypto-global) | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc. | | \[/global/decentralized\\\_finance\\\_defi\](/reference/global-defi) | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume | | 💼 \[/global/market\\\_cap\\\_chart\](/reference/global-market-cap-chart) | Query historical global market cap and volume data by number of days away from now | ## Onchain DEX Endpoints (GeckoTerminal) | Endpoint | Description | | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | \[/onchain/simple/networks/../token\\\_price/..\](/reference/onchain-simple-price) | Get token price based on the provided token contract address on a network | | \[/onchain/networks\](/reference/networks-list) | Query all the supported networks on GeckoTerminal | | \[/onchain/networks/../dexes\](/reference/dexes-list) | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal | | \[/onchain/networks/../pools/..\](/reference/pool-address) | Query the specific pool based on the provided network and pool address | | \[/onchain/networks/../pools/multi/..\](/reference/pools-addresses) | Query multiple pools based on the provided network and pool address | | \[/onchain/networks/trending\\\_pools\](/reference/trending-pools-list) | Query all the trending pools across all networks on GeckoTerminal | | \[/onchain/networks/../trending\\\_pools\](/reference/trending-pools-network) | Query the trending pools based on the provided network | | \[/onchain/networks/../pools\](/reference/top-pools-network) | Query all the top pools based on the provided network | | \[/onchain/networks/../dexes/../pools\](/reference/top-pools-dex) | Query all the top pools based on the provided network and decentralized exchange (DEX) | | \[/onchain/networks/new\\\_pools\](/reference/latest-pools-list) | Query all the latest pools across all networks on GeckoTerminal | | \[/onchain/networks/../new\\\_pools\](/reference/latest-pools-network) | Query all the latest pools based on provided network | | 🔥 💼 \[/onchain/pools/megafilter\](/reference/pools-megafilter) | Query pools based on various filters across all networks on GeckoTerminal | | \[/onchain/search/pools\](/reference/search-pools) | Search for pools on a network | | 💼 \[/onchain/pools/trending\\\_search\](/reference/trending-search-pools) | Query all the trending search pools across all networks on GeckoTerminal | | \[/onchain/networks/../tokens/../pools\](/reference/top-pools-contract-address) | Query top pools based on the provided token contract address on a network | | \[/onchain/networks/../tokens/..\](/reference/token-data-contract-address) | Query specific token data based on the provided token contract address on a network | | \[/onchain/networks/../tokens/multi/..\](/reference/tokens-data-contract-addresses) | Query multiple tokens data based on the provided token contract addresses on a network | | \[/onchain/networks/../tokens/../info\](/reference/token-info-contract-address) | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network | | \[/onchain/networks/../pools/../info\](/reference/pool-token-info-contract-address) | 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 | | \[/onchain/tokens/info\\\_recently\\\_updated\](/reference/tokens-info-recent-updated) | Query 100 most recently updated tokens info across all networks on GeckoTerminal | | 💼 \[/onchain/networks/../tokens/../top\\\_traders\](/reference/top-token-traders-token-address) | Query top token traders based on the provided token contract address on a network | | 💼 \[/onchain/networks/../tokens/../top\\\_holders\](/reference/top-token-holders-token-address) | Query top token holders based on the provided token contract address on a network | | 💼 \[/onchain/networks/../tokens/../holders\\\_chart\](/reference/token-holders-chart-token-address) | Get the historical token holders chart based on the provided token contract address on a network | | \[/onchain/networks/../pools/../ohlcv/..\](/reference/pool-ohlcv-contract-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network | | 💼 \[/onchain/networks/../tokens/../ohlcv/..\](/reference/token-ohlcv-token-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network | | \[/onchain/networks/../pools/../trades\](/reference/pool-trades-contract-address) | Query the last 300 trades in the past 24 hours based on the provided pool address | | 💼 \[/onchain/networks/../tokens/../trades\](/reference/token-trades-contract-address) | Query the last 300 trades in the past 24 hours across all pools, based on the provided token contract address on a network | | 💼 \[/onchain/categories\](/reference/categories-list) | Query all the supported categories on GeckoTerminal | | 💼 \[/onchain/categories/../pools\](/reference/pools-category) | Query all the pools based on the provided category ID | ⚡️ Need Real-time Data Streams? Try \[WebSocket API\](https://docs.coingecko.com/websocket) 
With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our \[paid API plan\](https://www.coingecko.com/en/api/pricing) (Analyst plan & above) to access WebSocket and REST API data delivery methods. # Entities List (ID Map) Source: https://docs.coingecko.com/reference/entities-list reference/api-reference/coingecko-pro.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/reference/exchange-rates reference/api-reference/coingecko-pro.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/reference/exchanges reference/api-reference/coingecko-pro.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/reference/exchanges-id reference/api-reference/coingecko-pro.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 16, 2025. Please refer to \[changelog\](/changelog#may-2025) for more details. ### Note \* The exchange volume in the response is provided in BTC. To convert it to other currencies, please use \[/exchange\\\_rates\](/reference/exchange-rates) endpoint. \* For derivatives (e.g. \`bitmex\`, \`binance\_futures\`), to get derivatives exchanges data, please go to \[/derivatives/exchange/\\{id}\](/reference/derivatives-exchanges-id) endpoint. \* Tickers are limited to 100 items, to get more tickers, please go to \[/exchanges/\\{id}/tickers\](/reference/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/reference/exchanges-id-tickers reference/api-reference/coingecko-pro.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/reference/exchanges-id-volume-chart reference/api-reference/coingecko-pro.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\](/reference/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. # 💼 Exchange Volume Chart within Time Range by ID Source: https://docs.coingecko.com/reference/exchanges-id-volume-chart-range reference/api-reference/coingecko-pro.json get /exchanges/{id}/volume\_chart/range This endpoint allows you to \*\*query the historical volume chart data in BTC by specifying date range in UNIX based on exchange's ID\*\* ### Note \* You can query the historical volume chart data of \*\*derivatives exchanges\*\* with this endpoint as well. \* The data interval for this endpoint is fixed at daily. \* The date range between \`from\` and \`to\` must be within 31 days. \* Cache/Update Frequency: 5 minutes \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise) # Exchanges List (ID Map) Source: https://docs.coingecko.com/reference/exchanges-list reference/api-reference/coingecko-pro.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/reference/global-defi reference/api-reference/coingecko-pro.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\*\* # 💼 Global Market Cap Chart Data Source: https://docs.coingecko.com/reference/global-market-cap-chart reference/api-reference/coingecko-pro.json get /global/market\_cap\_chart This endpoint allows you to \*\*query historical global market cap and volume data by number of days away from now\*\* ### Note \* CoinGecko equivalent page: \[https://www.coingecko.com/en/global-charts\](https://www.coingecko.com/en/global-charts). \* Data Granularity (auto): \* 1 day from now = \*\*hourly\*\* data \* 2 days & above from now = \*\*daily\*\* data \* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). \* The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). The cache will \*\*always expire at 00:05 UTC\*\*. If you wish to get the latest daily data (00:00 UTC), you can make request at 00:05 UTC or later. \* Cache / Update Frequency: every 1 minute. # New Pools List Source: https://docs.coingecko.com/reference/latest-pools-list reference/api-reference/onchain-pro.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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/explore/new-crypto-pools\](https://www.geckoterminal.com/explore/new-crypto-pools) # New Pools by Network Source: https://docs.coingecko.com/reference/latest-pools-network reference/api-reference/onchain-pro.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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/explore/new-crypto-pools/solana\](https://www.geckoterminal.com/explore/new-crypto-pools/solana) # Supported Networks List (ID Map) Source: https://docs.coingecko.com/reference/networks-list reference/api-reference/onchain-pro.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/reference/nfts-contract-address reference/api-reference/coingecko-pro.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\](/reference/nfts-list) endpoint. ### Note \* Solana NFT & Art Blocks are not supported for this endpoint, please use \[/nfts/\\{id}\](/reference/nfts-id) endpoint instead. \* Cache / Update Frequency: every 60 seconds for all the API plans. # 💼 NFTs Collection Historical Chart Data by Contract Address Source: https://docs.coingecko.com/reference/nfts-contract-address-market-chart reference/api-reference/coingecko-pro.json get /nfts/{asset\_platform\_id}/contract/{contract\_address}/market\_chart 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\*\* ### Note \* This endpoint doesn't support Solana NFT and Art Blocks, please use \[/nfts/\\{id}/market\\\_chart\](/reference/nfts-id-market-chart) endpoint instead. \* Data Granularity (auto): \* 1-14 days from now = \*\*5-minutely\*\* data \* 15 days & above from now = \*\*daily\*\* data (00:00 UTC) \* Cache/Update Frequency: every 5 minutes \* The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # NFTs Collection Data by ID Source: https://docs.coingecko.com/reference/nfts-id reference/api-reference/coingecko-pro.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 Collection Historical Chart Data by ID Source: https://docs.coingecko.com/reference/nfts-id-market-chart reference/api-reference/coingecko-pro.json get /nfts/{id}/market\_chart 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\*\* ### Note \* Data Granularity (auto): \* 1-14 days from now = \*\*5-minutely\*\* data \* 15 days & above from now = \*\*daily\*\* data (00:00 UTC) \* Cache/Update Frequency: every 5 minutes \* The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # 💼 NFTs Collection Tickers by ID Source: https://docs.coingecko.com/reference/nfts-id-tickers reference/api-reference/coingecko-pro.json get /nfts/{id}/tickers 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\*\* ### Note \* Cache/Update Frequency: every 30 seconds. \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # NFTs List (ID Map) Source: https://docs.coingecko.com/reference/nfts-list reference/api-reference/coingecko-pro.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. # 💼 NFTs List with Market Data Source: https://docs.coingecko.com/reference/nfts-markets reference/api-reference/coingecko-pro.json get /nfts/markets This endpoint allows you to \*\*query all the supported NFT collections with floor price, market cap, volume and market related data 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 \* Cache / Update Frequency: every 5 minutes. \* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). \* CoinGecko equivalent page: \[https://www.coingecko.com/en/nft\](https://www.coingecko.com/en/nft). \* Some collection with low liquidity may not be ranked by Market Cap value, learn more \[here\](https://support.coingecko.com/hc/en-us/articles/37226121227545-What-is-NFT-Market-Cap). Sorting by Mcap ranking will first prioritise Market Cap value of liquid NFT collections, then followed by trading volume of illiquid NFT collections. # Token Price by Token Addresses Source: https://docs.coingecko.com/reference/onchain-simple-price reference/api-reference/onchain-pro.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\](https://www.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 100 contract addresses\*\* per request. This limit is exclusive for \[paid plan\](https://www.coingecko.com/en/api/pricing) 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}\`\](/reference/pool-address) endpoint by providing a specific pool address. \* If \`include\_inactive\_source=true\` is set and no top pool is found for a token, the search will expand to include recently active pools up to the past 1 year. \* Cache/Update Frequency: Real-time (Cacheless) for Pro API (Basic, Analyst, Lite, Pro, Enterprise). # Check API server status Source: https://docs.coingecko.com/reference/ping-server reference/api-reference/coingecko-pro.json get /ping This endpoint allows you to \*\*check the API server status\*\* ### Note \* You can also go to \[status.coingecko.com\](https://status.coingecko.com/) to check the API server status and further maintenance notices. # Specific Pool Data by Pool Address Source: https://docs.coingecko.com/reference/pool-address reference/api-reference/onchain-pro.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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Pool OHLCV chart by Pool Address Source: https://docs.coingecko.com/reference/pool-ohlcv-contract-address reference/api-reference/onchain-pro.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\](https://www.coingecko.com/en/api/pricing) 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. \* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Pool Tokens Info by Pool Address Source: https://docs.coingecko.com/reference/pool-token-info-contract-address reference/api-reference/onchain-pro.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}\`\](/reference/pool-address) instead. \* Cache/Update frequency: every 60 seconds. \* Learn more about GT score \[here\](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). \* 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: \* \[Coin Data by ID\](/reference/coins-id) \* \[Coin Data by Token Address\](/reference/coins-contract-address) ### 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/reference/pool-trades-contract-address reference/api-reference/onchain-pro.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: Real-time (Cacheless) for Pro API (Basic, Analyst, Lite, Pro, Enterprise). # Multiple Pools Data by Pool Addresses Source: https://docs.coingecko.com/reference/pools-addresses reference/api-reference/onchain-pro.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 50 contract addresses\*\* per request. This limit is exclusive for \[paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). \* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # 💼 Pools by Category ID Source: https://docs.coingecko.com/reference/pools-category reference/api-reference/onchain-pro.json get /categories/{category\_id}/pools This endpoint allows you to \*\*query all the pools based on the provided category ID\*\* ### Tips \* You can retrieve full list of categories id via this endpoint: \[Categories List\](/reference/categories-list). \* You can retrieve tokens of a specific category, by flagging \`include=base\_token\`. \* GeckoTerminal categories are different from \[CoinGecko categories\](/reference/coins-categories-list). ### Note \* Trending rankings are determined by a combination of factors: \* User engagement on geckoterminal.com \* Market activity, such as trading volume and transactions \* Pool security and credibility, including liquidity and honeypot checks \* 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* GeckoTerminal equivalent page example: \[https://www.geckoterminal.com/category/pump-fun\](https://www.geckoterminal.com/category/pump-fun) \* Cache/Update frequency: every 30 seconds. \* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). # 🔥 Megafilter for Pools Source: https://docs.coingecko.com/reference/pools-megafilter reference/api-reference/onchain-pro.json get /pools/megafilter This endpoint allows you to \*\*query pools based on various filters across all networks on GeckoTerminal\*\* ### Tips \* Using \`checks\` param to filter pools based on various checks: \* \`checks=no\_honeypot\` — Filter out Honeypot pools, using GoPlus Token Security and De.Fi Scanner. \* \`checks=good\_gt\_score\` — Show only pools with a GT Score of at least 75. \* \`checks=on\_coingecko\` — Show only pools with tokens that are listed on CoinGecko. \* \`checks=has\_social\` — Show only pools with their social links and token information updated. \* You may include values such as \`page\` to specify which page of responses you would like to show. ### Note \* Trending rankings are determined by a combination of factors: \* User engagement on geckoterminal.com \* Market activity, such as trading volume and transactions \* Pool security and credibility, including liquidity and honeypot checks \* \`dexes\` param can only be used when \*\*only 1\`networks\`\*\* is specified. \* 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. \* Setting \`include\_unknown\_honeypot\_tokens=true\` will include tokens with an 'unknown' honeypot status. \* Please note that this param only takes effect when \`checks=no\_honeypot\` is specified. \* Cache/Update frequency: every 30 seconds. \* 💼 Exclusive for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). # Crypto Treasury Holdings by Entity ID Source: https://docs.coingecko.com/reference/public-treasury-entity reference/api-reference/coingecko-pro.json get /public\_treasury/{entity\_id} This endpoint allows you \*\*query public companies & governments' cryptocurrency holdings\*\* by Entity ID ### Note \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/bitcoin\](https://www.coingecko.com/en/treasuries/bitcoin) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Crypto Treasury Holdings Historical Chart Data by ID Source: https://docs.coingecko.com/reference/public-treasury-entity-chart reference/api-reference/coingecko-pro.json get /public\_treasury/{entity\_id}/{coin\_id}/holding\_chart This endpoint allows you to \*\*query historical cryptocurrency holdings chart of public companies & governments\*\* by Entity ID and Coin ID ### Tips \* You may obtain the entity ID and coin ID (API IDs) via several ways: \* For \`entity\_id\`: \* refers to respective public treasury entity page and find 'API ID'. \* refers to \[\`/entities/list\`\](/reference/entities-list) endpoint. \* For \`coin\_id\`: \* refers to respective coin page and find 'API ID'. \* refers to \[\`/coins/list\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* Data available from August 2020 onwards. \* Different API plans can access up to different historical periods via \`days\` param: | Plan | Maximum period | \`days\` value availability | | ----------------- | -------------- | ----------------------------------- | | Public/Demo | 1 year | \`7, 14, 30, 90, 180, 365\` | | Basic | 2 years | \`7, 14, 30, 90, 180, 365, 730\` | | Analyst and above | Full | \`7, 14, 30, 90, 180, 365, 730, max\` | \* To access longer historical periods, check out \[our API plans here\](https://www.coingecko.com/en/api/pricing) \* For \`include\_empty\_intervals\` param: \* When \`false\` (default): Only intervals with transaction data are returned. \* When \`true\`: All requested intervals are returned, populated with the most recent available transaction data. \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/companies/strategy\](https://www.coingecko.com/en/treasuries/companies/strategy) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Crypto Treasury Transaction History by Entity ID Source: https://docs.coingecko.com/reference/public-treasury-transaction-history reference/api-reference/coingecko-pro.json get /public\_treasury/{entity\_id}/transaction\_history This endpoint allows you \*\*query public companies & governments' cryptocurrency transaction history\*\* by Entity ID ### Tips \* You may obtain the entity ID via several ways: \* refers to respective public treasury entity page and find 'API ID'. \* refers to \[\`/entities/list\`\](/reference/entities-list) endpoint. \* \`coin\_ids\` param allows you to filter transaction history by specific coin IDs, comma-separated if more than 1 coin. You may obtain the coin IDs via several ways: \* refers to respective coin page and find 'API ID'. \* refers to \[\`/coins/list\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* Data available from August 2020 onwards. \* Only Analyst plan and above can request with \`page\` value greater than \`1\`. \* To unlock multi-page access, check out \[our API plans here\](https://www.coingecko.com/en/api/pricing) \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/companies/strategy\](https://www.coingecko.com/en/treasuries/companies/strategy) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Search Queries Source: https://docs.coingecko.com/reference/search-data reference/api-reference/coingecko-pro.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/reference/search-pools reference/api-reference/onchain-pro.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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. # Coin Price by IDs Source: https://docs.coingecko.com/reference/simple-price reference/api-reference/coingecko-pro.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\`\](/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* 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\](https://www.coingecko.com) and learn more about our price methodology \[here\](https://www.coingecko.com/en/methodology). \* 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 20 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Supported Currencies List Source: https://docs.coingecko.com/reference/simple-supported-currencies reference/api-reference/coingecko-pro.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 30 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Coin Price by Token Addresses Source: https://docs.coingecko.com/reference/simple-token-price reference/api-reference/coingecko-pro.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\`\](/reference/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\](https://www.coingecko.com) and learn more about our price methodology \[here\](https://www.coingecko.com/en/methodology). \* Cache/Update Frequency: every 20 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Token Data by Token Address Source: https://docs.coingecko.com/reference/token-data-contract-address reference/api-reference/onchain-pro.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\`\](/reference/token-info-contract-address) instead. ### Note \* Address not found in GeckoTerminal.com will be ignored. \* The endpoint will only return the first top most liquid pool for each token. The top pool 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). \* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # 💼 Historical Token Holders Chart by Token Address Source: https://docs.coingecko.com/reference/token-holders-chart-token-address reference/api-reference/onchain-pro.json get /networks/{network}/tokens/{token\_address}/holders\_chart This endpoint allows you to \*\*get the historical token holders chart based on the provided token contract address on a network\*\* ### Note \* The historical token holders chart 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. \* \`days\` param provides the following automatic granularity: \* \`days=7\` = \*\*all data\*\* (without fixed intervals) \* \`days=30\` = \*\*daily data\*\* (30 daily intervals) \* \`days=max\` = \*\*weekly data\*\* \* 💼 Exclusive for Paid Plan subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. # Token Info by Token Address Source: https://docs.coingecko.com/reference/token-info-contract-address reference/api-reference/onchain-pro.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}\`\](/reference/token-data-contract-address) instead. \* Cache/Update frequency: every 60 seconds. \* Learn more about GT score \[here\](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). \* 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: \* \[Coin Data by ID\](/reference/coins-id) \* \[Coin Data by Token Address\](/reference/coins-contract-address) ### 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\` is calculated based on the token's total supply and includes all wallet types (CEX wallets, treasury/issuer wallets, etc.). Coverage includes: \* 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/reference/token-lists reference/api-reference/coingecko-pro.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\](https://tokenlists.org/)\*\* ### 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\](https://support.coingecko.com/hc/en-us/requests/new). # 💼 Token OHLCV chart by Token Address Source: https://docs.coingecko.com/reference/token-ohlcv-token-address reference/api-reference/onchain-pro.json get /networks/{network}/tokens/{token\_address}/ohlcv/{timeframe} This endpoint allows you to \*\*get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network\*\* ### Note \* This endpoint will return OHLCV data of the \*\*most liquid pool\*\* of the specified token. You may use this endpoint \[Top Pools by Token Address\](https://docs.coingecko.com/update/reference/top-pools-contract-address#/) to check the top pools of a token. \* This endpoint uses epoch/unix format for its timestamp. Example: \`1708850449\`. \* \[Paid plan\](https://www.coingecko.com/en/api/pricing) 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. \* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # 💼 Past 24 Hour Trades by Token Address Source: https://docs.coingecko.com/reference/token-trades-contract-address reference/api-reference/onchain-pro.json get /networks/{network}/tokens/{token\_address}/trades This endpoint allows you to \*\*query the last 300 trades in the past 24 hours, across all pools, based on the provided token contract address on a network\*\* ### Note \* Exclusive for all \[Paid Plan\](https://www.coingecko.com/en/api/pricing) Subscribers (Analyst, Lite, Pro and Enterprise). \* Cache/Update Frequency: Real-time (Cacheless) for Pro API (Analyst, Lite, Pro, Enterprise). # Tokens Data by Token Addresses Source: https://docs.coingecko.com/reference/tokens-data-contract-addresses reference/api-reference/onchain-pro.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\`\](/reference/token-info-contract-address) instead. ### Note \* Addresses not found in GeckoTerminal.com will be ignored. \* This endpoint allows querying \*\*up to 50 contract addresses\*\* per request. This limit is exclusive for \[paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). \* The endpoint will only return the first top most liquid pool for each token. The top pool 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). \* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Most Recently Updated Tokens List Source: https://docs.coingecko.com/reference/tokens-info-recent-updated reference/api-reference/onchain-pro.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 30 seconds. # Top Pools by Token Address Source: https://docs.coingecko.com/reference/top-pools-contract-address reference/api-reference/onchain-pro.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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. # Top Pools by Dex Source: https://docs.coingecko.com/reference/top-pools-dex reference/api-reference/onchain-pro.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\](/reference/pools-megafilter) endpoint. ### 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/base/uniswap-v3-base/pools?sort=-24h\\\_transactions\](https://www.geckoterminal.com/base/uniswap-v3-base/pools?sort=-24h\_transactions) # Top Pools by Network Source: https://docs.coingecko.com/reference/top-pools-network reference/api-reference/onchain-pro.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\](/reference/pools-megafilter) endpoint. ### 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/solana/pools?sort=-24h\\\_transactions\](https://www.geckoterminal.com/solana/pools?sort=-24h\_transactions) # 💼 Top Token Holders by Token Address Source: https://docs.coingecko.com/reference/top-token-holders-token-address reference/api-reference/onchain-pro.json get /networks/{network}/tokens/{address}/top\_holders This endpoint allows you to \*\*query top token holders based on the provided token contract address on a network\*\* ### Note \* The top 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. \* Max \`holders\` value: \* Maximum 50 for non-Solana networks, 40 for Solana network. \* 💼 Exclusive for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. # 💼 Top Token Traders by Token Address Source: https://docs.coingecko.com/reference/top-token-traders-token-address reference/api-reference/onchain-pro.json get /networks/{network\_id}/tokens/{token\_address}/top\_traders This endpoint allows you to \*\*query top token traders based on the provided token contract address on a network\*\* ### Note \* The top traders data is currently in \*\*Beta\*\*, with ongoing improvements to data quality, coverage, and update frequency. \* Only tokens created after 1st September 2022 are supported for top traders data. \* Stablecoins and wrapped native tokens (e.g. wSOL, wETH) are not supported for this endpoint. \* You may specify the number of top traders to retrieve using the \`traders\` query parameter with a maximum value of 50. \* 💼 Exclusive for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. # Trending Pools List Source: https://docs.coingecko.com/reference/trending-pools-list reference/api-reference/onchain-pro.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\](/reference/pools-megafilter) endpoint. ### Note \* Trending rankings are determined by a combination of factors: \* User engagement on geckoterminal.com \* Market activity, such as trading volume and transactions \* Pool security and credibility, including liquidity and honeypot checks \* 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com\](https://www.geckoterminal.com) # Trending Pools by Network Source: https://docs.coingecko.com/reference/trending-pools-network reference/api-reference/onchain-pro.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\](/reference/pools-megafilter) endpoint. ### Note \* Trending rankings are determined by a combination of factors: \* User engagement on geckoterminal.com \* Market activity, such as trading volume and transactions \* Pool security and credibility, including liquidity and honeypot checks \* 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 30 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/base/pools\](https://www.geckoterminal.com/base/pools) # Trending Search List Source: https://docs.coingecko.com/reference/trending-search reference/api-reference/coingecko-pro.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 6 trending categories (sorted by the most popular user searches). \* \[Paid plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above) can use \`show\_max\` param to retrieve maximum 30 coins, 10 NFTs, and 10 categories. \* Cache / Update Frequency: every 10 minutes for all the API plans. # 💼 Trending Search Pools Source: https://docs.coingecko.com/reference/trending-search-pools reference/api-reference/onchain-pro.json get /pools/trending\_search This endpoint allows you to \*\*query all the trending search pools across all networks on GeckoTerminal\*\* ### 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. \* Cache/Update frequency: every 60 seconds. \* 💼 Exclusive for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). # Asset Platforms List (ID Map) Source: https://docs.coingecko.com/v3.0.1/reference/asset-platforms-list v3.0.1/reference/api-reference/coingecko-demo.json get /asset\_platforms This endpoint allows you to \*\*query all the asset platforms on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of asset platforms for other endpoints that contain params like \`id\` or\`ids\`(asset platforms). \* You may include NFT at the \`filter\` params to get the list of NFT-support asset platforms on CoinGecko. # Authentication (Public/Demo) Source: https://docs.coingecko.com/v3.0.1/reference/authentication Authentication method for CoinGecko Public API (Demo plan users) ### \*\*Notes\*\* \* Demo API Key is only available for CoinGecko Public Demo API Plan, the root URL for CoinGecko Public Demo API must be \`https://api.coingecko.com/api/v3/\`. \* ⚠️ You are recommended to store the API key securely in your own backend and use a proxy to insert the key into the request URL. \* The authentication method below is for CoinGecko Public Demo API only. For \*\*paid plan users with Pro-API key\*\*, please refer to \[this page\](/reference/authentication) instead. \* User Guide: \[How to sign up for CoinGecko Demo API and generate an API key?\](https://support.coingecko.com/hc/en-us/articles/21880397454233) \* It's highly recommended to use the \*\*Headers method\*\* when making API requests for better security. Using query string parameters can risk exposing your API key. ## CoinGecko API Authentication Method If this is your first time using the Demo API key, you can supply API Key to the root URL using one of these ways: 1. Header (Recommended): \`x-cg-demo-api-key\` 2. Query String Parameter: \`x\_cg\_demo\_api\_key\` | Authentication Method | Example using \[Ping\](/v3.0.1/reference/ping-server) Endpoint | | ---------------------- | ------------------------------------------------------------------------------------------ | | Header (cURL) | \`curl -X GET "https://api.coingecko.com/api/v3/ping" -H "x-cg-demo-api-key: YOUR\_API\_KEY"\` | | Query String Parameter | \`https://api.coingecko.com/api/v3/ping?x\_cg\_demo\_api\_key=YOUR\_API\_KEY\` | ## API Key Usage Credits \* Each request made to any endpoint counts as a single call (1 call = 1 credit). \* Your monthly credit & rate limit are determined by the paid plan to which you subscribe. For more details, please refer to this \[page\](https://www.coingecko.com/en/api/pricing). \* To check the API usage, please go to the \[developer dashboard\](https://www.coingecko.com/en/developers/dashboard) or follow the guide \[here\](/v3.0.1/reference/setting-up-your-api-key#4-api-usage-report). # Coins Categories List with Market Data Source: https://docs.coingecko.com/v3.0.1/reference/coins-categories v3.0.1/reference/api-reference/coingecko-demo.json get /coins/categories This endpoint allows you to \*\*query all the coins categories with market data (market cap, volume, ...) on CoinGecko\*\* ### Note \* CoinGecko Equivalent Page: \[https://www.coingecko.com/en/categories\](https://www.coingecko.com/en/categories) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Coins Categories List (ID Map) Source: https://docs.coingecko.com/v3.0.1/reference/coins-categories-list v3.0.1/reference/api-reference/coingecko-demo.json get /coins/categories/list This endpoint allows you to \*\*query all the coins categories on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of categories for other endpoints that contain params like \`category\`. ### Note \* CoinGecko Equivalent Page: \[https://www.coingecko.com/en/categories\](https://www.coingecko.com/en/categories) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Coin Data by Token Address Source: https://docs.coingecko.com/v3.0.1/reference/coins-contract-address v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/contract/{contract\_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\*\* ### Notice \* Please note that the \`twitter\_followers\` data field will no longer be supported by our API starting on May 15, 2025. Please refer to \[changelog\](/changelog#upcoming-change-notice%3A-removal-of-twitter-followers-data) for more details. ### 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\`\](/v3.0.1/reference/coins-list) endpoint (\`include platform = true\`). ### Note \* Coin descriptions may include newline characters represented as \`\\r\\n\` (escape sequences), which may require processing for proper formatting. \* Cache / Update Frequency: every 60 seconds for all the API plans. # Coin Data by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may also flag to include more data such as tickers, market data, community data, developer data and sparkline. \* You may refer to \`last\_updated\` in the endpoint response to check whether the price is stale. ### Note \* Tickers are limited to 100 items, to get more tickers, please go to \[/coins/{id}/tickers\](/v3.0.1/reference/coins-id-tickers). \* Coin descriptions may include newline characters represented as \`\\r\\n\` (escape sequences), which may require processing for proper formatting. \* 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. \* Community data for Telegram will be updated on weekly basis (Reddit & Twitter community data are no longer supported). # Coin Historical Data by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id-history v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/history 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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* The data returned is at \`00:00:00 UTC\`. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Coin Historical Chart Data by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id-market-chart v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/market\_chart 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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may use tools like \[epoch converter \](https://www.epochconverter.com) to convert human readable date to UNIX timestamp. ### Note \* You may leave the interval as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 2 - 90 days from current time = \*\*hourly\*\* data \* above 90 days from current time = \*\*daily\*\* data (00:00 UTC) \* Cache / Update Frequency: \* Every 30 seconds for all the API plans (for last data point). \* The last completed UTC day (00:00) data is now available \*\*10 minutes after midnight\*\* on the next UTC day (00:10). \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Coin Historical Chart Data within Time Range by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id-market-chart-range v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/market\_chart/range 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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 1 day from any time (except current time) = \*\*hourly\*\* data \* 2 - 90 days from any time = \*\*hourly\*\* data \* above 90 days from any time = \*\*daily\*\* data (00:00 UTC) \* Cache / Update Frequency:\\ Based on days range (all the API plans) \* 1 day = 30 seconds cache \* 2 -90 days = 30 minutes cache \* 90 days = 12 hours cache \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC. \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Coin OHLC Chart by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id-ohlc v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/ohlc This endpoint allows you to \*\*get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* For historical chart data with better granularity, you may consider using \[/coins/\\{id}/market\\\_chart\](/v3.0.1/reference/coins-id-market-chart) endpoint. ### Note \* The timestamp displayed in the payload (response) indicates the end (or close) time of the OHLC data. \* Data granularity (candle's body) is automatic: \* 1 - 2 days: 30 minutes \* 3 - 30 days: 4 hours \* 31 days and beyond: 4 days \* Cache / Update Frequency: \* Every 15 minutes for all the API plans. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Coin Tickers by ID Source: https://docs.coingecko.com/v3.0.1/reference/coins-id-tickers v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/tickers This endpoint allows you to \*\*query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* You may specify the \`exchange\_ids\` if you want to retrieve tickers for specific exchange only. \* You may include values such as \`page\` to specify which page of responses you would like to show. \* You may also flag to include more data such as exchange logo and depth. ### Note \* The tickers are paginated to 100 items. \* 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. \* When order is sorted by \`volume\`, \*\*\*converted\\\_volume\*\*\* will be used instead of \*\*\*volume\*\*\*. \* Cache / Update Frequency: every 2 minutes for all the API plans. # Coins List (ID Map) Source: https://docs.coingecko.com/v3.0.1/reference/coins-list v3.0.1/reference/api-reference/coingecko-demo.json get /coins/list This endpoint allows you to \*\*query all the supported coins on CoinGecko with coins ID, name and symbol\*\* ### Tips \* You may use this endpoint to query the list of coins with coin ID for other endpoints that contain params like \`id\` or \`ids\` (coin ID). ### Note \* There is no pagination required for this endpoint. \* Access to inactive coins via the Public API (Demo plan) is restricted. To access them, please subscribe to one of our paid plans to obtain a Pro-API key. \* Cache/Update Frequency: \* Every 30 minutes for Public API. \* Every 5 minutes for Pro API (Analyst, Lite, Pro, Enterprise). # Coins List with Market Data Source: https://docs.coingecko.com/v3.0.1/reference/coins-markets v3.0.1/reference/api-reference/coingecko-demo.json get /coins/markets This endpoint allows you to \*\*query all the supported coins with price, market cap, volume and market related data\*\* ### Tips \* You can retrieve specific coins using their unique \`ids\`, \`names\`, or \`symbols\` instead of returning the whole list. \* To filter results based on the coin's category, use the \`category\` param (refer to \[\`/coins/categories/list\`\](/v3.0.1/reference/coins-categories-list) for available categories). \* Use the \`per\_page\` and \`page\` params to manage the number of results you receive and navigate through the data. ### Note \* When multiple lookup params are provided, the following priority order is applied: \`category\` (highest) > \`ids\` > \`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 45 seconds for Pro API (Analyst, Lite, Pro, Enterprise). # Crypto Treasury Holdings by Coin ID Source: https://docs.coingecko.com/v3.0.1/reference/companies-public-treasury v3.0.1/reference/api-reference/coingecko-demo.json get /{entity}/public\_treasury/{coin\_id} This endpoint allows you \*\*query public companies & governments' cryptocurrency holdings\*\* by Coin ID ### Note \* The responses are sorted in descending order based on total holdings. \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/bitcoin\](https://www.coingecko.com/en/treasuries/bitcoin) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Coin Historical Chart Data by Token Address Source: https://docs.coingecko.com/v3.0.1/reference/contract-address-market-chart v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/contract/{contract\_address}/market\_chart 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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint (\`include platform = true\`). ### Note \* You may leave the interval as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 2 - 90 days from current time = \*\*hourly\*\* data \* above 90 days from current time = \*\*daily\*\* data (00:00 UTC) \* Cache / Update Frequency: \* Every 5 minutes for all the API plans. \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC. \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Coin Historical Chart Data within Time Range by Token Address Source: https://docs.coingecko.com/v3.0.1/reference/contract-address-market-chart-range v3.0.1/reference/api-reference/coingecko-demo.json get /coins/{id}/contract/{contract\_address}/market\_chart/range 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\*\* ### 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\`\](/v3.0.1/reference/coins-list) endpoint (\`include platform = true\`). ### Note \* You may leave the interval params as empty for automatic granularity: \* 1 day from current time = \*\*5-minutely\*\* data \* 1 day from any time (except current time) = \*\*hourly\*\* data \* 2 - 90 days from any time = \*\*hourly\*\* data \* above 90 days from any time = \*\*daily\*\* data (00:00 UTC) \* Cache / Update Frequency:\\ Based on days range (all the API plans) \* 1 day = 30 seconds cache \* 2 -90 days = 30 minutes cache \* 90 days = 12 hours cache \* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC. \* Access to historical data via the Public API (Demo plan) is \*\*restricted to the past 365 days\*\* only. To access the complete range of historical data, please subscribe to one of our \[paid plans\](https://www.coingecko.com/en/api/pricing) to obtain a Pro-API key. # Crypto Global Market Data Source: https://docs.coingecko.com/v3.0.1/reference/crypto-global v3.0.1/reference/api-reference/coingecko-demo.json get /global This endpoint allows you \*\*query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc\*\* ### Note \* Cache / Update Frequency: every 10 minutes for all the API plans. # Derivatives Exchanges List with Data Source: https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges v3.0.1/reference/api-reference/coingecko-demo.json get /derivatives/exchanges This endpoint allows you to \*\*query all the derivatives exchanges with related data (ID, name, open interest, ...) 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 \* Cache / Update Frequency: every 60 seconds for all the API plans. # Derivatives Exchange Data by ID Source: https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges-id v3.0.1/reference/api-reference/coingecko-demo.json get /derivatives/exchanges/{id} This endpoint allows you to \*\*query the derivatives exchange's related data (ID, name, open interest, ...) based on the exchanges' ID\*\* ### Tips \* For \`include\_tickers\` param, you may change the value to either \`all\` to include all the tickers or \`unexpired\` to include unexpired tickers in the responses. You may leave it blank to omit the tickers data. ### Note \* Cache / Update Frequency: every 30 seconds for all the API plans. # Derivatives Exchanges List (ID Map) Source: https://docs.coingecko.com/v3.0.1/reference/derivatives-exchanges-list v3.0.1/reference/api-reference/coingecko-demo.json get /derivatives/exchanges/list This endpoint allows you to \*\*query all the derivatives exchanges with ID and name on CoinGecko\*\* ### Tips \* You may use this endpoint to query the list of exchanges for other endpoints that contain params like \`id\` (derivatives exchange's ID) ### Note \* Cache / Update Frequency: every 5 minutes for all the API plans. # Derivatives Tickers List Source: https://docs.coingecko.com/v3.0.1/reference/derivatives-tickers v3.0.1/reference/api-reference/coingecko-demo.json get /derivatives This endpoint allows you to \*\*query all the tickers from derivatives exchanges on CoinGecko\*\* ### Note \* Data for \`open\_interest\` and \`volume\_24h\` in the endpoint responses are in USD. \* Cache / Update Frequency: every 30 seconds for all the API plans. # Supported Dexes List by Network (ID Map) Source: https://docs.coingecko.com/v3.0.1/reference/dexes-list v3.0.1/reference/api-reference/onchain-demo.json get /networks/{network}/dexes This endpoint allows you to \*\*query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal\*\* ### Tips \* You may use this endpoint to query the list of DEXs with DEX ID for other endpoints that contain params like \`dex\`. \* You may include values such as \`page\` to specify which page of responses you would like to show. # Endpoint Overview Source: https://docs.coingecko.com/v3.0.1/reference/endpoint-overview ### Notes Any exclusive endpoints for Pro-API users (any paid plan subscribers) will not be included here. For a full list of endpoints, please visit \[Pro API Documentation\](/v3.0.1/reference/endpoint-overview) instead. ## CoinGecko Endpoints: Coins | Endpoint | Description | | -------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | \[/ping\](/v3.0.1/reference/ping-server) | Check the API server status | | \[/simple/price\](/v3.0.1/reference/simple-price) | Query the prices of one or more coins by using their unique Coin API IDs | | \[/simple/token\\\_price/\\{id}\](/v3.0.1/reference/simple-token-price) | Query the prices of one or more coins by using their unique Coin API IDs | | \[/simple/supported\\\_vs\\\_currencies\](/v3.0.1/reference/simple-supported-currencies) | Query all the supported currencies on CoinGecko | | \[/coins/list\](/v3.0.1/reference/coins-list) | Query all the supported coins on CoinGecko with coins ID, name and symbol | | \[/coins/markets\](/v3.0.1/reference/coins-markets) | Query all the supported coins with price, market cap, volume and market related data | | \[/coins/\\{id}\](/v3.0.1/reference/coins-id) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on a particular coin ID | | \[/coins/\\{id}/tickers\](/v3.0.1/reference/coins-id-tickers) | Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID | | \[/coins/\\{id}/history\](/v3.0.1/reference/coins-id-history) | Query the historical data (price, market cap, 24hr volume, ...) at a given date for a coin based on a particular coin ID | | \[/coins/\\{id}/market\\\_chart\](/v3.0.1/reference/coins-id-market-chart) | Get the historical chart data of a coin including time in UNIX, price, market cap and 24hr volume based on particular coin ID | | \[/coins/\\{id}/market\\\_chart/range\](/v3.0.1/reference/coins-id-market-chart-range) | 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 | | \[/coins-id-ohlc\](/v3.0.1/reference/coins-id-ohlc) | Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID | | \[/coins/../contract/..\](/v3.0.1/reference/coins-contract-address) | Query all the metadata (image, websites, socials, description, contract address, etc.) from the CoinGecko coin page based on an asset platform and a particular token contract address | | \[/coins/../contract/../market\\\_chart\](/v3.0.1/reference/contract-address-market-chart) | Get the historical chart data including time in UNIX, price, market cap and 24hr volume based on asset platform and particular token contract address | | \[/coins/../contract/../market\\\_chart/range\](/v3.0.1/reference/contract-address-market-chart-range) | 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 | | \[/coins/categories/list\](/v3.0.1/reference/coins-categories-list) | Query all the coins categories on CoinGecko | | \[/coins/categories\](/v3.0.1/reference/coins-categories) | Query all the coins categories with market data (market cap, volume, ...) on CoinGecko | ## CoinGecko Endpoints: NFT | Endpoint | Description | | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | \[/nfts/list\](/v3.0.1/reference/nfts-list) | Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko | | \[/nfts/..\](/v3.0.1/reference/nfts-id) | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID | | \[/nfts/../contract/..\](/v3.0.1/reference/nfts-contract-address) | Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection contract address and respective asset platform | ## CoinGecko Endpoints: Exchanges & Derivatives | Endpoint | Description | | ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | \[/exchanges\](/v3.0.1/reference/exchanges) | Query all the supported exchanges with exchanges' data (ID, name, country, ...) that have active trading volumes on CoinGecko | | \[/exchanges/list\](/v3.0.1/reference/exchanges-list) | Query all the exchanges with ID and name | | \[/exchanges/\\{id}\](/v3.0.1/reference/exchanges-id) | Query exchange's data (name, year established, country, ...), exchange volume in BTC and tickers based on exchange's ID | | \[/exchanges/\\{id}/tickers\](/v3.0.1/reference/exchanges-id-tickers) | Query exchange's tickers based on exchange's ID | | \[/exchanges/\\{id}/volume\\\_chart\](/v3.0.1/reference/exchanges-id-volume-chart) | Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID | | \[/derivatives\](/v3.0.1/reference/derivatives-tickers) | Query all the tickers from derivatives exchanges on CoinGecko | | \[/derivatives/exchanges\](/v3.0.1/reference/derivatives-exchanges) | Query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko | | \[/derivatives/exchanges/\\{id}\](/v3.0.1/reference/derivatives-exchanges-id) | Query the derivatives exchange's related data (ID, name, open interest, ...) based on the exchanges' ID | | \[/derivatives/exchanges/list\](/v3.0.1/reference/derivatives-exchanges-list) | Query all the derivatives exchanges with ID and name on CoinGecko | ## CoinGecko Endpoints: Public Treasuries | Endpoint | Description | | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | | \[/entities/list\](/v3.0.1/reference/entities-list) | Query all the supported entities on CoinGecko with entities ID, name, symbol, and country | | \[/\\{entity}/public\\\_treasury/\\{coin\\\_id}\](/v3.0.1/reference/companies-public-treasury) | Query public companies & governments' cryptocurrency holdings by coin ID | | \[/public\\\_treasury/\\{entity\\\_id}\](/v3.0.1/reference/public-treasury-entity) | Query public companies & governments' cryptocurrency holdings by entity ID | | \[/public\\\_treasury/\\{entity\\\_id}/.../holding\\\_chart\](/v3.0.1/reference/public-treasury-entity-chart) | Query public companies & governments' cryptocurrency historical holdings by entity ID and coin ID | | \[/public\\\_treasury/\\{entity\\\_id}/transaction\\\_history\](/v3.0.1/reference/public-treasury-transaction-history) | Query public companies & governments' cryptocurrency transaction history by entity ID | ## CoinGecko Endpoints: General | Endpoint | Description | | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------ | | \[/asset\\\_platforms\](/v3.0.1/reference/asset-platforms-list) | Query all the asset platforms (blockchain networks) on CoinGecko | | \[/token\\\_lists/\\{asset\\\_platform\\\_id}/all.json\](/v3.0.1/reference/token-lists) | Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard | | \[/exchange\\\_rates\](/v3.0.1/reference/exchange-rates) | Query BTC exchange rates with other currencies | | \[/search\](/v3.0.1/reference/search-data) | Search for coins, categories and markets listed on CoinGecko | | \[/search/trending\](/v3.0.1/reference/trending-search) | Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours | | \[/global\](/v3.0.1/reference/crypto-global) | Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc. | | \[/global/decentralized\\\_finance\\\_defi\](/v3.0.1/reference/global-defi) | Query cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume | ## Onchain DEX Endpoints (GeckoTerminal) | Endpoint | Description | | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | \[/onchain/simple/networks/../token\\\_price/..\](/v3.0.1/reference/onchain-simple-price) | Get token price based on the provided token contract address on a network | | \[/onchain/networks\](/v3.0.1/reference/networks-list) | Query all the supported networks on GeckoTerminal | | \[/onchain/networks/../dexes\](/v3.0.1/reference/dexes-list) | Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal | | \[/onchain/networks/../pools/..\](/v3.0.1/reference/pool-address) | Query the specific pool based on the provided network and pool address | | \[/onchain/networks/../pools/multi/..\](/v3.0.1/reference/pools-addresses) | Query multiple pools based on the provided network and pool address | | \[/onchain/networks/trending\\\_pools\](/v3.0.1/reference/trending-pools-list) | Query all the trending pools across all networks on GeckoTerminal | | \[/onchain/networks/../trending\\\_pools\](/v3.0.1/reference/trending-pools-network) | Query the trending pools based on the provided network | | \[/onchain/networks/../pools\](/v3.0.1/reference/top-pools-network) | Query all the top pools based on the provided network | | \[/onchain/networks/../dexes/../pools\](/v3.0.1/reference/top-pools-dex) | Query all the top pools based on the provided network and decentralized exchange (DEX) | | \[/onchain/networks/new\\\_pools\](/v3.0.1/reference/latest-pools-list) | Query all the latest pools across all networks on GeckoTerminal | | \[/onchain/networks/../new\\\_pools\](/v3.0.1/reference/latest-pools-network) | Query all the latest pools based on provided network | | \[/onchain/search/pools\](/v3.0.1/reference/search-pools) | Search for pools on a network | | \[/onchain/networks/../tokens/../pools\](/v3.0.1/reference/top-pools-contract-address) | Query top pools based on the provided token contract address on a network | | \[/onchain/networks/../tokens/..\](/v3.0.1/reference/token-data-contract-address) | Query specific token data based on the provided token contract address on a network | | \[/onchain/networks/../tokens/multi/..\](/v3.0.1/reference/tokens-data-contract-addresses) | Query multiple tokens data based on the provided token contract addresses on a network | | \[/onchain/networks/../tokens/../info\](/v3.0.1/reference/token-info-contract-address) | Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network | | \[/onchain/networks/../pools/../info\](/v3.0.1/reference/pool-token-info-contract-address) | 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 | | \[/onchain/tokens/info\\\_recently\\\_updated\](/v3.0.1/reference/tokens-info-recent-updated) | Query 100 most recently updated tokens info across all networks on GeckoTerminal | | \[/onchain/networks/../pools/../ohlcv/..\](/v3.0.1/reference/pool-ohlcv-contract-address) | Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network | | \[/onchain/networks/../pools/../trades\](/v3.0.1/reference/pool-trades-contract-address) | Query the last 300 trades in the past 24 hours based on the provided pool address | ⚡️ Need Real-time Data Streams? Try \[WebSocket API\](https://docs.coingecko.com/websocket) With WebSocket, you can now stream ultra-low latency, real-time prices, trades, and OHLCV chart data.
Subscribe to our \[paid API plan\](https://www.coingecko.com/en/api/pricing) (Analyst plan & above) to access WebSocket and REST API data delivery methods. # 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\](/changelog#may-2025) for more details. ### Note \* The exchange volume in the response is provided in BTC. To convert it to other currencies, please use \[/exchange\\\_rates\](/v3.0.1/reference/exchange-rates) endpoint. \* For derivatives (e.g. bitmex, binance\\\_futures), to get derivatives exchanges data, please go to \[/derivatives/exchange/\\{id}\](/v3.0.1/reference/derivatives-exchanges-id) endpoint. \* Tickers are limited to 100 items, to get more tickers, please go to \[/exchanges/\\{id}/tickers\](/v3.0.1/reference/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\](/v3.0.1/reference/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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/explore/new-crypto-pools\](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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/explore/new-crypto-pools/solana\](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\](/v3.0.1/reference/nfts-list) endpoint. ### Note \* Solana NFT & Art Blocks are not supported for this endpoint, please use \[/nfts/\\{id}\](/v3.0.1/reference/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\](https://www.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}\`\](/v3.0.1/reference/pool-address) endpoint by providing a specific pool address. \* If \`include\_inactive\_source=true\` is set and no top pool is found for a token, the search will expand to include recently active pools up to the past 1 year. \* 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\](https://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\](https://www.coingecko.com/en/api/pricing) 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. \* 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}\`\](/v3.0.1/reference/pool-address) instead. \* Cache/Update frequency: every 60 seconds. \* Learn more about GT score \[here\](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). \* 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: \* \[Coin Data by ID\](/v3.0.1/reference/coins-id) \* \[Coin Data by Token Address\](/v3.0.1/reference/coins-contract-address) ### 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 \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/bitcoin\](https://www.coingecko.com/en/treasuries/bitcoin) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Crypto Treasury Holdings Historical Chart Data by ID Source: https://docs.coingecko.com/v3.0.1/reference/public-treasury-entity-chart v3.0.1/reference/api-reference/coingecko-demo.json get /public\_treasury/{entity\_id}/{coin\_id}/holding\_chart This endpoint allows you to \*\*query historical cryptocurrency holdings chart of public companies & governments\*\* by Entity ID and Coin ID ### Tips \* You may obtain the entity ID and coin ID (API IDs) via several ways: \* For \`entity\_id\`: \* refers to respective public treasury entity page and find 'API ID'. \* refers to \[\`/entities/list\`\](/v3.0.1/reference/entities-list) endpoint. \* For \`coin\_id\`: \* refers to respective coin page and find 'API ID'. \* refers to \[\`/coins/list\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* Data available from August 2020 onwards. \* Different API plans can access up to different historical periods via \`days\` param: | Plan | Maximum period | \`days\` value availability | | ----------------- | -------------- | ----------------------------------- | | Public/Demo | 1 year | \`7, 14, 30, 90, 180, 365\` | | Basic | 2 years | \`7, 14, 30, 90, 180, 365, 730\` | | Analyst and above | Full | \`7, 14, 30, 90, 180, 365, 730, max\` | \* To access longer historical periods, check out \[our API plans here\](https://www.coingecko.com/en/api/pricing) \* For \`include\_empty\_intervals\` param: \* When \`false\` (default): Only intervals with transaction data are returned. \* When \`true\`: All requested intervals are returned, populated with the most recent available transaction data. \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/companies/strategy\](https://www.coingecko.com/en/treasuries/companies/strategy) \* Cache / Update Frequency: every 5 minutes for all the API plans. # Crypto Treasury Transaction History by Entity ID Source: https://docs.coingecko.com/v3.0.1/reference/public-treasury-transaction-history v3.0.1/reference/api-reference/coingecko-demo.json get /public\_treasury/{entity\_id}/transaction\_history This endpoint allows you \*\*query public companies & governments' cryptocurrency transaction history\*\* by Entity ID ### Tips \* You may obtain the entity ID via several ways: \* refers to respective public treasury entity page and find 'API ID'. \* refers to \[\`/entities/list\`\](/reference/entities-list) endpoint. \* \`coin\_ids\` param allows you to filter transaction history by specific coin IDs, comma-separated if more than 1 coin. You may obtain the coin IDs via several ways: \* refers to respective coin page and find 'API ID'. \* refers to \[\`/coins/list\`\](/reference/coins-list) endpoint. \* refers to google sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). ### Note \* Data available from August 2020 onwards. \* Only Analyst plan and above can request with \`page\` value greater than \`1\`. \* To unlock multi-page access, check out \[our API plans here\](https://www.coingecko.com/en/api/pricing) \* CoinGecko equivalent page: \[https://www.coingecko.com/en/treasuries/companies/strategy\](https://www.coingecko.com/en/treasuries/companies/strategy) \* Cache / Update Frequency: every 5 minutes for all the API plans. # 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\](https://www.coingecko.com/en/api/pricing) 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\`\](/v3.0.1/reference/coins-list) endpoint. \* refers to Google Sheets \[here\](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1\_5bGVmP9Xz0XGSyU/edit?usp=sharing). \* 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\](https://www.coingecko.com) and learn more about our price methodology \[here\](https://www.coingecko.com/en/methodology). \* 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\](https://www.coingecko.com/en/api/pricing) (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\`\](/v3.0.1/reference/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\](https://www.coingecko.com) and learn more about our price methodology \[here\](https://www.coingecko.com/en/methodology). \* Cache/Update Frequency: every 60 seconds for Public API. \* Every 20 seconds for \[Pro-API\](https://www.coingecko.com/en/api/pricing) (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\`\](/v3.0.1/reference/token-info-contract-address) 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}\`\](/v3.0.1/reference/token-data-contract-address) instead. \* Cache/Update frequency: every 60 seconds. \* Learn more about GT score \[here\](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). \* 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: \* \[Coin Data by ID\](/v3.0.1/reference/coins-id) \* \[Coin Data by Token Address\](/v3.0.1/reference/coins-contract-address) ### 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\` is calculated based on the token's total supply and includes all wallet types (CEX wallets, treasury/issuer wallets, etc.). Coverage includes: \* 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\](https://tokenlists.org/)\*\* ### 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\](https://support.coingecko.com/hc/en-us/requests/new). # 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\`\](/v3.0.1/reference/token-info-contract-address) 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\](https://www.coingecko.com/en/api/pricing) 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\](https://docs.coingecko.com/reference/pools-megafilter) endpoint (available for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) 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\](https://www.coingecko.com/en/api/pricing) 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\](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\](https://docs.coingecko.com/reference/pools-megafilter) endpoint (available for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/solana/pools?sort=-24h\\\_transactions\](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\](https://docs.coingecko.com/reference/pools-megafilter) endpoint (available for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com\](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\](https://docs.coingecko.com/reference/pools-megafilter) endpoint (available for \[Paid Plan\](https://www.coingecko.com/en/api/pricing) 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\](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above). \* Cache/Update frequency: every 60 seconds. \* GeckoTerminal equivalent page (example): \[https://www.geckoterminal.com/base/pools\](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 | | Field | Type | Description | Example | | ---- | --------------------------------- | ------- | ---------------------------------------------------------------------------------------------------- | ---------------------- | | \`c\` | \`channel\_type\` | string | Indicates the type of channel subscribed to. | C1 | | \`i\` | \`coin\_id\` | string | Identifier of the coins. Check full list of IDs \[here\](https://api.coingecko.com/api/v3/coins/list). | \`ethereum\`, \`usd-coin\` | | \`p\` | \`usd\_price\` | string | Current token price in USD. | 3639.78228844745 | | \`pp\` | \`usd\_price\_24h\_change\_percentage\` | float | Percentage change in token price over the last 24 hours. | 3.566 | | \`m\` | \`usd\_market\_cap\` | float | Market capitalization in USD. | 123 | | \`v\` | \`usd\_24h\_vol\` | float | 24-hour trading volume in USD. | 31233333.33 | | \`t\` | \`last\_updated\_at\` | integer | Timestamp 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. \*\*\* ## 1. Establish Connection to Websocket \`\`\`bash Bash theme={null} wss://stream.coingecko.com/v1?x\_cg\_pro\_api\_key=YOUR\_KEY OR wss://stream.coingecko.com/v1 x-cg-pro-api-key: YOUR\_KEY \`\`\` ## 2. Subscribe to a specific channel - CGSimplePrice \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"subscribe","identifier":"{\\"channel\\":\\"CGSimplePrice\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} {"type":"confirm\_subscription","identifier":"{\\"channel\\":\\"CGSimplePrice\\"}"} \`\`\` ## 3. Stream CGSimplePrice \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"CGSimplePrice\\"}","data":"{\\"coin\_id\\":\[\\"ethereum\\",\\"bitcoin\\"\],\\"action\\":\\"set\_tokens\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Subscription is successful for ethereum" } \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "c": "C1", "i": "ethereum", "m": 312938652962.8005, "p": 2591.080889351465, "pp": 1.3763793110454519, "t": 1747808150.269067, "v": 20460612214.801384 } \`\`\` The output keys will be in random order. ## Tips: ### Un-subscribe to stop streaming CGSimplePrice data \*\*Input Example:\*\* Unsubscribe for 1 specific token data: \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"CGSimplePrice\\"}","data":"{\\"coin\_id\\":\[\\"ethereum\\"\],\\"action\\":\\"unset\_tokens\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Unsubscription is successful for ethereum" } \`\`\` \*\*Input Example:\*\* Unsubscribe from CGSimplePrice channel and all token data: \`\`\`json JSON theme={null} {"command":"unsubscribe","identifier":"{\\"channel\\":\\"CGSimplePrice\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Unsubscription is successful for all tokens" } \`\`\` # WebSocket (Beta) Source: https://docs.coingecko.com/websocket/index CoinGecko API: Stream Real-Time Crypto Data with WebSockets ## Access Real-Time Crypto Data Instantly with CoinGecko WebSockets In the fast-paced world of cryptocurrency, speed matters. Our official CoinGecko WebSocket API provides a dedicated, persistent connection for real-time data streaming, ensuring you receive critical market updates the moment they happen. Move beyond traditional polling and embrace the power of instant data delivery for your trading bots, dashboards, and analytical applications. CoinGecko Websocket (Beta) is now available for \[paid plan \](https://www.coingecko.com/en/api/pricing)customers (Analyst plan & above)! \* For Analyst, Lite, Pro, and Pro+ self-serve customers, you will be eligible to access the following features, and stream real-time data by utilising your monthly API plan credits: \* Max connections: 10 concurrent socket connections \* Max subscriptions: 100 token or pool data subscription per channel, per socket \* Channel Access: all 4 channels \* Credit charge: 0.1 credit per response returned, deducting from monthly API plan credits We will gradually improve the Websocket and expand the feature limits. Please share your feedback and suggestion via this \[survey form\](https://forms.gle/gNE1Txc9FCV55s7ZA), or email soonaik\\@coingecko\\\[dot\]com \* For existing \*\*Enterprise plan\*\* clients who wish to unlock higher limits (max connections, max subscriptions, and lower credit charge), please contact your Customer Success Manager. ### Channel & Data Support | Websocket Channel | Channel Code | Details | | ------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------- | | \[OnchainSimpleTokenPrice\](/websocket/onchainsimpletokenprice) | G1 | Subscribe to receive real-time price updates for tokens, as seen on GeckoTerminal.com | | \[CGSimplePrice\](/websocket/cgsimpleprice) | C1 | Subscribe to receive real-time price updates for tokens, as seen on CoinGecko.com | | \[OnchainTrade\](/websocket/wss-onchain-trade) | G2 | Subscribe to receive real-time transaction updates for pools, as seen on GeckoTerminal.com | | \[OnchainOHLCV\](/websocket/wssonchainohlcv/) | G3 | Subscribe to receive real-time OHLCV (Open, High, Low, Close, Volume) for pools, as seen on GeckoTerminal.com | | (More coming soon!) | | | ### \*\*Notes\*\* \* \*\*Real-Time Data\*\*: Once subscribed, you will start receiving real-time data updates based on your subscriptions. The received data will be in JSON format and will contain the relevant information for the subscribed event. \* \*\*Close Connection:\*\* When you're done receiving updates or want to close the WebSocket connection, you can gracefully close the connection. \* \*\*Security Considerations:\*\* Ensure that you keep your Pro-API key secure and do not expose it publicly in your code or any public repositories. ### Connection Handling To provide you with the most reliable and efficient experience, please be aware of the following regarding our WebSocket connections: 1. \*\*Connection Liveliness (Ping/Pong Mechanism):\*\* \* To ensure your connection remains active and healthy, we send a \*\*"ping" signal every 10 seconds\*\*. \* If we \*\*do not receive a "pong" response from your client within 20 seconds\*\* of sending a ping, we will automatically disconnect the connection. \* \*\*Action Required (Client-Side)\*\*: Your WebSocket client must be configured to respond to our ping messages with a pong. Most WebSocket libraries handle this automatically, but please verify your implementation to ensure it's sending pong responses. This is critical for maintaining your connection. 2. \*\*Planned Disconnections (Deployments & Reboots):\*\* \* \*\*Purpose\*\*: From time to time, we will perform system reboots or deploy new versions of our service to implement updates, bug fixes, and improvements. These actions require a graceful restart of our servers. \* \*\*Impact\*\*: During these periods, your active WebSocket connections might be temporarily disconnected. \* \*\*Action Required (Client-Side)\*\*: It is essential that your application is designed to automatically attempt to re-establish the WebSocket connection if it detects a disconnection. Implementing an exponential backoff strategy for reconnection attempts is highly recommended to avoid overwhelming our servers during a widespread disconnection event. # OnchainSimpleTokenPrice Source: https://docs.coingecko.com/websocket/onchainsimpletokenprice Subscribe to receive real-time price updates for tokens, as seen on GeckoTerminal.com This Websocket channel allows you to subscribe to real-time updates of price changes for token. \* Lookup by Network + Token Address \* It will return price and market data of the top pool of the specified token \*\*Update Frequency\*\*: as fast as 1s, for actively traded tokens. ### Data Payload | | Field | Type | Description | Example | | ---- | --------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | | \`c\` | \`channel\_type\` | string | Indicates the type of channel subscribed to. | G1 | | \`n\` | \`network\_id\` | string | Identifier of the blockchain network. Check full list of IDs \[here\](https://api.geckoterminal.com/api/v2/networks?page=1). | \`eth\` | | \`ta\` | \`token\_address\` | string | Contract address of the token on the blockchain. | \`0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2\` | | \`p\` | \`usd\_price\` | float | Current token price in USD. | 3639.78228844745 | | \`pp\` | \`usd\_price\_24h\_change\_percentage\` | float | Percentage change in token price over the last 24 hours. | 3.566 | | \`m\` | \`usd\_market\_cap\` | float | Market capitalization in USD. | 123 | | \`v\` | \`usd\_24h\_vol\` | float | 24-hour trading volume in USD. | 31233333.33 | | \`t\` | \`last\_updated\_at\` | integer | Timestamp 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. \*\*\* ## 1. Establish Connection to Websocket \`\`\`bash Bash theme={null} wss://stream.coingecko.com/v1?x\_cg\_pro\_api\_key=YOUR\_KEY OR wss://stream.coingecko.com/v1 x-cg-pro-api-key: YOUR\_KEY \`\`\` ## 2. Subscribe to a specific channel - OnchainSimpleTokenPrice \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"subscribe","identifier":"{\\"channel\\":\\"OnchainSimpleTokenPrice\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} {"type":"confirm\_subscription","identifier":"{\\"channel\\":\\"OnchainSimpleTokenPrice\\"}"} \`\`\` ## 3. Stream OnchainSimpleTokenPrice data \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainSimpleTokenPrice\\"}","data":"{\\"network\_id:token\_addresses\\":\[\\"bsc:0x55d398326f99059ff775485246999027b3197955\\"\],\\"action\\":\\"set\_tokens\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Subscription successful for bsc:0x55d398326f99059ff775485246999027b3197955" } \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "c": "G1", "n": "bsc", "ta": "0x55d398326f99059ff775485246999027b3197955", "p": 0.999457718373347, "pp": -0.009028866490825653, "m": 1317802988326.25, "v": 1476864199.38384, "t": 1737427063 } \`\`\` The output keys will be in random order. ## Tips: ### Un-subscribe to stop streaming OnchainSimpleTokenPrice data \*\*Input Example:\*\* Unsubscribe for 1 specific token data: \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainSimpleTokenPrice\\"}","data":"{\\"network\_id:token\_addresses\\":\[\\"bsc:0x55d398326f99059ff775485246999027b3197955\\"\],\\"action\\":\\"unset\_tokens\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for bsc:0x55d398326f99059ff775485246999027b3197955" } \`\`\` \*\*Input Example:\*\* Unsubscribe from OnchainSimpleTokenPrice channel and all token data: \`\`\`json JSON theme={null} {"command":"unsubscribe","identifier":"{\\"channel\\":\\"OnchainSimpleTokenPrice\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for all tokens" } \`\`\` # OnchainTrade Source: https://docs.coingecko.com/websocket/wss-onchain-trade Subscribe to receive real-time transaction (trade/swap) updates for pools, as seen on GeckoTerminal.com This Websocket channel allows you to subscribe to real-time updates of token trades of a pool. \* Lookup by Network + Pool Address \* It will return transaction type (buy/sell), tx hash, amount of token transacted, volume, and current price data of the specified pool. \*\*Update Frequency\*\*: as fast as 0.1s, for actively traded pools. \*\*Tips\*\*: use this Rest API endpoint \[Top Pools by Token Address\](/reference/top-pools-contract-address) to obtain contract address of the most liquid pool. ### Data Payload | | Field | Type | Description | Example | | ---- | -------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------- | | \`ch\` | \`channel\_type\` | string | Indicates the type of channel subscribed to. | G2 | | \`n\` | \`network\_id\` | string | Identifier of the blockchain network. Check full list of IDs \[here\](https://api.geckoterminal.com/api/v2/networks?page=1). | eth | | \`pa\` | \`pool\_address\` | string | Contract address of the pool. | \`0x88e6a0c2dd6fcb..3f5640\` | | \`tx\` | \`tx\_hash\` | string | transaction hash | \`0x0b8ac5a16c2d5a..4d422\` | | \`ty\` | \`type\` | string | type of transaction (\`b\` for buy or \`s\` for sell) | b | | \`to\` | \`token\_amount\` | float | Amount of token transacted. | 100 | | \`vo\` | \`volume\_in\_usd\` | float | The transaction value in USD. | 1000 | | \`pc\` | \`price\_in\_native\_currency\` | float | Current token price in network's native token currency. E.g. Base network's native currency is ETH. | 3639.78228844745 | | \`pu\` | \`price\_in\_usd\` | float | Current token price in USD | 3.566 | | \`t\` | \`last\_updated\_at\` | integer | Timestamp of the last data update in UNIX time. | 1752072129000 | \*\*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. \*\*\* ## 1. Establish Connection to Websocket \`\`\`bash Bash theme={null} wss://stream.coingecko.com/v1?x\_cg\_pro\_api\_key=YOUR\_KEY OR wss://stream.coingecko.com/v1 x-cg-pro-api-key: YOUR\_KEY \`\`\` ## 2. Subscribe to a specific channel - OnchainTrade \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"subscribe","identifier":"{\\"channel\\":\\"OnchainTrade\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} {"type":"confirm\_subscription","identifier":"{\\"channel\\":\\"OnchainTrade\\"}"} \`\`\` ## 3. Stream OnchainTrade data \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainTrade\\"}","data":"{\\"network\_id:pool\_addresses\\":\[\\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\\"\],\\"action\\":\\"set\_pools\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Subscription successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849" } \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "c": "G2", "n": "bsc", "pa": "0x172fcd41e0913e95784454622d1c3724f546f849", "tx": "0x3e71ee7da66000a5a92f13abd2ae95e0abc0bc828087d8dd210338fd262cf6c9", "ty": "b", "to": "1.51717616246451", "vo": "2.75413132131313", "pc": "0.000274100995437363" "pu": "3656.8970003075", "t": 1724927796000 } \`\`\` The output keys will be in random order. ## Tips: ### Un-subscribe to stop streaming OnchainTrade data \*\*Input Example:\*\* Unsubscribe for 1 specific pool data: \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainTrade\\"}","data":"{\\"network\_id:pool\_addresses\\":\[\\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\\"\],\\"action\\":\\"unset\_pools\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849" } \`\`\` \*\*Input Example:\*\* Unsubscribe from OnchainTrade channel and all pools data: \`\`\`json JSON theme={null} {"command":"unsubscribe","identifier":"{\\"channel\\":\\"OnchainTrade\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for all pools" } \`\`\` # OnchainOHLCV Source: https://docs.coingecko.com/websocket/wssonchainohlcv Subscribe to receive real-time OHLCV updates for pools, as seen on GeckoTerminal.com This Websocket channel allows you to subscribe to real-time OHLCV updates of a pool. \* Lookup by Network + Pool Address \* It will return \*\*O\*\*pen, \*\*H\*\*igh, \*\*L\*\*ow, \*\*C\*\*lose price and \*\*V\*\*olume data the specified pool. \*\*Update Frequency\*\*: as fast as 1s, for actively traded pools. \*\*Tips\*\*: use this Rest API endpoint \[Top Pools by Token Address\](https://docs.coingecko.com/reference/top-pools-contract-address#/) to obtain contract address of the most liquid pool. ### \*\*Notes\*\* \* Interval options: 1s / 1m / 5m / 1h / 2h / 4h / 8h \* You may stream the pool ohlcv data based on \`base\` or \`quote\` token of a pool. \* Please note that your subscription quota is based on the number of \*\*unique data streams\*\* you request. Each unique combination of an interval and token for a given pool is considered a \*\*distinct subscription\*\* and will count towards your max subscription limit. ### Data Payload | | Field | Type | Description | Example | | ---- | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- | -------------------------- | | \`ch\` | \`channel\_type\` | string | Indicates the type of channel subscribed to. | G3 | | \`n\` | \`network\_id\` | string | Identifier of the blockchain network. Check full list of IDs \[here\](https://api.geckoterminal.com/api/v2/networks?page=1). | eth | | \`pa\` | \`pool\_address\` | string | Contract address of the pool. | \`0x88e6a0c2dd6fcb..3f5640\` | | \`to\` | \`token\` | string | \`base\` or \`quote\` token | \`base\` | | \`i\` | \`interval\` | string | Interval or resolution of the candle: 1s / 1m / 5m / 1h / 2h / 4h / 8h | 1m | | \`o\` | \`open\` | float | Open price in USD | 3539 | | \`h\` | \`high\` | float | High price in USD | 3541 | | \`l\` | \`low\` | float | Low price in USD | 3530 | | \`c\` | \`close\` | float | Close price in USD | 3531 | | \`v\` | \`volume\` | float | Volume in USD | 323333 | | \`t\` | \`timestamp\` | integer | Opening timestamp of candle interval | 1753803600 | \*\*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. \*\*\* ## 1. Establish Connection to Websocket \`\`\`bash Bash theme={null} wss://stream.coingecko.com/v1?x\_cg\_pro\_api\_key=YOUR\_KEY OR wss://stream.coingecko.com/v1 x-cg-pro-api-key: YOUR\_KEY \`\`\` ## 2. Subscribe to a specific channel - OnchainOHLCV \*\*Input Example:\*\* \`\`\`json JSON theme={null} {"command":"subscribe","identifier":"{\\"channel\\":\\"OnchainOHLCV\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} {"type":"confirm\_subscription","identifier":"{\\"channel\\":\\"OnchainOHLCV\\"}"} \`\`\` ## 3. Stream OnchainOHLCV data \*\*Input Example:\*\* (1 minute interval and base token of a pool) \* \`Interval\` options: 1s / 1m / 5m / 1h / 2h / 4h / 8h \* You may stream the pool ohlcv data of 'base' or 'quote' \`token\`. \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainOHLCV\\"}","data":"{\\"network\_id:pool\_addresses\\":\[\\"bsc:0x172fcd41e0913e95784454622d1c3724f546f849\\"\],\\"interval\\":\\"1m\\",\\"token\\":\\"base\\",\\"action\\":\\"set\_pools\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code": 2000, "message": "Subscription successful for bsc:0x172fcd41e0913e95784454622d1c3724f546f849:1m:base" } \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "c": 0.999727235252031, "ch": "G3", "h": 0.999974654065411, "i": "1m", "l": 0.999353212178554, "n": "bsc", "o": 0.999570907451071, "pa": "0x172fcd41e0913e95784454622d1c3724f546f849", "t": 1753886760, "to": "base", "v": 63932.29404921795 } \`\`\` The output keys will be in random order. ## Tips: ### Un-subscribe to stop streaming OnchainOHLCV data \*\*Input Example:\*\* Unsubscribe for 1 specific pool data: \`\`\`json JSON theme={null} {"command":"message","identifier":"{\\"channel\\":\\"OnchainOHLCV\\"}","data":"{\\"network\_id:pool\_addresses\\":\[\\"eth:0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b\\"\],\\"interval\\":\\"1m\\",\\"token\\":\\"base\\",\\"action\\":\\"unset\_pools\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for eth:0xc7bbec68d12a0d1830360f8ec58fa599ba1b0e9b:1m:base" } \`\`\` \*\*Input Example:\*\* Unsubscribe from OnchainOHLCV channel and all pools data: \`\`\`json JSON theme={null} {"command":"unsubscribe","identifier":"{\\"channel\\":\\"OnchainOHLCV\\"}"} \`\`\` \*\*Output Example\*\*: \`\`\`json JSON theme={null} { "code":2000, "message":"Unsubscription is successful for all pools" } \`\`\`
---
# Crypto Global Market Data - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/crypto-global#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Global
Crypto Global Market Data
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Crypto Global Market Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/global \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"active_cryptocurrencies": 13690,
"upcoming_icos": 0,
"ongoing_icos": 49,
"ended_icos": 3376,
"markets": 1046,
"total_market_cap": {
"btc": 39003738.0847159,
"eth": 803832137.207531,
"ltc": 26721173267.5358,
"bch": 3981159931.51342,
"bnb": 4670513150.58714,
"eos": 2641998753398.41,
"xrp": 4567762968374.06,
"xlm": 21049307801356.5,
"link": 153517938957.199,
"dot": 315120726481.166,
"yfi": 324671967.610845,
"usd": 2721226850772.63,
"aed": 9993705609462.48,
"ars": 2341775032921960,
"aud": 4135040261091.56,
"bdt": 298245137607204,
"bhd": 1024582727718.66,
"bmd": 2721226850772.63,
"brl": 13785980136430.7,
"cad": 3698283351542.55,
"chf": 2454228235855.38,
"clp": 2557393918759370,
"cny": 19681001075528,
"czk": 63568675602103.7,
"dkk": 18728571677757.6,
"eur": 2508293570926.52,
"gbp": 2153208842849.76,
"gel": 7292887960070.66,
"hkd": 21307070180207.2,
"huf": 979811947048335,
"idr": 43234171898362830,
"ils": 10201683535213.3,
"inr": 226670207147326,
"jpy": 412551596711386,
"krw": 3677112086909555,
"kwd": 836219405108.176,
"lkr": 812593109477406,
"mmk": 5706555839881336,
"mxn": 44773978111872.4,
"myr": 12919024474043.1,
"ngn": 3522998071018357,
"nok": 29197131372679.9,
"nzd": 4524820631515.69,
"php": 153994230206450,
"pkr": 755251422720381,
"pln": 10747177948492.4,
"rub": 251732363568359,
"sar": 10207395390373.1,
"sek": 29054498267296.6,
"sgd": 3672056167154.8,
"sol": 2721226850772.63,
"thb": 99649147572586.4,
"try": 87273829665781.3,
"twd": 87422678053291.6,
"uah": 105534042826572,
"vef": 272476444567.864,
"vnd": 67937284004880150,
"zar": 50878778428896,
"xdr": 2052425485204.54,
"xag": 99002369095.9216,
"xau": 1167950564.35161,
"bits": 39003738084715.9,
"sats": 3900373808471590
},
"total_volume": {
"btc": 993675.225562481,
"eth": 20478757.1519219,
"ltc": 680759567.614816,
"bch": 101425662.954523,
"bnb": 118987908.244129,
"eos": 67308643636.0751,
"xrp": 116370202467.687,
"xlm": 536260797157.883,
"link": 3911085965.39774,
"dot": 8028144848.20593,
"yfi": 8271476.18386717,
"usd": 69327091133.5489,
"aed": 254603742187.958,
"ars": 59660021021604.7,
"aud": 105345981331.984,
"bdt": 7598215425943.58,
"bhd": 26102689718.1482,
"bmd": 69327091133.5489,
"brl": 351217283120.761,
"cad": 94218983205.0497,
"chf": 62524924932.7986,
"clp": 65153216175224.4,
"cny": 501401253914.28,
"czk": 1619501647007.04,
"dkk": 477136772017.537,
"eur": 63902315579.4398,
"gbp": 54856031438.6965,
"gel": 185796604237.911,
"hkd": 542827657221.132,
"huf": 24962090950805.3,
"idr": 1101451492157040,
"ils": 259902273109.113,
"inr": 5774743147085.06,
"jpy": 10510333651301.7,
"krw": 93679615385638.7,
"kwd": 21303868469.8839,
"lkr": 20701955274048.2,
"mmk": 145382556642719,
"mxn": 1140680226674.96,
"myr": 329130365156.523,
"ngn": 89753343519839.4,
"nok": 743838091608.3,
"nzd": 115276185884.681,
"php": 3923220156574.62,
"pkr": 19241094948336.3,
"pln": 273799512470.654,
"rub": 6413236921211.56,
"sar": 260047790673.403,
"sek": 740204312126.535,
"sgd": 93550808700.7045,
"sol": 69327091133.5489,
"thb": 2538702546310.57,
"try": 2223423872616.7,
"twd": 2227215995174.62,
"uah": 2688628550997.98,
"vef": 6941721635.20225,
"vnd": 1730798106095000,
"zar": 1296208622923.97,
"xdr": 52288433291.4744,
"xag": 2522224952.61704,
"xau": 29755187.5145192,
"bits": 993675225562.481,
"sats": 99367522556248.1
},
"market_cap_percentage": {
"btc": 50.4465263233584,
"eth": 14.9228066918211,
"usdt": 3.92900641199819,
"bnb": 3.29395203563452,
"sol": 2.95074801328159,
"usdc": 1.20922049263535,
"xrp": 1.20523481041161,
"steth": 1.18309266793764,
"doge": 1.05778560354543,
"ada": 0.765987294694099
},
"market_cap_change_percentage_24h_usd": 1.72179506060272,
"updated_at": 1712512855
}
}
GET
/
global
Try it
Crypto Global Market Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/global \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"active_cryptocurrencies": 13690,
"upcoming_icos": 0,
"ongoing_icos": 49,
"ended_icos": 3376,
"markets": 1046,
"total_market_cap": {
"btc": 39003738.0847159,
"eth": 803832137.207531,
"ltc": 26721173267.5358,
"bch": 3981159931.51342,
"bnb": 4670513150.58714,
"eos": 2641998753398.41,
"xrp": 4567762968374.06,
"xlm": 21049307801356.5,
"link": 153517938957.199,
"dot": 315120726481.166,
"yfi": 324671967.610845,
"usd": 2721226850772.63,
"aed": 9993705609462.48,
"ars": 2341775032921960,
"aud": 4135040261091.56,
"bdt": 298245137607204,
"bhd": 1024582727718.66,
"bmd": 2721226850772.63,
"brl": 13785980136430.7,
"cad": 3698283351542.55,
"chf": 2454228235855.38,
"clp": 2557393918759370,
"cny": 19681001075528,
"czk": 63568675602103.7,
"dkk": 18728571677757.6,
"eur": 2508293570926.52,
"gbp": 2153208842849.76,
"gel": 7292887960070.66,
"hkd": 21307070180207.2,
"huf": 979811947048335,
"idr": 43234171898362830,
"ils": 10201683535213.3,
"inr": 226670207147326,
"jpy": 412551596711386,
"krw": 3677112086909555,
"kwd": 836219405108.176,
"lkr": 812593109477406,
"mmk": 5706555839881336,
"mxn": 44773978111872.4,
"myr": 12919024474043.1,
"ngn": 3522998071018357,
"nok": 29197131372679.9,
"nzd": 4524820631515.69,
"php": 153994230206450,
"pkr": 755251422720381,
"pln": 10747177948492.4,
"rub": 251732363568359,
"sar": 10207395390373.1,
"sek": 29054498267296.6,
"sgd": 3672056167154.8,
"sol": 2721226850772.63,
"thb": 99649147572586.4,
"try": 87273829665781.3,
"twd": 87422678053291.6,
"uah": 105534042826572,
"vef": 272476444567.864,
"vnd": 67937284004880150,
"zar": 50878778428896,
"xdr": 2052425485204.54,
"xag": 99002369095.9216,
"xau": 1167950564.35161,
"bits": 39003738084715.9,
"sats": 3900373808471590
},
"total_volume": {
"btc": 993675.225562481,
"eth": 20478757.1519219,
"ltc": 680759567.614816,
"bch": 101425662.954523,
"bnb": 118987908.244129,
"eos": 67308643636.0751,
"xrp": 116370202467.687,
"xlm": 536260797157.883,
"link": 3911085965.39774,
"dot": 8028144848.20593,
"yfi": 8271476.18386717,
"usd": 69327091133.5489,
"aed": 254603742187.958,
"ars": 59660021021604.7,
"aud": 105345981331.984,
"bdt": 7598215425943.58,
"bhd": 26102689718.1482,
"bmd": 69327091133.5489,
"brl": 351217283120.761,
"cad": 94218983205.0497,
"chf": 62524924932.7986,
"clp": 65153216175224.4,
"cny": 501401253914.28,
"czk": 1619501647007.04,
"dkk": 477136772017.537,
"eur": 63902315579.4398,
"gbp": 54856031438.6965,
"gel": 185796604237.911,
"hkd": 542827657221.132,
"huf": 24962090950805.3,
"idr": 1101451492157040,
"ils": 259902273109.113,
"inr": 5774743147085.06,
"jpy": 10510333651301.7,
"krw": 93679615385638.7,
"kwd": 21303868469.8839,
"lkr": 20701955274048.2,
"mmk": 145382556642719,
"mxn": 1140680226674.96,
"myr": 329130365156.523,
"ngn": 89753343519839.4,
"nok": 743838091608.3,
"nzd": 115276185884.681,
"php": 3923220156574.62,
"pkr": 19241094948336.3,
"pln": 273799512470.654,
"rub": 6413236921211.56,
"sar": 260047790673.403,
"sek": 740204312126.535,
"sgd": 93550808700.7045,
"sol": 69327091133.5489,
"thb": 2538702546310.57,
"try": 2223423872616.7,
"twd": 2227215995174.62,
"uah": 2688628550997.98,
"vef": 6941721635.20225,
"vnd": 1730798106095000,
"zar": 1296208622923.97,
"xdr": 52288433291.4744,
"xag": 2522224952.61704,
"xau": 29755187.5145192,
"bits": 993675225562.481,
"sats": 99367522556248.1
},
"market_cap_percentage": {
"btc": 50.4465263233584,
"eth": 14.9228066918211,
"usdt": 3.92900641199819,
"bnb": 3.29395203563452,
"sol": 2.95074801328159,
"usdc": 1.20922049263535,
"xrp": 1.20523481041161,
"steth": 1.18309266793764,
"doge": 1.05778560354543,
"ada": 0.765987294694099
},
"market_cap_change_percentage_24h_usd": 1.72179506060272,
"updated_at": 1712512855
}
}
###
[](https://docs.coingecko.com/reference/crypto-global#note)
Note
* Cache / Update Frequency: every 10 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/crypto-global#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
Get cryptocurrency global data
[](https://docs.coingecko.com/reference/crypto-global#response-data)
data
object
Show child attributes
Was this page helpful?
YesNo
[Trending Search List](https://docs.coingecko.com/reference/trending-search)
[Global DeFi Market Data](https://docs.coingecko.com/reference/global-defi)
⌘I
---
# Trending Search List - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/trending-search#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Trending
Trending Search List
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Trending Search List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/search/trending \
--header 'x-cg-pro-api-key: '
200
Copy
{
"coins": [\
{\
"item": {\
"id": "moon-tropica",\
"coin_id": 28470,\
"name": "Moon Tropica",\
"symbol": "CAH",\
"market_cap_rank": 530,\
"thumb": "https://assets.coingecko.com/coins/images/28470/standard/MTLOGO.png?1696527464",\
"small": "https://assets.coingecko.com/coins/images/28470/small/MTLOGO.png?1696527464",\
"large": "https://assets.coingecko.com/coins/images/28470/large/MTLOGO.png?1696527464",\
"slug": "moon-tropica",\
"price_btc": 0.000530163474333298,\
"score": 0,\
"data": {\
"price": 36.9717118016975,\
"price_btc": "0.000530163474333299",\
"price_change_percentage_24h": {\
"aed": -4.04467447608756,\
"ars": -4.04990008945855,\
"aud": -4.04990008945802,\
"bch": -2.37567962487489,\
"bdt": -4.0499000894585,\
"bhd": -4.16927013396437,\
"bmd": -4.04990008945853,\
"bnb": -3.4734695990217,\
"brl": -4.04990008945847,\
"btc": -5.98585375059246,\
"cad": -4.04990008945848,\
"chf": -4.04990008945855,\
"clp": -5.02567556756719,\
"cny": -4.0499000894584,\
"czk": -4.04990008945864,\
"dkk": -4.04990008945864,\
"dot": -5.98238779521245,\
"eos": -5.74405098071799,\
"eth": -5.05689445119971,\
"eur": -4.09661619752604,\
"gbp": -4.04990008945847,\
"gel": -4.04990008945897,\
"hkd": -4.04990008945852,\
"huf": -4.05387716450818,\
"idr": -4.04990008945821,\
"ils": -4.40922021210977,\
"inr": -4.04990008945856,\
"jpy": -4.04990008945905,\
"krw": -4.04990008945847,\
"kwd": -4.12041469685036,\
"lkr": -4.0499000894589,\
"ltc": -5.29341338838337,\
"mmk": -4.04990008945877,\
"mxn": -4.0499000894592,\
"myr": -4.04990008945872,\
"ngn": -4.04990008945849,\
"nok": -4.04990008945854,\
"nzd": -4.0499000894586,\
"php": -4.04990008945844,\
"pkr": -4.04990008945845,\
"pln": -4.04990008945856,\
"rub": -4.04990008945847,\
"sar": -4.04990008945841,\
"sek": -4.04990008945854,\
"sgd": -4.04990008945858,\
"sol": -4.04990008945847,\
"thb": -4.04105687070854,\
"try": -4.04990008945837,\
"twd": -4.04990008945847,\
"uah": -4.17945939929411,\
"usd": -4.04990008945853,\
"vef": -4.0499000894584,\
"vnd": -4.04990008945868,\
"xag": -4.06208301025163,\
"xau": -4.04990008945842,\
"xdr": -4.04990008945852,\
"xlm": -4.12493924900392,\
"xrp": -4.48127069993476,\
"yfi": -4.04427366181248,\
"zar": -4.0499000894588,\
"bits": -5.98585375059245,\
"link": -5.12005806599531,\
"sats": -5.98585375059245\
},\
"market_cap": "$99,703,583",\
"market_cap_btc": "1428.83459310001",\
"total_volume": "$282,142",\
"total_volume_btc": "4.04583894742915",\
"sparkline": "https://www.coingecko.com/coins/28470/sparkline.svg",\
"content": null\
}\
}\
},\
{\
"item": {\
"id": "gala",\
"coin_id": 12493,\
"name": "GALA",\
"symbol": "GALA",\
"market_cap_rank": 53,\
"thumb": "https://assets.coingecko.com/coins/images/12493/standard/GALA_token_image_-_200PNG.png?1709725869",\
"small": "https://assets.coingecko.com/coins/images/12493/small/GALA_token_image_-_200PNG.png?1709725869",\
"large": "https://assets.coingecko.com/coins/images/12493/large/GALA_token_image_-_200PNG.png?1709725869",\
"slug": "gala",\
"price_btc": 8.99538550992028e-7,\
"score": 1,\
"data": {\
"price": 0.0627306136161425,\
"price_btc": "0.000000899538550992028",\
"price_change_percentage_24h": {\
"aed": 9.60780028942887,\
"ars": 9.60183117845321,\
"aud": 9.60183117845384,\
"bch": 11.4674219663065,\
"bdt": 9.60183117845328,\
"bhd": 9.4654772249098,\
"bmd": 9.60183117845317,\
"bnb": 10.2234284851282,\
"brl": 9.60183117845336,\
"btc": 7.38745825724124,\
"cad": 9.60183117845328,\
"chf": 9.60183117845322,\
"clp": 8.48722286309518,\
"cny": 9.60183117845327,\
"czk": 9.60183117845312,\
"dkk": 9.60183117845326,\
"dot": 7.37688026427037,\
"eos": 7.62858932956233,\
"eth": 8.45108220753484,\
"eur": 9.54846832636144,\
"gbp": 9.60183117845332,\
"gel": 9.60183117845289,\
"hkd": 9.60183117845327,\
"huf": 9.59728824719456,\
"idr": 9.60183117845271,\
"ils": 9.19138717205251,\
"inr": 9.60183117845323,\
"jpy": 9.60183117845302,\
"krw": 9.60183117845328,\
"kwd": 9.52128378869318,\
"lkr": 9.60183117845326,\
"ltc": 8.06524825045215,\
"mmk": 9.60183117845293,\
"mxn": 9.60183117845321,\
"myr": 9.60183117845329,\
"ngn": 9.60183117845327,\
"nok": 9.6018311784532,\
"nzd": 9.60183117845338,\
"php": 9.60183117845333,\
"pkr": 9.60183117845299,\
"pln": 9.6018311784534,\
"rub": 9.60183117845327,\
"sar": 9.6018311784533,\
"sek": 9.60183117845319,\
"sgd": 9.60183117845319,\
"sol": 9.60183117845328,\
"thb": 9.61193260585552,\
"try": 9.60183117845312,\
"twd": 9.601831178453,\
"uah": 9.45383823610663,\
"usd": 9.60183117845317,\
"vef": 9.60183117845337,\
"vnd": 9.60183117845306,\
"xag": 9.58791487790447,\
"xau": 9.60183117845332,\
"xdr": 9.60183117845335,\
"xlm": 9.4911259696921,\
"xrp": 8.99767343610987,\
"yfi": 9.54409111376635,\
"zar": 9.6018311784527,\
"bits": 7.38745825724125,\
"link": 8.37662653267695,\
"sats": 7.38745825724125\
},\
"market_cap": "$2,365,621,969",\
"market_cap_btc": "33901.3141933559",\
"total_volume": "$212,777,204",\
"total_volume_btc": "3051.16253202022",\
"sparkline": "https://www.coingecko.com/coins/12493/sparkline.svg",\
"content": {\
"title": "What is GALA?",\
"description": "Gala is a blockchain gaming ecosystem. Gamers can explore different type of games and have their experiences interact across each other on the Gala platform. The GALA token is the utility token and primary medium of exchange of the ecosystem. Game items are represented as NFTs on the Ethereum blockchain and users can trade them on all marketplaces."\
}\
}\
}\
}\
],
"nfts": [\
{\
"id": "chameleon-travel-club",\
"name": "ChameleonTravelClub",\
"symbol": "CTC",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3610/standard/chameleon-travel-club.png?1707290106",\
"nft_contract_id": 3610,\
"native_currency_symbol": "eth",\
"floor_price_in_native_currency": 4.29,\
"floor_price_24h_percentage_change": 57.3120347225931,\
"data": {\
"floor_price": "4.29 ETH",\
"floor_price_in_usd_24h_percentage_change": "57.3120347225931",\
"h24_volume": "11.26 ETH",\
"h24_average_sale_price": "2.82 ETH",\
"sparkline": "https://www.coingecko.com/nft/3610/sparkline.svg",\
"content": null\
}\
},\
{\
"id": "natcats",\
"name": "Natcats",\
"symbol": "DMTNATCATS",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/4171/standard/natcats.png?1709517703",\
"nft_contract_id": 4171,\
"native_currency_symbol": "btc",\
"floor_price_in_native_currency": 0.05139,\
"floor_price_24h_percentage_change": 52.5917829733019,\
"data": {\
"floor_price": "0.051 BTC",\
"floor_price_in_usd_24h_percentage_change": "52.5917829733019",\
"h24_volume": "3.93 BTC",\
"h24_average_sale_price": "0.049 BTC",\
"sparkline": "https://www.coingecko.com/nft/4171/sparkline.svg",\
"content": null\
}\
}\
],
"categories": [\
{\
"id": 251,\
"name": "Solana Meme Coins",\
"market_cap_1h_change": 1.44537649465531,\
"slug": "solana-meme-coins",\
"coins_count": 79,\
"data": {\
"market_cap": 8237562936.01112,\
"market_cap_btc": 118852.276224895,\
"total_volume": 1207846273.32444,\
"total_volume_btc": 17426.911336459,\
"market_cap_change_percentage_24h": {\
"aed": 14.2303965235397,\
"ars": 14.224569755904,\
"aud": 14.2241756714483,\
"bch": 10.544446407888,\
"bdt": 14.2241756714484,\
"bhd": 14.0820711301687,\
"bmd": 14.2241756714485,\
"bnb": 12.6244772393324,\
"brl": 14.221695576047,\
"btc": 11.84681099263,\
"cad": 14.232580997301,\
"chf": 14.2241756714485,\
"clp": 13.0625598968815,\
"cny": 14.2178586614014,\
"czk": 14.2241756714486,\
"dkk": 14.2241756714484,\
"dot": 10.6966484935826,\
"eos": 10.1217314444624,\
"eth": 11.8847596390012,\
"eur": 14.1685622959589,\
"gbp": 14.2241756714485,\
"gel": 14.2241756714491,\
"hkd": 14.2241756714487,\
"huf": 14.2194411467367,\
"idr": 14.2241756714489,\
"ils": 13.7964216112624,\
"inr": 14.2241756714486,\
"jpy": 14.2241756714483,\
"krw": 14.2241756714485,\
"kwd": 14.1402312783772,\
"lkr": 14.2241756714485,\
"ltc": 8.6428668776247,\
"mmk": 14.224175671449,\
"mxn": 14.2241756714481,\
"myr": 14.2241756714485,\
"ngn": 14.2241756714486,\
"nok": 14.2241756714485,\
"nzd": 14.2241756714481,\
"php": 14.2241756714486,\
"pkr": 14.2241756714484,\
"pln": 14.2068251066482,\
"rub": 14.2241756714486,\
"sar": 14.2241756714487,\
"sek": 14.2241756714486,\
"sgd": 14.2241756714485,\
"sol": 14.2241756714485,\
"thb": 14.2347031161614,\
"try": 14.2241756714486,\
"twd": 14.224175671449,\
"uah": 14.0699412789845,\
"usd": 14.2241756714485,\
"vef": 14.2241756714486,\
"vnd": 14.2241756714489,\
"xag": 14.2096724652385,\
"xau": 14.2241756714488,\
"xdr": 14.2241756714487,\
"xlm": 11.8320435642723,\
"xrp": 12.4172400147244,\
"yfi": 12.7954918554954,\
"zar": 14.2241756714481,\
"bits": 11.84681099263,\
"link": 11.6566512723034,\
"sats": 11.84681099263\
},\
"sparkline": "https://www.coingecko.com/categories/25211443/sparkline.svg"\
}\
},\
{\
"id": 327,\
"name": "Gaming Platform",\
"market_cap_1h_change": 1.10506929591162,\
"slug": "gaming-platform",\
"coins_count": 20,\
"data": {\
"market_cap": 3665275001.85375,\
"market_cap_btc": 52882.9072802773,\
"total_volume": 218189404.503211,\
"total_volume_btc": 3148.05575080902,\
"market_cap_change_percentage_24h": {\
"aed": 5.95319529244364,\
"ars": 5.94779073579304,\
"aud": 5.94742520692706,\
"bch": 2.53433127439418,\
"bdt": 5.94742520692721,\
"bhd": 5.81561764368333,\
"bmd": 5.94742520692732,\
"bnb": 4.46364185726444,\
"brl": 5.94512482068669,\
"btc": 3.7423257608765,\
"cad": 5.95522147796062,\
"chf": 5.94742520692729,\
"clp": 4.8699807896516,\
"cny": 5.9415659311167,\
"czk": 5.94742520692735,\
"dkk": 5.94742520692723,\
"dot": 2.67550470808869,\
"eos": 2.14224648404119,\
"eth": 3.7775246261735,\
"eur": 5.89584160909828,\
"gbp": 5.94742520692727,\
"gel": 5.94742520692782,\
"hkd": 5.94742520692747,\
"huf": 5.94303374864054,\
"idr": 5.94742520692765,\
"ils": 5.55066645570739,\
"inr": 5.94742520692736,\
"jpy": 5.94742520692707,\
"krw": 5.9474252069273,\
"kwd": 5.86956347359295,\
"lkr": 5.94742520692729,\
"ltc": 0.770541307223899,\
"mmk": 5.9474252069277,\
"mxn": 5.94742520692689,\
"myr": 5.94742520692724,\
"ngn": 5.94742520692737,\
"nok": 5.94742520692729,\
"nzd": 5.94742520692689,\
"php": 5.94742520692736,\
"pkr": 5.94742520692717,\
"pln": 5.93133187418339,\
"rub": 5.94742520692736,\
"sar": 5.94742520692747,\
"sek": 5.94742520692736,\
"sgd": 5.94742520692729,\
"sol": 5.9474252069273,\
"thb": 5.95718982684932,\
"try": 5.94742520692738,\
"twd": 5.94742520692774,\
"uah": 5.80436672859846,\
"usd": 5.94742520692732,\
"vef": 5.94742520692733,\
"vnd": 5.94742520692767,\
"xag": 5.93397291150769,\
"xau": 5.94742520692753,\
"xdr": 5.94742520692749,\
"xlm": 3.72862838900029,\
"xrp": 4.27142116295708,\
"yfi": 4.62226465448499,\
"zar": 5.94742520692694,\
"bits": 3.7423257608765,\
"link": 3.5659451249189,\
"sats": 3.74232576087651\
},\
"sparkline": "https://www.coingecko.com/categories/25211410/sparkline.svg"\
}\
}\
]
}
GET
/
search
/
trending
Try it
Trending Search List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/search/trending \
--header 'x-cg-pro-api-key: '
200
Copy
{
"coins": [\
{\
"item": {\
"id": "moon-tropica",\
"coin_id": 28470,\
"name": "Moon Tropica",\
"symbol": "CAH",\
"market_cap_rank": 530,\
"thumb": "https://assets.coingecko.com/coins/images/28470/standard/MTLOGO.png?1696527464",\
"small": "https://assets.coingecko.com/coins/images/28470/small/MTLOGO.png?1696527464",\
"large": "https://assets.coingecko.com/coins/images/28470/large/MTLOGO.png?1696527464",\
"slug": "moon-tropica",\
"price_btc": 0.000530163474333298,\
"score": 0,\
"data": {\
"price": 36.9717118016975,\
"price_btc": "0.000530163474333299",\
"price_change_percentage_24h": {\
"aed": -4.04467447608756,\
"ars": -4.04990008945855,\
"aud": -4.04990008945802,\
"bch": -2.37567962487489,\
"bdt": -4.0499000894585,\
"bhd": -4.16927013396437,\
"bmd": -4.04990008945853,\
"bnb": -3.4734695990217,\
"brl": -4.04990008945847,\
"btc": -5.98585375059246,\
"cad": -4.04990008945848,\
"chf": -4.04990008945855,\
"clp": -5.02567556756719,\
"cny": -4.0499000894584,\
"czk": -4.04990008945864,\
"dkk": -4.04990008945864,\
"dot": -5.98238779521245,\
"eos": -5.74405098071799,\
"eth": -5.05689445119971,\
"eur": -4.09661619752604,\
"gbp": -4.04990008945847,\
"gel": -4.04990008945897,\
"hkd": -4.04990008945852,\
"huf": -4.05387716450818,\
"idr": -4.04990008945821,\
"ils": -4.40922021210977,\
"inr": -4.04990008945856,\
"jpy": -4.04990008945905,\
"krw": -4.04990008945847,\
"kwd": -4.12041469685036,\
"lkr": -4.0499000894589,\
"ltc": -5.29341338838337,\
"mmk": -4.04990008945877,\
"mxn": -4.0499000894592,\
"myr": -4.04990008945872,\
"ngn": -4.04990008945849,\
"nok": -4.04990008945854,\
"nzd": -4.0499000894586,\
"php": -4.04990008945844,\
"pkr": -4.04990008945845,\
"pln": -4.04990008945856,\
"rub": -4.04990008945847,\
"sar": -4.04990008945841,\
"sek": -4.04990008945854,\
"sgd": -4.04990008945858,\
"sol": -4.04990008945847,\
"thb": -4.04105687070854,\
"try": -4.04990008945837,\
"twd": -4.04990008945847,\
"uah": -4.17945939929411,\
"usd": -4.04990008945853,\
"vef": -4.0499000894584,\
"vnd": -4.04990008945868,\
"xag": -4.06208301025163,\
"xau": -4.04990008945842,\
"xdr": -4.04990008945852,\
"xlm": -4.12493924900392,\
"xrp": -4.48127069993476,\
"yfi": -4.04427366181248,\
"zar": -4.0499000894588,\
"bits": -5.98585375059245,\
"link": -5.12005806599531,\
"sats": -5.98585375059245\
},\
"market_cap": "$99,703,583",\
"market_cap_btc": "1428.83459310001",\
"total_volume": "$282,142",\
"total_volume_btc": "4.04583894742915",\
"sparkline": "https://www.coingecko.com/coins/28470/sparkline.svg",\
"content": null\
}\
}\
},\
{\
"item": {\
"id": "gala",\
"coin_id": 12493,\
"name": "GALA",\
"symbol": "GALA",\
"market_cap_rank": 53,\
"thumb": "https://assets.coingecko.com/coins/images/12493/standard/GALA_token_image_-_200PNG.png?1709725869",\
"small": "https://assets.coingecko.com/coins/images/12493/small/GALA_token_image_-_200PNG.png?1709725869",\
"large": "https://assets.coingecko.com/coins/images/12493/large/GALA_token_image_-_200PNG.png?1709725869",\
"slug": "gala",\
"price_btc": 8.99538550992028e-7,\
"score": 1,\
"data": {\
"price": 0.0627306136161425,\
"price_btc": "0.000000899538550992028",\
"price_change_percentage_24h": {\
"aed": 9.60780028942887,\
"ars": 9.60183117845321,\
"aud": 9.60183117845384,\
"bch": 11.4674219663065,\
"bdt": 9.60183117845328,\
"bhd": 9.4654772249098,\
"bmd": 9.60183117845317,\
"bnb": 10.2234284851282,\
"brl": 9.60183117845336,\
"btc": 7.38745825724124,\
"cad": 9.60183117845328,\
"chf": 9.60183117845322,\
"clp": 8.48722286309518,\
"cny": 9.60183117845327,\
"czk": 9.60183117845312,\
"dkk": 9.60183117845326,\
"dot": 7.37688026427037,\
"eos": 7.62858932956233,\
"eth": 8.45108220753484,\
"eur": 9.54846832636144,\
"gbp": 9.60183117845332,\
"gel": 9.60183117845289,\
"hkd": 9.60183117845327,\
"huf": 9.59728824719456,\
"idr": 9.60183117845271,\
"ils": 9.19138717205251,\
"inr": 9.60183117845323,\
"jpy": 9.60183117845302,\
"krw": 9.60183117845328,\
"kwd": 9.52128378869318,\
"lkr": 9.60183117845326,\
"ltc": 8.06524825045215,\
"mmk": 9.60183117845293,\
"mxn": 9.60183117845321,\
"myr": 9.60183117845329,\
"ngn": 9.60183117845327,\
"nok": 9.6018311784532,\
"nzd": 9.60183117845338,\
"php": 9.60183117845333,\
"pkr": 9.60183117845299,\
"pln": 9.6018311784534,\
"rub": 9.60183117845327,\
"sar": 9.6018311784533,\
"sek": 9.60183117845319,\
"sgd": 9.60183117845319,\
"sol": 9.60183117845328,\
"thb": 9.61193260585552,\
"try": 9.60183117845312,\
"twd": 9.601831178453,\
"uah": 9.45383823610663,\
"usd": 9.60183117845317,\
"vef": 9.60183117845337,\
"vnd": 9.60183117845306,\
"xag": 9.58791487790447,\
"xau": 9.60183117845332,\
"xdr": 9.60183117845335,\
"xlm": 9.4911259696921,\
"xrp": 8.99767343610987,\
"yfi": 9.54409111376635,\
"zar": 9.6018311784527,\
"bits": 7.38745825724125,\
"link": 8.37662653267695,\
"sats": 7.38745825724125\
},\
"market_cap": "$2,365,621,969",\
"market_cap_btc": "33901.3141933559",\
"total_volume": "$212,777,204",\
"total_volume_btc": "3051.16253202022",\
"sparkline": "https://www.coingecko.com/coins/12493/sparkline.svg",\
"content": {\
"title": "What is GALA?",\
"description": "Gala is a blockchain gaming ecosystem. Gamers can explore different type of games and have their experiences interact across each other on the Gala platform. The GALA token is the utility token and primary medium of exchange of the ecosystem. Game items are represented as NFTs on the Ethereum blockchain and users can trade them on all marketplaces."\
}\
}\
}\
}\
],
"nfts": [\
{\
"id": "chameleon-travel-club",\
"name": "ChameleonTravelClub",\
"symbol": "CTC",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3610/standard/chameleon-travel-club.png?1707290106",\
"nft_contract_id": 3610,\
"native_currency_symbol": "eth",\
"floor_price_in_native_currency": 4.29,\
"floor_price_24h_percentage_change": 57.3120347225931,\
"data": {\
"floor_price": "4.29 ETH",\
"floor_price_in_usd_24h_percentage_change": "57.3120347225931",\
"h24_volume": "11.26 ETH",\
"h24_average_sale_price": "2.82 ETH",\
"sparkline": "https://www.coingecko.com/nft/3610/sparkline.svg",\
"content": null\
}\
},\
{\
"id": "natcats",\
"name": "Natcats",\
"symbol": "DMTNATCATS",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/4171/standard/natcats.png?1709517703",\
"nft_contract_id": 4171,\
"native_currency_symbol": "btc",\
"floor_price_in_native_currency": 0.05139,\
"floor_price_24h_percentage_change": 52.5917829733019,\
"data": {\
"floor_price": "0.051 BTC",\
"floor_price_in_usd_24h_percentage_change": "52.5917829733019",\
"h24_volume": "3.93 BTC",\
"h24_average_sale_price": "0.049 BTC",\
"sparkline": "https://www.coingecko.com/nft/4171/sparkline.svg",\
"content": null\
}\
}\
],
"categories": [\
{\
"id": 251,\
"name": "Solana Meme Coins",\
"market_cap_1h_change": 1.44537649465531,\
"slug": "solana-meme-coins",\
"coins_count": 79,\
"data": {\
"market_cap": 8237562936.01112,\
"market_cap_btc": 118852.276224895,\
"total_volume": 1207846273.32444,\
"total_volume_btc": 17426.911336459,\
"market_cap_change_percentage_24h": {\
"aed": 14.2303965235397,\
"ars": 14.224569755904,\
"aud": 14.2241756714483,\
"bch": 10.544446407888,\
"bdt": 14.2241756714484,\
"bhd": 14.0820711301687,\
"bmd": 14.2241756714485,\
"bnb": 12.6244772393324,\
"brl": 14.221695576047,\
"btc": 11.84681099263,\
"cad": 14.232580997301,\
"chf": 14.2241756714485,\
"clp": 13.0625598968815,\
"cny": 14.2178586614014,\
"czk": 14.2241756714486,\
"dkk": 14.2241756714484,\
"dot": 10.6966484935826,\
"eos": 10.1217314444624,\
"eth": 11.8847596390012,\
"eur": 14.1685622959589,\
"gbp": 14.2241756714485,\
"gel": 14.2241756714491,\
"hkd": 14.2241756714487,\
"huf": 14.2194411467367,\
"idr": 14.2241756714489,\
"ils": 13.7964216112624,\
"inr": 14.2241756714486,\
"jpy": 14.2241756714483,\
"krw": 14.2241756714485,\
"kwd": 14.1402312783772,\
"lkr": 14.2241756714485,\
"ltc": 8.6428668776247,\
"mmk": 14.224175671449,\
"mxn": 14.2241756714481,\
"myr": 14.2241756714485,\
"ngn": 14.2241756714486,\
"nok": 14.2241756714485,\
"nzd": 14.2241756714481,\
"php": 14.2241756714486,\
"pkr": 14.2241756714484,\
"pln": 14.2068251066482,\
"rub": 14.2241756714486,\
"sar": 14.2241756714487,\
"sek": 14.2241756714486,\
"sgd": 14.2241756714485,\
"sol": 14.2241756714485,\
"thb": 14.2347031161614,\
"try": 14.2241756714486,\
"twd": 14.224175671449,\
"uah": 14.0699412789845,\
"usd": 14.2241756714485,\
"vef": 14.2241756714486,\
"vnd": 14.2241756714489,\
"xag": 14.2096724652385,\
"xau": 14.2241756714488,\
"xdr": 14.2241756714487,\
"xlm": 11.8320435642723,\
"xrp": 12.4172400147244,\
"yfi": 12.7954918554954,\
"zar": 14.2241756714481,\
"bits": 11.84681099263,\
"link": 11.6566512723034,\
"sats": 11.84681099263\
},\
"sparkline": "https://www.coingecko.com/categories/25211443/sparkline.svg"\
}\
},\
{\
"id": 327,\
"name": "Gaming Platform",\
"market_cap_1h_change": 1.10506929591162,\
"slug": "gaming-platform",\
"coins_count": 20,\
"data": {\
"market_cap": 3665275001.85375,\
"market_cap_btc": 52882.9072802773,\
"total_volume": 218189404.503211,\
"total_volume_btc": 3148.05575080902,\
"market_cap_change_percentage_24h": {\
"aed": 5.95319529244364,\
"ars": 5.94779073579304,\
"aud": 5.94742520692706,\
"bch": 2.53433127439418,\
"bdt": 5.94742520692721,\
"bhd": 5.81561764368333,\
"bmd": 5.94742520692732,\
"bnb": 4.46364185726444,\
"brl": 5.94512482068669,\
"btc": 3.7423257608765,\
"cad": 5.95522147796062,\
"chf": 5.94742520692729,\
"clp": 4.8699807896516,\
"cny": 5.9415659311167,\
"czk": 5.94742520692735,\
"dkk": 5.94742520692723,\
"dot": 2.67550470808869,\
"eos": 2.14224648404119,\
"eth": 3.7775246261735,\
"eur": 5.89584160909828,\
"gbp": 5.94742520692727,\
"gel": 5.94742520692782,\
"hkd": 5.94742520692747,\
"huf": 5.94303374864054,\
"idr": 5.94742520692765,\
"ils": 5.55066645570739,\
"inr": 5.94742520692736,\
"jpy": 5.94742520692707,\
"krw": 5.9474252069273,\
"kwd": 5.86956347359295,\
"lkr": 5.94742520692729,\
"ltc": 0.770541307223899,\
"mmk": 5.9474252069277,\
"mxn": 5.94742520692689,\
"myr": 5.94742520692724,\
"ngn": 5.94742520692737,\
"nok": 5.94742520692729,\
"nzd": 5.94742520692689,\
"php": 5.94742520692736,\
"pkr": 5.94742520692717,\
"pln": 5.93133187418339,\
"rub": 5.94742520692736,\
"sar": 5.94742520692747,\
"sek": 5.94742520692736,\
"sgd": 5.94742520692729,\
"sol": 5.9474252069273,\
"thb": 5.95718982684932,\
"try": 5.94742520692738,\
"twd": 5.94742520692774,\
"uah": 5.80436672859846,\
"usd": 5.94742520692732,\
"vef": 5.94742520692733,\
"vnd": 5.94742520692767,\
"xag": 5.93397291150769,\
"xau": 5.94742520692753,\
"xdr": 5.94742520692749,\
"xlm": 3.72862838900029,\
"xrp": 4.27142116295708,\
"yfi": 4.62226465448499,\
"zar": 5.94742520692694,\
"bits": 3.7423257608765,\
"link": 3.5659451249189,\
"sats": 3.74232576087651\
},\
"sparkline": "https://www.coingecko.com/categories/25211410/sparkline.svg"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/trending-search#note)
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 6 trending categories (sorted by the most popular user searches).
* [Paid plan](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan & above) can use `show_max` param to retrieve maximum 30 coins, 10 NFTs, and 10 categories.
* Cache / Update Frequency: every 10 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/trending-search#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/trending-search#parameter-show-max)
show\_max
string
default:coins
show max number of results available for the given type Available values: `coins`, `nfts`, `categories` Example: `coins` or `coins,nfts,categories`
#### Response
200 - application/json
List trending coins by most popular first
[](https://docs.coingecko.com/reference/trending-search#response-coins)
coins
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/trending-search#response-nfts)
nfts
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/trending-search#response-categories)
categories
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Search Queries](https://docs.coingecko.com/reference/search-data)
[Crypto Global Market Data](https://docs.coingecko.com/reference/crypto-global)
⌘I
---
# Supported Currencies List - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/simple-supported-currencies#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Simple
Supported Currencies List
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Supported Currencies List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/supported_vs_currencies \
--header 'x-cg-pro-api-key: '
200
Copy
[\
"btc",\
"eth",\
"ltc",\
"bch",\
"bnb",\
"eos",\
"xrp",\
"xlm",\
"link",\
"dot",\
"yfi",\
"sol",\
"usd",\
"aed",\
"ars",\
"aud",\
"bdt",\
"bhd",\
"bmd",\
"brl",\
"cad",\
"chf",\
"clp",\
"cny",\
"czk",\
"dkk",\
"eur",\
"gbp",\
"gel",\
"hkd",\
"huf",\
"idr",\
"ils",\
"inr",\
"jpy",\
"krw",\
"kwd",\
"lkr",\
"mmk",\
"mxn",\
"myr",\
"ngn",\
"nok",\
"nzd",\
"php",\
"pkr",\
"pln",\
"rub",\
"sar",\
"sek",\
"sgd",\
"thb",\
"try",\
"twd",\
"uah",\
"vef",\
"vnd",\
"zar",\
"xdr",\
"xag",\
"xau",\
"bits",\
"sats"\
]
GET
/
simple
/
supported\_vs\_currencies
Try it
Supported Currencies List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/supported_vs_currencies \
--header 'x-cg-pro-api-key: '
200
Copy
[\
"btc",\
"eth",\
"ltc",\
"bch",\
"bnb",\
"eos",\
"xrp",\
"xlm",\
"link",\
"dot",\
"yfi",\
"sol",\
"usd",\
"aed",\
"ars",\
"aud",\
"bdt",\
"bhd",\
"bmd",\
"brl",\
"cad",\
"chf",\
"clp",\
"cny",\
"czk",\
"dkk",\
"eur",\
"gbp",\
"gel",\
"hkd",\
"huf",\
"idr",\
"ils",\
"inr",\
"jpy",\
"krw",\
"kwd",\
"lkr",\
"mmk",\
"mxn",\
"myr",\
"ngn",\
"nok",\
"nzd",\
"php",\
"pkr",\
"pln",\
"rub",\
"sar",\
"sek",\
"sgd",\
"thb",\
"try",\
"twd",\
"uah",\
"vef",\
"vnd",\
"zar",\
"xdr",\
"xag",\
"xau",\
"bits",\
"sats"\
]
###
[](https://docs.coingecko.com/reference/simple-supported-currencies#tips)
Tips
* You may use this endpoint to query the list of currencies for other endpoints that contain params like `vs_currencies`.
###
[](https://docs.coingecko.com/reference/simple-supported-currencies#note)
Note
* Cache/Update Frequency: every 30 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/simple-supported-currencies#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
list of supported currencies
Example:
[ "btc", "eth", "ltc", "bch", "bnb", "eos", "xrp", "xlm", "link", "dot", "yfi", "sol", "usd", "aed", "ars", "aud", "bdt", "bhd", "bmd", "brl", "cad", "chf", "clp", "cny", "czk", "dkk", "eur", "gbp", "gel", "hkd", "huf", "idr", "ils", "inr", "jpy", "krw", "kwd", "lkr", "mmk", "mxn", "myr", "ngn", "nok", "nzd", "php", "pkr", "pln", "rub", "sar", "sek", "sgd", "thb", "try", "twd", "uah", "vef", "vnd", "zar", "xdr", "xag", "xau", "bits", "sats"]
Was this page helpful?
YesNo
[Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price)
[Coins List (ID Map)](https://docs.coingecko.com/reference/coins-list)
⌘I
---
# TypeScript AI Prompts - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/typescript-ai-prompts#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
AI Integration
TypeScript AI Prompts
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [How to Use Our Prompts](https://docs.coingecko.com/docs/typescript-ai-prompts#how-to-use-our-prompts)
* [Resources](https://docs.coingecko.com/docs/typescript-ai-prompts#resources)
[](https://docs.coingecko.com/docs/typescript-ai-prompts#how-to-use-our-prompts)
How to Use Our Prompts
-----------------------------------------------------------------------------------------------------------
Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant.
1. For **Chat Interfaces (Claude, ChatGPT, etc.)**: Paste the prompt at the beginning of your conversation before asking the AI to write code.
2. For **Cursor IDE**: Add the prompt to your project’s `Rules` to enforce the guidelines across all AI interactions.
3. For **GitHub Copilot**: Save the prompt to a file (e.g. `coingecko_rules.md`) and reference it in your chat with `@workspace #coingecko_rules.md`.
4. For **Claude Code**: Include the prompt in your CLAUDE.md file.
Markdown
Copy
# Goal: Generate TypeScript code for the CoinGecko API using ONLY the official `@coingecko/coingecko-typescript` package.
## 🚨 Critical Rules
1. **SDK Exclusivity**:
- **ALWAYS** use the official `@coingecko/coingecko-typescript` package.
- **NEVER** use `axios`, `fetch`, or any other method to make direct HTTP requests.
2. **Authentication**:
- **ALWAYS** load the API key from environment variables (e.g., `process.env.COINGECKO_PRO_API_KEY` or `dotenv`).
- **NEVER** hardcode API keys or any other credentials in the source code.
3. **Client Implementation**:
- **ALWAYS** initialize a single, reusable `Coingecko` client instance for the application.
- **ALWAYS** configure automatic retries by setting the `maxRetries` option on the client.
- **NEVER** implement manual retry loops using `setTimeout`. The SDK handles this internally.
4. **Error Handling & Types**:
- **ALWAYS** use `async/await` for all API calls.
- **ALWAYS** catch specific `APIError` subclasses using `instanceof` (e.g., `err instanceof Coingecko.RateLimitError`).
- **ALWAYS** use the built-in request and response types (e.g., `Coingecko.Simple.PriceGetParams`).
- **NEVER** use generic `catch (e)` blocks for known API errors.
## ✅ Correct Implementation Example
This is the standard for all generated code.
```typescript
// src/api/client.ts
import Coingecko from '@coingecko/coingecko-typescript';
// Initialize a single, reusable client. This should be imported and used application-wide.
export const client = new Coingecko({
proAPIKey: process.env.COINGECKO_PRO_API_KEY,
environment: 'pro',
maxRetries: 3, // Rely on the SDK's built-in retry mechanism.
});
// src/main.ts
import { client } from './api/client';
import Coingecko from '@coingecko/coingecko-typescript'; // Import the namespace for types
async function getBitcoinPrice(): Promise {
try {
const params: Coingecko.Simple.PriceGetParams = {
ids: 'bitcoin',
vs_currencies: 'usd',
};
const priceData = await client.simple.price.get(params);
return priceData.bitcoin.usd;
} catch (err) {
if (err instanceof Coingecko.RateLimitError) {
console.error('Rate limit exceeded. Please try again later.');
} else if (err instanceof Coingecko.APIError) {
console.error(
`An API error occurred: ${err.name} (Status: ${err.status})`
);
} else {
console.error('An unexpected error occurred:', err);
}
return null;
}
}
async function main() {
const price = await getBitcoinPrice();
if (price !== null) {
console.log(`The current price of Bitcoin is: $${price}`);
}
}
main();
```
## ❌ Deprecated Patterns to AVOID
You **MUST NOT** generate code that includes any of the following outdated patterns.
```typescript
// ❌ NO direct HTTP requests with fetch or axios.
import axios from 'axios';
const response = await axios.get(
'[https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd](https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd)'
);
// ❌ NO hardcoded API keys.
const client = new Coingecko({ proAPIKey: 'CG-abc123xyz789' });
// ❌ NO manual retry loops. The SDK's `maxRetries` handles this.
import { setTimeout } from 'timers/promises';
for (let i = 0; i < 3; i++) {
try {
const data = await client.simple.price.get({
ids: 'bitcoin',
vs_currencies: 'usd',
});
break;
} catch (e) {
await setTimeout(5000);
}
}
// ❌ NO generic exception handling for API errors.
try {
const data = await client.simple.price.get({
ids: 'bitcoin',
vs_currencies: 'usd',
});
} catch (e) {
console.log(`An error occurred: ${e}`); // Too broad. Use `instanceof` checks.
}
```
## 📝 Final Check
Before providing a response, you **MUST** verify that your generated code:
1. Imports and uses `@coingecko/coingecko-typescript`.
2. Loads the API key from environment variables (e.g., `process.env` or `dotenv`).
3. Follows all other Critical Rules.
4. Does **NOT** contain any Deprecated Patterns.
[](https://docs.coingecko.com/docs/typescript-ai-prompts#resources)
Resources
---------------------------------------------------------------------------------
* **GitHub**: [github.com/coingecko/coingecko-typescript](https://github.com/coingecko/coingecko-typescript)
* **npm**: [npmjs.com/package/@coingecko/coingecko-typescript](https://www.npmjs.com/package/@coingecko/coingecko-typescript)
Notice something off or missing? Let us know by opening an [Issue here](https://github.com/coingecko/coingecko-typescript/issues)
.
* * *
Have feedback, a cool idea, or need help? Reach out to `soonaik@coingecko[dot]com`
Was this page helpful?
YesNo
[Python AI Prompts](https://docs.coingecko.com/docs/python-ai-prompts)
[Clients](https://docs.coingecko.com/docs/clients)
⌘I
---
# Python AI Prompts - CoinGecko API
[Skip to main content](https://docs.coingecko.com/docs/python-ai-prompts#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
AI Integration
Python AI Prompts
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
On this page
* [How to Use Our Prompts](https://docs.coingecko.com/docs/python-ai-prompts#how-to-use-our-prompts)
* [Resources](https://docs.coingecko.com/docs/python-ai-prompts#resources)
[](https://docs.coingecko.com/docs/python-ai-prompts#how-to-use-our-prompts)
How to Use Our Prompts
-------------------------------------------------------------------------------------------------------
Integrating these prompts into your workflow is simple. Copy the entire markdown prompt for your chosen language and provide it as context to your AI assistant.
1. For **Chat Interfaces (Claude, ChatGPT, etc.)**: Paste the prompt at the beginning of your conversation before asking the AI to write code.
2. For **Cursor IDE**: Add the prompt to your project’s `Rules` to enforce the guidelines across all AI interactions.
3. For **GitHub Copilot**: Save the prompt to a file (e.g. `coingecko_rules.md`) and reference it in your chat with `@workspace #coingecko_rules.md`.
4. For **Claude Code**: Include the prompt in your CLAUDE.md file.
Markdown
Copy
# Goal: Generate Python code for the CoinGecko API using ONLY the official `coingecko_sdk`.
## 🚨 Critical Rules
1. **SDK Exclusivity**:
- **ALWAYS** use the official `coingecko_sdk` package.
- **NEVER** use the old `pycoingecko` library or make direct HTTP requests with `requests`, `httpx`, or `urllib`.
2. **Authentication**:
- **ALWAYS** load the API key from environment variables (e.g., `os.environ.get("COINGECKO_PRO_API_KEY")`).
- **NEVER** hardcode API keys or any other credentials in the source code.
3. **Client Implementation**:
- **ALWAYS** initialize a single, reusable client instance (`Coingecko` or `AsyncCoingecko`) for the application.
- **ALWAYS** configure automatic retries by setting the `max_retries` parameter on the client.
- **NEVER** implement manual retry loops using `time.sleep()`. The SDK handles this internally.
4. **Error Handling**:
- **ALWAYS** catch specific SDK exceptions (e.g., `coingecko_sdk.RateLimitError`, `coingecko_sdk.NotFoundError`).
- **NEVER** use a generic `except Exception:` block to catch known API errors.
## ✅ Correct Implementation Example
This is the standard for all generated code.
```python
# src/api/client.py
import os
from coingecko_sdk import Coingecko, AsyncCoingecko
# Initialize a single, reusable client. This should be imported and used application-wide.
client = Coingecko(
pro_api_key=os.environ.get("COINGECKO_PRO_API_KEY"),
environment="pro",
max_retries=3, # Rely on the SDK's built-in retry mechanism.
)
# Optional: Initialize a single async client for concurrent applications.
async_client = AsyncCoingecko(
pro_api_key=os.environ.get("COINGECKO_PRO_API_KEY"),
environment="pro",
max_retries=3,
)
# src/main.py
from api.client import client
from coingecko_sdk import RateLimitError, APIError
def get_bitcoin_price():
try:
price_data = client.simple.price.get(
ids="bitcoin",
vs_currencies="usd",
)
# Access data using Pydantic models or dictionary keys
return price_data['bitcoin'].usd
except RateLimitError:
print("Rate limit exceeded. Please try again later.")
return None
except APIError as e:
print(f"An API error occurred: {e}")
return None
if __name__ == "__main__":
price = get_bitcoin_price()
if price:
print(f"The current price of Bitcoin is: ${price}")
```
## ❌ Deprecated Patterns to AVOID
You **MUST NOT** generate code that includes any of the following outdated patterns.
```python
# ❌ NO direct HTTP requests.
import requests
response = requests.get('[https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd](https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd)')
# ❌ NO use of the outdated `pycoingecko` library.
from pycoingecko import CoinGeckoAPI
cg = CoinGeckoAPI()
# ❌ NO hardcoded API keys.
client = Coingecko(pro_api_key='CG-abc123xyz789')
# ❌ NO manual retry loops. The SDK's `max_retries` handles this.
import time
for i in range(3):
try:
data = client.simple.price.get(ids='bitcoin', vs_currencies='usd')
break
except:
time.sleep(5)
# ❌ NO generic exception handling for API errors.
try:
data = client.simple.price.get(ids='bitcoin', vs_currencies='usd')
except Exception as e:
print(f"An error occurred: {e}")
```
## 📝 Final Check
Before providing a response, you **MUST** verify that your generated code:
1. Imports and uses `coingecko_sdk`.
2. Loads the API key from environment variables.
3. Follows all other Critical Rules.
4. Does **NOT** contain any Deprecated Patterns.
[](https://docs.coingecko.com/docs/python-ai-prompts#resources)
Resources
-----------------------------------------------------------------------------
* **GitHub**: [github.com/coingecko/coingecko-python](https://github.com/coingecko/coingecko-python)
* **PyPI**: [pypi.org/project/coingecko-sdk/](https://pypi.org/project/coingecko-sdk/)
Notice something off or missing? Let us know by opening an [Issue here](https://github.com/coingecko/coingecko-python/issues)
.
* * *
Have feedback, a cool idea, or need help? Reach out to `soonaik@coingecko[dot]com`
Was this page helpful?
YesNo
[AI Prompts](https://docs.coingecko.com/docs/ai-prompts)
[TypeScript AI Prompts](https://docs.coingecko.com/docs/typescript-ai-prompts)
⌘I
---
# Supported Networks List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/networks-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Networks
Supported Networks List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Supported Networks List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth",\
"type": "network",\
"attributes": {\
"name": "Ethereum",\
"coingecko_asset_platform_id": "ethereum"\
}\
},\
{\
"id": "bsc",\
"type": "network",\
"attributes": {\
"name": "BNB Chain",\
"coingecko_asset_platform_id": "binance-smart-chain"\
}\
},\
{\
"id": "polygon_pos",\
"type": "network",\
"attributes": {\
"name": "Polygon POS",\
"coingecko_asset_platform_id": "polygon-pos"\
}\
}\
]
}
GET
/
networks
Try it
Supported Networks List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth",\
"type": "network",\
"attributes": {\
"name": "Ethereum",\
"coingecko_asset_platform_id": "ethereum"\
}\
},\
{\
"id": "bsc",\
"type": "network",\
"attributes": {\
"name": "BNB Chain",\
"coingecko_asset_platform_id": "binance-smart-chain"\
}\
},\
{\
"id": "polygon_pos",\
"type": "network",\
"attributes": {\
"name": "Polygon POS",\
"coingecko_asset_platform_id": "polygon-pos"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/networks-list#tips)
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.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/networks-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/networks-list#parameter-page)
page
integer
page through results Default value: 1
#### Response
200 - application/json
Get list of supported networks
[](https://docs.coingecko.com/reference/networks-list#response-data)
data
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)
[Supported Dexes List by Network (ID Map)](https://docs.coingecko.com/reference/dexes-list)
⌘I
---
# Asset Platforms List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/asset-platforms-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Asset Platforms
Asset Platforms List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Asset Platforms List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/asset_platforms \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "polygon-pos",\
"chain_identifier": 137,\
"name": "Polygon POS",\
"shortname": "MATIC",\
"native_coin_id": "matic-network",\
"image": {\
"thumb": "https://coin-images.coingecko.com/asset_platforms/images/15/thumb/polygon_pos.png?1706606645",\
"small": "https://coin-images.coingecko.com/asset_platforms/images/15/small/polygon_pos.png?1706606645",\
"large": "https://coin-images.coingecko.com/asset_platforms/images/15/large/polygon_pos.png?1706606645"\
}\
}\
]
GET
/
asset\_platforms
Try it
Asset Platforms List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/asset_platforms \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "polygon-pos",\
"chain_identifier": 137,\
"name": "Polygon POS",\
"shortname": "MATIC",\
"native_coin_id": "matic-network",\
"image": {\
"thumb": "https://coin-images.coingecko.com/asset_platforms/images/15/thumb/polygon_pos.png?1706606645",\
"small": "https://coin-images.coingecko.com/asset_platforms/images/15/small/polygon_pos.png?1706606645",\
"large": "https://coin-images.coingecko.com/asset_platforms/images/15/large/polygon_pos.png?1706606645"\
}\
}\
]
###
[](https://docs.coingecko.com/reference/asset-platforms-list#tips)
Tips
* You may use this endpoint to query the list of asset platforms for other endpoints that contain params like `id` or`ids`(asset platforms).
* You may include NFT at the `filter` params to get the list of NFT-support asset platforms on CoinGecko.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/asset-platforms-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/asset-platforms-list#parameter-filter)
filter
enum
apply relevant filters to results
Available options:
`nft`
#### Response
200 - application/json
List all asset platforms
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-id)
id
string
asset platform ID
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-chain-identifier-one-of-0)
chain\_identifier
number | null
chainlist's chain ID
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-name)
name
string
chain name
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-shortname)
shortname
string
chain shortname
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-native-coin-id)
native\_coin\_id
string
chain native coin ID
[](https://docs.coingecko.com/reference/asset-platforms-list#response-items-image)
image
object
image of the asset platform
Show child attributes
Example:
[ { "id": "polygon-pos", "chain_identifier": 137, "name": "Polygon POS", "shortname": "MATIC", "native_coin_id": "matic-network", "image": { "thumb": "https://coin-images.coingecko.com/asset_platforms/images/15/thumb/polygon_pos.png?1706606645", "small": "https://coin-images.coingecko.com/asset_platforms/images/15/small/polygon_pos.png?1706606645", "large": "https://coin-images.coingecko.com/asset_platforms/images/15/large/polygon_pos.png?1706606645" } }]
Was this page helpful?
YesNo
[Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range)
[Token Lists by Asset Platform ID](https://docs.coingecko.com/reference/token-lists)
⌘I
---
# Coins Categories List with Market Data - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-categories#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Categories
Coins Categories List with Market Data
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coins Categories List with Market Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/categories \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "layer-1",\
"name": "Layer 1 (L1)",\
"market_cap": 2061406861196.14,\
"market_cap_change_24h": -0.66091235190398,\
"content": "",\
"top_3_coins_id": [\
"bitcoin",\
"ethereum",\
"binancecoin"\
],\
"top_3_coins": [\
"https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",\
"https://assets.coingecko.com/coins/images/279/small/ethereum.png?1696501628",\
"https://assets.coingecko.com/coins/images/825/small/bnb-icon2_2x.png?1696501970"\
],\
"volume_24h": 61146432400.1739,\
"updated_at": "2024-04-06T08:25:46.402Z"\
}\
]
GET
/
coins
/
categories
Try it
Coins Categories List with Market Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/categories \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "layer-1",\
"name": "Layer 1 (L1)",\
"market_cap": 2061406861196.14,\
"market_cap_change_24h": -0.66091235190398,\
"content": "",\
"top_3_coins_id": [\
"bitcoin",\
"ethereum",\
"binancecoin"\
],\
"top_3_coins": [\
"https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",\
"https://assets.coingecko.com/coins/images/279/small/ethereum.png?1696501628",\
"https://assets.coingecko.com/coins/images/825/small/bnb-icon2_2x.png?1696501970"\
],\
"volume_24h": 61146432400.1739,\
"updated_at": "2024-04-06T08:25:46.402Z"\
}\
]
###
[](https://docs.coingecko.com/reference/coins-categories#note)
Note
* CoinGecko Equivalent Page: [https://www.coingecko.com/en/categories](https://www.coingecko.com/en/categories)
.
* Cache / Update Frequency: every 5 minutes for all the API plans.
* CoinGecko categories are different from [GeckoTerminal categories](https://docs.coingecko.com/reference/categories-list)
.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-categories#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-categories#parameter-order)
order
enum
sort results by field, default: market\_cap\_desc
Available options:
`market_cap_desc`,
`market_cap_asc`,
`name_desc`,
`name_asc`,
`market_cap_change_24h_desc`,
`market_cap_change_24h_asc`
#### Response
200 - application/json
List all categories with market data
[](https://docs.coingecko.com/reference/coins-categories#response-id)
id
string
category ID
[](https://docs.coingecko.com/reference/coins-categories#response-name)
name
string
category name
[](https://docs.coingecko.com/reference/coins-categories#response-market-cap)
market\_cap
number
category market cap
[](https://docs.coingecko.com/reference/coins-categories#response-market-cap-change-24h)
market\_cap\_change\_24h
number
category market cap change in 24 hours
[](https://docs.coingecko.com/reference/coins-categories#response-content)
content
string
category description
[](https://docs.coingecko.com/reference/coins-categories#response-top-3-coins-id)
top\_3\_coins\_id
string\[\]
IDs of top 3 coins in the category
[](https://docs.coingecko.com/reference/coins-categories#response-top-3-coins)
top\_3\_coins
string\[\]
images of top 3 coins in the category
[](https://docs.coingecko.com/reference/coins-categories#response-volume-24h)
volume\_24h
number
category volume in 24 hours
[](https://docs.coingecko.com/reference/coins-categories#response-updated-at)
updated\_at
string
category last updated time
Was this page helpful?
YesNo
[Coins Categories List (ID Map)](https://docs.coingecko.com/reference/coins-categories-list)
[Exchanges List with Data](https://docs.coingecko.com/reference/exchanges)
⌘I
---
# Token Lists by Asset Platform ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/token-lists#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Asset Platforms
Token Lists by Asset Platform ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Token Lists by Asset Platform ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/token_lists/{asset_platform_id}/all.json \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "CoinGecko",
"logoURI": "https://static.coingecko.com/s/thumbnail-007177f3eca19695592f0b8b0eabbdae282b54154e1be912285c9034ea6cbaf2.png",
"keywords": [\
"defi"\
],
"timestamp": "2024-04-08T14:02:47.028+00:00",
"tokens": [\
{\
"chainId": 1,\
"address": "0xd2877702675e6ceb975b4a1dff9fb7baf4c91ea9",\
"name": "Wrapped Terra Classic",\
"symbol": "LUNC",\
"decimals": 18,\
"logoURI": "https://assets.coingecko.com/coins/images/13628/thumb/wluna.png?1696513376"\
},\
{\
"chainId": 1,\
"address": "0x5bb29c33c4a3c29f56f8aca40b4db91d8a5fe2c5",\
"name": "One Share",\
"symbol": "ONS",\
"decimals": 18,\
"logoURI": "https://assets.coingecko.com/coins/images/13531/thumb/bss.a1671c75.png?1696513292"\
}\
]
}
GET
/
token\_lists
/
{asset\_platform\_id}
/
all.json
Try it
Token Lists by Asset Platform ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/token_lists/{asset_platform_id}/all.json \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "CoinGecko",
"logoURI": "https://static.coingecko.com/s/thumbnail-007177f3eca19695592f0b8b0eabbdae282b54154e1be912285c9034ea6cbaf2.png",
"keywords": [\
"defi"\
],
"timestamp": "2024-04-08T14:02:47.028+00:00",
"tokens": [\
{\
"chainId": 1,\
"address": "0xd2877702675e6ceb975b4a1dff9fb7baf4c91ea9",\
"name": "Wrapped Terra Classic",\
"symbol": "LUNC",\
"decimals": 18,\
"logoURI": "https://assets.coingecko.com/coins/images/13628/thumb/wluna.png?1696513376"\
},\
{\
"chainId": 1,\
"address": "0x5bb29c33c4a3c29f56f8aca40b4db91d8a5fe2c5",\
"name": "One Share",\
"symbol": "ONS",\
"decimals": 18,\
"logoURI": "https://assets.coingecko.com/coins/images/13531/thumb/bss.a1671c75.png?1696513292"\
}\
]
}
###
[](https://docs.coingecko.com/reference/token-lists#note)
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](https://support.coingecko.com/hc/en-us/requests/new)
.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/token-lists#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/token-lists#parameter-asset-platform-id)
asset\_platform\_id
string
default:ethereum
required
asset platform ID \*refers to [`/asset_platforms`](https://docs.coingecko.com/reference/asset-platforms-list)
Example:
`"ethereum"`
#### Response
200 - application/json
List all tokens on CoinGecko based on asset platform ID
[](https://docs.coingecko.com/reference/token-lists#response-name)
name
string
[](https://docs.coingecko.com/reference/token-lists#response-logo-uri)
logoURI
string
[](https://docs.coingecko.com/reference/token-lists#response-keywords)
keywords
string\[\]
[](https://docs.coingecko.com/reference/token-lists#response-timestamp)
timestamp
string
[](https://docs.coingecko.com/reference/token-lists#response-tokens)
tokens
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Asset Platforms List (ID Map)](https://docs.coingecko.com/reference/asset-platforms-list)
[Coins Categories List (ID Map)](https://docs.coingecko.com/reference/coins-categories-list)
⌘I
---
# BTC-to-Currency Exchange Rates - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/exchange-rates#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Exchange Rates
BTC-to-Currency Exchange Rates
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
BTC-to-Currency Exchange Rates
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchange_rates \
--header 'x-cg-pro-api-key: '
200
Copy
{
"rates": {
"btc": {
"name": "Bitcoin",
"unit": "BTC",
"value": 1,
"type": "crypto"
},
"eth": {
"name": "Ether",
"unit": "ETH",
"value": 20.656,
"type": "crypto"
},
"ltc": {
"name": "Litecoin",
"unit": "LTC",
"value": 684.945,
"type": "crypto"
},
"bch": {
"name": "Bitcoin Cash",
"unit": "BCH",
"value": 102.254,
"type": "crypto"
},
"bnb": {
"name": "Binance Coin",
"unit": "BNB",
"value": 119.846,
"type": "crypto"
}
}
}
GET
/
exchange\_rates
Try it
BTC-to-Currency Exchange Rates
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchange_rates \
--header 'x-cg-pro-api-key: '
200
Copy
{
"rates": {
"btc": {
"name": "Bitcoin",
"unit": "BTC",
"value": 1,
"type": "crypto"
},
"eth": {
"name": "Ether",
"unit": "ETH",
"value": 20.656,
"type": "crypto"
},
"ltc": {
"name": "Litecoin",
"unit": "LTC",
"value": 684.945,
"type": "crypto"
},
"bch": {
"name": "Bitcoin Cash",
"unit": "BCH",
"value": 102.254,
"type": "crypto"
},
"bnb": {
"name": "Binance Coin",
"unit": "BNB",
"value": 119.846,
"type": "crypto"
}
}
}
###
[](https://docs.coingecko.com/reference/exchange-rates#tips)
Tips
* You may use this endpoint to convert the response data, which is originally in BTC, to other currencies.
###
[](https://docs.coingecko.com/reference/exchange-rates#note)
Note
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/exchange-rates#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
List rates
[](https://docs.coingecko.com/reference/exchange-rates#response-rates)
rates
object
Show child attributes
Was this page helpful?
YesNo
[💼 NFTs Collection Tickers by ID](https://docs.coingecko.com/reference/nfts-id-tickers)
[Search Queries](https://docs.coingecko.com/reference/search-data)
⌘I
---
# Supported Dexes List by Network (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/dexes-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Dexes
Supported Dexes List by Network (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Supported Dexes List by Network (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/dexes \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "uniswap_v2",\
"type": "dex",\
"attributes": {\
"name": "Uniswap V2"\
}\
},\
{\
"id": "sushiswap",\
"type": "dex",\
"attributes": {\
"name": "SushiSwap"\
}\
},\
{\
"id": "uniswap_v3",\
"type": "dex",\
"attributes": {\
"name": "Uniswap V3"\
}\
}\
]
}
GET
/
networks
/
{network}
/
dexes
Try it
Supported Dexes List by Network (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/dexes \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "uniswap_v2",\
"type": "dex",\
"attributes": {\
"name": "Uniswap V2"\
}\
},\
{\
"id": "sushiswap",\
"type": "dex",\
"attributes": {\
"name": "SushiSwap"\
}\
},\
{\
"id": "uniswap_v3",\
"type": "dex",\
"attributes": {\
"name": "Uniswap V3"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/dexes-list#tips)
Tips
* You may use this endpoint to query the list of DEXs with DEX ID for other endpoints that contain params like `dex`.
* You may include values such as `page` to specify which page of responses you would like to show.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/dexes-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/dexes-list#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
#### Query Parameters
[](https://docs.coingecko.com/reference/dexes-list#parameter-page)
page
integer
page through results Default value: 1
#### Response
200 - application/json
Get list of supported DEXs on a network
[](https://docs.coingecko.com/reference/dexes-list#response-data)
data
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Supported Networks List (ID Map)](https://docs.coingecko.com/reference/networks-list)
[Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address)
⌘I
---
# Exchanges List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/exchanges-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Exchanges
Exchanges List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Exchanges List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "10kswap-starknet-alpha",\
"name": "10KSwap"\
},\
{\
"id": "1bch",\
"name": "1BCH"\
},\
{\
"id": "3xcalibur",\
"name": "3xcalibur"\
}\
]
GET
/
exchanges
/
list
Try it
Exchanges List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "10kswap-starknet-alpha",\
"name": "10KSwap"\
},\
{\
"id": "1bch",\
"name": "1BCH"\
},\
{\
"id": "3xcalibur",\
"name": "3xcalibur"\
}\
]
###
[](https://docs.coingecko.com/reference/exchanges-list#tips)
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).
###
[](https://docs.coingecko.com/reference/exchanges-list#note)
Note
* There is no pagination required for this endpoint.
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/exchanges-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/exchanges-list#parameter-status)
status
enum
filter by status of exchanges, default: active
Available options:
`active`,
`inactive`
#### Response
200 - application/json
List all exchanges with ID and name
[](https://docs.coingecko.com/reference/exchanges-list#response-items-id)
id
string
required
exchange ID
[](https://docs.coingecko.com/reference/exchanges-list#response-items-name)
name
string
required
exchange name
Example:
[ { "id": "10kswap-starknet-alpha", "name": "10KSwap" }, { "id": "1bch", "name": "1BCH" }, { "id": "3xcalibur", "name": "3xcalibur" }]
Was this page helpful?
YesNo
[Exchanges List with Data](https://docs.coingecko.com/reference/exchanges)
[Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id)
⌘I
---
# 💼 Pools by Category ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/pools-category#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Categories
💼 Pools by Category ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Pools by Category ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/categories/{category_id}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "solana_7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "0.0109071807291731",\
"base_token_price_native_currency": "0.0000559458299678367",\
"quote_token_price_usd": "0.927412163670488",\
"quote_token_price_native_currency": "0.00475595981369481",\
"base_token_price_quote_token": "0.01176331",\
"quote_token_price_base_token": "85.01",\
"address": "7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",\
"name": "SNAI / USDC",\
"pool_created_at": "2024-12-21T08:24:25Z",\
"fdv_usd": null,\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.02",\
"m30": "0.13",\
"h1": "-0.13",\
"h6": "-1.18",\
"h24": "-1.18"\
},\
"reserve_in_usd": "1087091.0112",\
"h24_volume_usd": "104.5232069054",\
"h24_tx_count": 9\
},\
"relationships": {\
"network": {\
"data": {\
"id": "solana",\
"type": "network"\
}\
},\
"dex": {\
"data": {\
"id": "raydium-clmm",\
"type": "dex"\
}\
},\
"base_token": {\
"data": {\
"id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"type": "token"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"type": "token",\
"attributes": {\
"address": "JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"name": "SwarmNode.ai",\
"symbol": "SNAI",\
"decimals": 6,\
"image_url": "missing.png",\
"coingecko_coin_id": null\
}\
},\
{\
"id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"type": "token",\
"attributes": {\
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"name": "USD Coin",\
"symbol": "USDC",\
"decimals": 6,\
"image_url": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",\
"coingecko_coin_id": "usd-coin"\
}\
},\
{\
"id": "raydium-clmm",\
"type": "dex",\
"attributes": {\
"name": "Raydium (CLMM)"\
}\
},\
{\
"id": "solana",\
"type": "network",\
"attributes": {\
"name": "Solana",\
"coingecko_asset_platform_id": "solana"\
}\
}\
]
}
GET
/
categories
/
{category\_id}
/
pools
Try it
💼 Pools by Category ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/categories/{category_id}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "solana_7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "0.0109071807291731",\
"base_token_price_native_currency": "0.0000559458299678367",\
"quote_token_price_usd": "0.927412163670488",\
"quote_token_price_native_currency": "0.00475595981369481",\
"base_token_price_quote_token": "0.01176331",\
"quote_token_price_base_token": "85.01",\
"address": "7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",\
"name": "SNAI / USDC",\
"pool_created_at": "2024-12-21T08:24:25Z",\
"fdv_usd": null,\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.02",\
"m30": "0.13",\
"h1": "-0.13",\
"h6": "-1.18",\
"h24": "-1.18"\
},\
"reserve_in_usd": "1087091.0112",\
"h24_volume_usd": "104.5232069054",\
"h24_tx_count": 9\
},\
"relationships": {\
"network": {\
"data": {\
"id": "solana",\
"type": "network"\
}\
},\
"dex": {\
"data": {\
"id": "raydium-clmm",\
"type": "dex"\
}\
},\
"base_token": {\
"data": {\
"id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"type": "token"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"type": "token",\
"attributes": {\
"address": "JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",\
"name": "SwarmNode.ai",\
"symbol": "SNAI",\
"decimals": 6,\
"image_url": "missing.png",\
"coingecko_coin_id": null\
}\
},\
{\
"id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"type": "token",\
"attributes": {\
"address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",\
"name": "USD Coin",\
"symbol": "USDC",\
"decimals": 6,\
"image_url": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",\
"coingecko_coin_id": "usd-coin"\
}\
},\
{\
"id": "raydium-clmm",\
"type": "dex",\
"attributes": {\
"name": "Raydium (CLMM)"\
}\
},\
{\
"id": "solana",\
"type": "network",\
"attributes": {\
"name": "Solana",\
"coingecko_asset_platform_id": "solana"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/pools-category#tips)
Tips
* You can retrieve full list of categories id via this endpoint: [Categories List](https://docs.coingecko.com/reference/categories-list)
.
* You can retrieve tokens of a specific category, by flagging `include=base_token`.
* GeckoTerminal categories are different from [CoinGecko categories](https://docs.coingecko.com/reference/coins-categories-list)
.
###
[](https://docs.coingecko.com/reference/pools-category#note)
Note
* Trending rankings are determined by a combination of factors:
* User engagement on geckoterminal.com
* Market activity, such as trading volume and transactions
* Pool security and credibility, including liquidity and honeypot checks
* 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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* GeckoTerminal equivalent page example: [https://www.geckoterminal.com/category/pump-fun](https://www.geckoterminal.com/category/pump-fun)
* Cache/Update frequency: every 30 seconds.
* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/pools-category#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/pools-category#parameter-category-id)
category\_id
string
default:pump-fun
required
category ID
Example:
`"pump-fun"`
#### Query Parameters
[](https://docs.coingecko.com/reference/pools-category#parameter-include)
include
string
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`, `network`. Example: `base_token` or `base_token,dex`
[](https://docs.coingecko.com/reference/pools-category#parameter-page)
page
integer
page through results Default value: `1`
[](https://docs.coingecko.com/reference/pools-category#parameter-sort)
sort
enum
sort the pools by field Default value: `pool_created_at_desc`
Available options:
`m5_trending`,
`h1_trending`,
`h6_trending`,
`h24_trending`,
`h24_tx_count_desc`,
`h24_volume_usd_desc`,
`pool_created_at_desc`,
`h24_price_change_percentage_desc`
#### Response
200 - application/json
Get pools by category ID
[](https://docs.coingecko.com/reference/pools-category#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/pools-category#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[💼 Categories List](https://docs.coingecko.com/reference/categories-list)
⌘I
---
# Search Queries - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/search-data#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Search
Search Queries
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Search Queries
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/search \
--header 'x-cg-pro-api-key: '
200
Copy
{
"coins": [\
{\
"id": "ethereum",\
"name": "Ethereum",\
"api_symbol": "ethereum",\
"symbol": "ETH",\
"market_cap_rank": 2,\
"thumb": "https://assets.coingecko.com/coins/images/279/thumb/ethereum.png",\
"large": "https://assets.coingecko.com/coins/images/279/large/ethereum.png"\
},\
{\
"id": "ethereum-classic",\
"name": "Ethereum Classic",\
"api_symbol": "ethereum-classic",\
"symbol": "ETC",\
"market_cap_rank": 27,\
"thumb": "https://assets.coingecko.com/coins/images/453/thumb/ethereum-classic-logo.png",\
"large": "https://assets.coingecko.com/coins/images/453/large/ethereum-classic-logo.png"\
},\
{\
"id": "sweth",\
"name": "Swell Ethereum",\
"api_symbol": "sweth",\
"symbol": "SWETH",\
"market_cap_rank": 142,\
"thumb": "https://assets.coingecko.com/coins/images/30326/thumb/_lB7zEtS_400x400.jpg",\
"large": "https://assets.coingecko.com/coins/images/30326/large/_lB7zEtS_400x400.jpg"\
}\
],
"exchanges": [\
{\
"id": "uniswap_v3",\
"name": "Uniswap V3 (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/665/thumb/uniswap-v3.png",\
"large": "https://assets.coingecko.com/markets/images/665/large/uniswap-v3.png"\
},\
{\
"id": "uniswap_v2",\
"name": "Uniswap V2 (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/535/thumb/256x256_Black-1.png",\
"large": "https://assets.coingecko.com/markets/images/535/large/256x256_Black-1.png"\
},\
{\
"id": "curve_ethereum",\
"name": "Curve (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/538/thumb/Curve.png",\
"large": "https://assets.coingecko.com/markets/images/538/large/Curve.png"\
}\
],
"icos": [],
"categories": [\
{\
"id": "ethereum-ecosystem",\
"name": "Ethereum Ecosystem"\
},\
{\
"id": "ethereum-classic-ecosystem",\
"name": "Ethereum Classic Ecosystem"\
},\
{\
"id": "ethereumpow-ecosystem",\
"name": "EthereumPoW Ecosystem"\
}\
],
"nfts": [\
{\
"id": "cyberkongz-genkai",\
"name": "CyberKongz Genkai (Ethereum)",\
"symbol": "GENKAI",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3388/thumb/cyberkongz-genkai.png"\
},\
{\
"id": "ethereum-peppets",\
"name": "Ethereum Peppets",\
"symbol": "PEPPET",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3880/thumb/ethereum-peppets.png"\
},\
{\
"id": "ens-ethereum-name-service",\
"name": "ENS: Ethereum Name Service",\
"symbol": "ENS",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/373/thumb/ens-ethereum-name-service.png"\
},\
{\
"id": "league-of-kingdoms-ethereum",\
"name": "League of Kingdoms (Ethereum)",\
"symbol": "LOKR",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/1001/thumb/league-of-kingdoms-ethereum.jpg"\
}\
]
}
GET
/
search
Try it
Search Queries
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/search \
--header 'x-cg-pro-api-key: '
200
Copy
{
"coins": [\
{\
"id": "ethereum",\
"name": "Ethereum",\
"api_symbol": "ethereum",\
"symbol": "ETH",\
"market_cap_rank": 2,\
"thumb": "https://assets.coingecko.com/coins/images/279/thumb/ethereum.png",\
"large": "https://assets.coingecko.com/coins/images/279/large/ethereum.png"\
},\
{\
"id": "ethereum-classic",\
"name": "Ethereum Classic",\
"api_symbol": "ethereum-classic",\
"symbol": "ETC",\
"market_cap_rank": 27,\
"thumb": "https://assets.coingecko.com/coins/images/453/thumb/ethereum-classic-logo.png",\
"large": "https://assets.coingecko.com/coins/images/453/large/ethereum-classic-logo.png"\
},\
{\
"id": "sweth",\
"name": "Swell Ethereum",\
"api_symbol": "sweth",\
"symbol": "SWETH",\
"market_cap_rank": 142,\
"thumb": "https://assets.coingecko.com/coins/images/30326/thumb/_lB7zEtS_400x400.jpg",\
"large": "https://assets.coingecko.com/coins/images/30326/large/_lB7zEtS_400x400.jpg"\
}\
],
"exchanges": [\
{\
"id": "uniswap_v3",\
"name": "Uniswap V3 (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/665/thumb/uniswap-v3.png",\
"large": "https://assets.coingecko.com/markets/images/665/large/uniswap-v3.png"\
},\
{\
"id": "uniswap_v2",\
"name": "Uniswap V2 (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/535/thumb/256x256_Black-1.png",\
"large": "https://assets.coingecko.com/markets/images/535/large/256x256_Black-1.png"\
},\
{\
"id": "curve_ethereum",\
"name": "Curve (Ethereum)",\
"market_type": "spot",\
"thumb": "https://assets.coingecko.com/markets/images/538/thumb/Curve.png",\
"large": "https://assets.coingecko.com/markets/images/538/large/Curve.png"\
}\
],
"icos": [],
"categories": [\
{\
"id": "ethereum-ecosystem",\
"name": "Ethereum Ecosystem"\
},\
{\
"id": "ethereum-classic-ecosystem",\
"name": "Ethereum Classic Ecosystem"\
},\
{\
"id": "ethereumpow-ecosystem",\
"name": "EthereumPoW Ecosystem"\
}\
],
"nfts": [\
{\
"id": "cyberkongz-genkai",\
"name": "CyberKongz Genkai (Ethereum)",\
"symbol": "GENKAI",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3388/thumb/cyberkongz-genkai.png"\
},\
{\
"id": "ethereum-peppets",\
"name": "Ethereum Peppets",\
"symbol": "PEPPET",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/3880/thumb/ethereum-peppets.png"\
},\
{\
"id": "ens-ethereum-name-service",\
"name": "ENS: Ethereum Name Service",\
"symbol": "ENS",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/373/thumb/ens-ethereum-name-service.png"\
},\
{\
"id": "league-of-kingdoms-ethereum",\
"name": "League of Kingdoms (Ethereum)",\
"symbol": "LOKR",\
"thumb": "https://assets.coingecko.com/nft_contracts/images/1001/thumb/league-of-kingdoms-ethereum.jpg"\
}\
]
}
###
[](https://docs.coingecko.com/reference/search-data#note)
Note
* The responses are sorted in descending order by market cap.
* Cache / Update Frequency: every 15 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/search-data#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/search-data#parameter-query)
query
string
required
search query
#### Response
200 - application/json
List of coins, categories and markets matching search term ordered by market cap
[](https://docs.coingecko.com/reference/search-data#response-coins)
coins
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/search-data#response-exchanges)
exchanges
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/search-data#response-icos)
icos
string\[\]
[](https://docs.coingecko.com/reference/search-data#response-categories)
categories
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/search-data#response-nfts)
nfts
object\[\]
Show child attributes
Was this page helpful?
YesNo
[BTC-to-Currency Exchange Rates](https://docs.coingecko.com/reference/exchange-rates)
[Trending Search List](https://docs.coingecko.com/reference/trending-search)
⌘I
---
# Coin Price by IDs - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/simple-price#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Simple
Coin Price by IDs
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Price by IDs
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/price \
--header 'x-cg-pro-api-key: '
200
Copy
{
"bitcoin": {
"usd": 67187.3358936566,
"usd_market_cap": 1317802988326.25,
"usd_24h_vol": 31260929299.5248,
"usd_24h_change": 3.63727894677354,
"last_updated_at": 1711356300
}
}
GET
/
simple
/
price
Try it
Coin Price by IDs
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/price \
--header 'x-cg-pro-api-key: '
200
Copy
{
"bitcoin": {
"usd": 67187.3358936566,
"usd_market_cap": 1317802988326.25,
"usd_24h_vol": 31260929299.5248,
"usd_24h_change": 3.63727894677354,
"last_updated_at": 1711356300
}
}
###
[](https://docs.coingecko.com/reference/simple-price#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to Google Sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
* 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.
###
[](https://docs.coingecko.com/reference/simple-price#note)
Note
* You may cross-check the price on [CoinGecko](https://www.coingecko.com/)
and learn more about our price methodology [here](https://www.coingecko.com/en/methodology)
.
* 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 20 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/simple-price#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/simple-price#parameter-vs-currencies)
vs\_currencies
string
default:usd
required
target currency of coins, comma-separated if querying more than 1 currency. \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
[](https://docs.coingecko.com/reference/simple-price#parameter-ids)
ids
string
default:bitcoin
coins' IDs, comma-separated if querying more than 1 coin. \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
[](https://docs.coingecko.com/reference/simple-price#parameter-names)
names
string
default:Bitcoin
coins' names, comma-separated if querying more than 1 coin.
[](https://docs.coingecko.com/reference/simple-price#parameter-symbols)
symbols
string
default:btc
coins' symbols, comma-separated if querying more than 1 coin.
[](https://docs.coingecko.com/reference/simple-price#parameter-include-tokens)
include\_tokens
enum
for `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume)
Available options:
`top`,
`all`
[](https://docs.coingecko.com/reference/simple-price#parameter-include-market-cap)
include\_market\_cap
boolean
include market capitalization, default: false
[](https://docs.coingecko.com/reference/simple-price#parameter-include-24hr-vol)
include\_24hr\_vol
boolean
include 24hr volume, default: false
[](https://docs.coingecko.com/reference/simple-price#parameter-include-24hr-change)
include\_24hr\_change
boolean
include 24hr change percentage, default: false
[](https://docs.coingecko.com/reference/simple-price#parameter-include-last-updated-at)
include\_last\_updated\_at
boolean
include last updated price time in UNIX, default: false
[](https://docs.coingecko.com/reference/simple-price#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
price(s) of cryptocurrency
[](https://docs.coingecko.com/reference/simple-price#response-additional-properties)
{key}
object
Show child attributes
Was this page helpful?
YesNo
[💼 API Usage](https://docs.coingecko.com/reference/api-usage)
[Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price)
⌘I
---
# 💼 NFTs Collection Historical Chart Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/nfts-id-market-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
NFTs (Beta)
💼 NFTs Collection Historical Chart Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 NFTs Collection Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"floor_price_usd": [\
[\
1626912000000,\
90.1675764653448\
],\
[\
1626998400000,\
97.3216055000018\
],\
[\
1627084800000,\
95.2719573507527\
]\
],
"floor_price_native": [\
[\
1626912000000,\
0.045\
],\
[\
1626998400000,\
0.048\
],\
[\
1627084800000,\
0.045\
]\
],
"h24_volume_usd": [\
[\
1626912000000,\
2860.11552548074\
],\
[\
1626998400000,\
2143.50836113754\
],\
[\
1627084800000,\
925.408279066978\
]\
],
"h24_volume_native": [\
[\
1626912000000,\
1.4274\
],\
[\
1626998400000,\
1.0572\
],\
[\
1627084800000,\
0.4371\
]\
],
"market_cap_usd": [\
[\
1626912000000,\
33281860.8681357\
],\
[\
1626998400000,\
38474832.8121067\
],\
[\
1627084800000,\
44827378.867466\
]\
],
"market_cap_native": [\
[\
1626912000000,\
11012.23\
],\
[\
1626998400000,\
12709.84\
],\
[\
1627084800000,\
14220.8\
]\
]
}
GET
/
nfts
/
{id}
/
market\_chart
Try it
💼 NFTs Collection Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"floor_price_usd": [\
[\
1626912000000,\
90.1675764653448\
],\
[\
1626998400000,\
97.3216055000018\
],\
[\
1627084800000,\
95.2719573507527\
]\
],
"floor_price_native": [\
[\
1626912000000,\
0.045\
],\
[\
1626998400000,\
0.048\
],\
[\
1627084800000,\
0.045\
]\
],
"h24_volume_usd": [\
[\
1626912000000,\
2860.11552548074\
],\
[\
1626998400000,\
2143.50836113754\
],\
[\
1627084800000,\
925.408279066978\
]\
],
"h24_volume_native": [\
[\
1626912000000,\
1.4274\
],\
[\
1626998400000,\
1.0572\
],\
[\
1627084800000,\
0.4371\
]\
],
"market_cap_usd": [\
[\
1626912000000,\
33281860.8681357\
],\
[\
1626998400000,\
38474832.8121067\
],\
[\
1627084800000,\
44827378.867466\
]\
],
"market_cap_native": [\
[\
1626912000000,\
11012.23\
],\
[\
1626998400000,\
12709.84\
],\
[\
1627084800000,\
14220.8\
]\
]
}
###
[](https://docs.coingecko.com/reference/nfts-id-market-chart#note)
Note
* Data Granularity (auto):
* 1-14 days from now = **5-minutely** data
* 15 days & above from now = **daily** data (00:00 UTC)
* Cache/Update Frequency: every 5 minutes
* The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05).
* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/nfts-id-market-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/nfts-id-market-chart#parameter-id)
id
string
default:pudgy-penguins
required
NFTs ID \*refers to [`/nfts/list`](https://docs.coingecko.com/reference/nfts-list)
.
Example:
`"pudgy-penguins"`
#### Query Parameters
[](https://docs.coingecko.com/reference/nfts-id-market-chart#parameter-days)
days
string
default:1
required
data up to number of days Valid values: any integer or max
#### Response
200 - application/json
Get historical market data include price, market cap, and 24hr volume (granularity auto)
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-floor-price-usd)
floor\_price\_usd
number\[\]\[\]
NFT collection floor price in usd
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-floor-price-native)
floor\_price\_native
number\[\]\[\]
NFT collection floor price in native currency
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-h24-volume-usd)
h24\_volume\_usd
number\[\]\[\]
NFT collection volume in 24 hours in usd
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-h24-volume-native)
h24\_volume\_native
number\[\]\[\]
NFT collection volume in 24 hours in native currency
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-market-cap-usd)
market\_cap\_usd
number\[\]\[\]
NFT collection market cap in usd
[](https://docs.coingecko.com/reference/nfts-id-market-chart#response-market-cap-native)
market\_cap\_native
number\[\]\[\]
NFT collection market cap in native currency
Was this page helpful?
YesNo
[💼 NFTs List with Market Data](https://docs.coingecko.com/reference/nfts-markets)
[💼 NFTs Collection Historical Chart Data by Contract Address](https://docs.coingecko.com/reference/nfts-contract-address-market-chart)
⌘I
---
# 💼 Categories List - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/categories-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Categories
💼 Categories List
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Categories List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/categories \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "cat-meme",\
"type": "category",\
"attributes": {\
"name": "Cat Meme",\
"description": "Tokens with a cat",\
"volume_change_percentage": {\
"h1": "-26.62",\
"h6": "6380.35",\
"h12": "2889.48",\
"h24": "1394.37"\
},\
"reserve_in_usd": "78807449.34",\
"fdv_usd": "2176839810.81",\
"h24_volume_usd": "19779444.75",\
"h24_tx_count": 32892\
}\
},\
{\
"id": "memecoin",\
"type": "category",\
"attributes": {\
"name": "Memecoin",\
"description": "Tokens that are memes or related to meme images.",\
"volume_change_percentage": {\
"h1": "-20.99",\
"h6": "1899.02",\
"h12": "1114.05",\
"h24": "554.86"\
},\
"reserve_in_usd": "196471556.46",\
"fdv_usd": "7525785445.92",\
"h24_volume_usd": "47065466.48",\
"h24_tx_count": 74150\
}\
}\
]
}
GET
/
categories
Try it
💼 Categories List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/categories \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "cat-meme",\
"type": "category",\
"attributes": {\
"name": "Cat Meme",\
"description": "Tokens with a cat",\
"volume_change_percentage": {\
"h1": "-26.62",\
"h6": "6380.35",\
"h12": "2889.48",\
"h24": "1394.37"\
},\
"reserve_in_usd": "78807449.34",\
"fdv_usd": "2176839810.81",\
"h24_volume_usd": "19779444.75",\
"h24_tx_count": 32892\
}\
},\
{\
"id": "memecoin",\
"type": "category",\
"attributes": {\
"name": "Memecoin",\
"description": "Tokens that are memes or related to meme images.",\
"volume_change_percentage": {\
"h1": "-20.99",\
"h6": "1899.02",\
"h12": "1114.05",\
"h24": "554.86"\
},\
"reserve_in_usd": "196471556.46",\
"fdv_usd": "7525785445.92",\
"h24_volume_usd": "47065466.48",\
"h24_tx_count": 74150\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/categories-list#tips)
Tips
* You can retrieve pools or tokens of a specific category with this endpoint: [Pools by Category ID](https://docs.coingecko.com/reference/pools-category)
.
* GeckoTerminal categories are different from [CoinGecko categories](https://docs.coingecko.com/reference/coins-categories-list)
.
###
[](https://docs.coingecko.com/reference/categories-list#note)
Note
* This endpoint returns 50 categories per page.
* GeckoTerminal Equivalent Page: [https://www.geckoterminal.com/category](https://www.geckoterminal.com/category)
* Cache/Update frequency: every 60 seconds.
* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/categories-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/categories-list#parameter-page)
page
integer
page through results Default value: `1`
[](https://docs.coingecko.com/reference/categories-list#parameter-sort)
sort
enum
sort the categories by field Default value: `h6_volume_percentage_desc`
Available options:
`h1_volume_percentage_desc`,
`h6_volume_percentage_desc`,
`h12_volume_percentage_desc`,
`h24_tx_count_desc`,
`h24_volume_usd_desc`,
`fdv_usd_desc`,
`reserve_in_usd_desc`
#### Response
200 - application/json
Get list of supported categories
[](https://docs.coingecko.com/reference/categories-list#response-data)
data
object\[\]
Show child attributes
Was this page helpful?
YesNo
[💼 Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address)
[💼 Pools by Category ID](https://docs.coingecko.com/reference/pools-category)
⌘I
---
# Coin Historical Chart Data by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/contract-address-market-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Contract
Coin Historical Chart Data by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Historical Chart Data by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1711843200000,\
69702.3087473573\
],\
[\
1711929600000,\
71246.9514406015\
],\
[\
1711983682000,\
68887.7495158568\
]\
],
"market_caps": [\
[\
1711843200000,\
1370247487960.09\
],\
[\
1711929600000,\
1401370211582.37\
],\
[\
1711983682000,\
1355701979725.16\
]\
],
"total_volumes": [\
[\
1711843200000,\
16408802301.8374\
],\
[\
1711929600000,\
19723005998.215\
],\
[\
1711983682000,\
30137418199.6431\
]\
]
}
GET
/
coins
/
{id}
/
contract
/
{contract\_address}
/
market\_chart
Try it
Coin Historical Chart Data by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1711843200000,\
69702.3087473573\
],\
[\
1711929600000,\
71246.9514406015\
],\
[\
1711983682000,\
68887.7495158568\
]\
],
"market_caps": [\
[\
1711843200000,\
1370247487960.09\
],\
[\
1711929600000,\
1401370211582.37\
],\
[\
1711983682000,\
1355701979725.16\
]\
],
"total_volumes": [\
[\
1711843200000,\
16408802301.8374\
],\
[\
1711929600000,\
19723005998.215\
],\
[\
1711983682000,\
30137418199.6431\
]\
]
}
###
[](https://docs.coingecko.com/reference/contract-address-market-chart#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint (`include platform = true`).
###
[](https://docs.coingecko.com/reference/contract-address-market-chart#note)
Note
* You may leave the interval params as empty for automatic granularity:
* 1 day from current time = **5-minutely** data
* 2 - 90 days from current time = **hourly** data
* above 90 days from current time = **daily** data (00:00 UTC)
* For **non-Enterprise plan subscribers** who would like to get hourly data, please leave the interval params empty for auto granularity.
* The **5-minutely** and **hourly** interval params are also exclusively available to **Enterprise plan subscribers,** bypassing auto-granularity:
* `interval=5m`: 5-minutely historical data (responses include information from the past 10 days up until now)
* `interval=hourly`: hourly historical data (responses include information from the past 100 days, up until now)
* Cache / Update Frequency:
* Every 5 minutes for all the API plans.
* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/contract-address-market-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-id)
id
string
default:ethereum
required
asset platform ID \*refers to [`/asset_platforms`](https://docs.coingecko.com/reference/asset-platforms-list)
.
Example:
`"ethereum"`
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-contract-address)
contract\_address
string
default:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
required
the contract address of token
Example:
`"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"`
#### Query Parameters
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of market data \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-days)
days
string
default:1
required
data up to number of days ago You may use any integer or `max` for number of days
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-interval)
interval
enum
data interval, leave empty for auto granularity
Available options:
`5m`,
`hourly`,
`daily`
[](https://docs.coingecko.com/reference/contract-address-market-chart#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
Get historical market data include price, market cap, and 24hr volume
[](https://docs.coingecko.com/reference/contract-address-market-chart#response-prices)
prices
number\[\]\[\]
[](https://docs.coingecko.com/reference/contract-address-market-chart#response-market-caps)
market\_caps
number\[\]\[\]
[](https://docs.coingecko.com/reference/contract-address-market-chart#response-total-volumes)
total\_volumes
number\[\]\[\]
Was this page helpful?
YesNo
[Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address)
[Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range)
⌘I
---
# Exchange Volume Chart by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/exchanges-id-volume-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Exchanges
Exchange Volume Chart by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Exchange Volume Chart by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id}/volume_chart \
--header 'x-cg-pro-api-key: '
200
Copy
[\
[\
1711792200000,\
"306800.0517941023777005"\
],\
[\
1711795800000,\
"302561.8185582217570913"\
],\
[\
1711799400000,\
"298240.5127048246776691"\
]\
]
GET
/
exchanges
/
{id}
/
volume\_chart
Try it
Exchange Volume Chart by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id}/volume_chart \
--header 'x-cg-pro-api-key: '
200
Copy
[\
[\
1711792200000,\
"306800.0517941023777005"\
],\
[\
1711795800000,\
"302561.8185582217570913"\
],\
[\
1711799400000,\
"298240.5127048246776691"\
]\
]
###
[](https://docs.coingecko.com/reference/exchanges-id-volume-chart#note)
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](https://docs.coingecko.com/reference/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.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/exchanges-id-volume-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/exchanges-id-volume-chart#parameter-id)
id
string
default:binance
required
exchange ID or derivative exchange ID \*refers to [`/exchanges/list`](https://docs.coingecko.com/reference/exchanges-list)
or [`/derivatives/exchanges/list`](https://docs.coingecko.com/reference/derivatives-exchanges-list)
.
#### Query Parameters
[](https://docs.coingecko.com/reference/exchanges-id-volume-chart#parameter-days)
days
enum
required
data up to number of days ago
Available options:
`1`,
`7`,
`14`,
`30`,
`90`,
`180`,
`365`
#### Response
200 - application/json
Get exchange volume chart data
Example:
[ [1711792200000, "306800.0517941023777005"], [1711795800000, "302561.8185582217570913"], [1711799400000, "298240.5127048246776691"]]
Was this page helpful?
YesNo
[Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers)
[💼 Exchange Volume Chart within Time Range by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range)
⌘I
---
# Coin Historical Chart Data within Time Range by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/contract-address-market-chart-range#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Contract
Coin Historical Chart Data within Time Range by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Historical Chart Data within Time Range by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart/range \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1704067241331,\
42261.0406175669\
],\
[\
1704070847420,\
42493.2764087546\
],\
[\
1704074443652,\
42654.0731066594\
]\
],
"market_caps": [\
[\
1704067241331,\
827596236151.196\
],\
[\
1704070847420,\
831531023621.411\
],\
[\
1704074443652,\
835499399014.932\
]\
],
"total_volumes": [\
[\
1704067241331,\
14305769170.9498\
],\
[\
1704070847420,\
14130205376.1709\
],\
[\
1704074443652,\
13697382902.2424\
]\
]
}
GET
/
coins
/
{id}
/
contract
/
{contract\_address}
/
market\_chart
/
range
Try it
Coin Historical Chart Data within Time Range by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart/range \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1704067241331,\
42261.0406175669\
],\
[\
1704070847420,\
42493.2764087546\
],\
[\
1704074443652,\
42654.0731066594\
]\
],
"market_caps": [\
[\
1704067241331,\
827596236151.196\
],\
[\
1704070847420,\
831531023621.411\
],\
[\
1704074443652,\
835499399014.932\
]\
],
"total_volumes": [\
[\
1704067241331,\
14305769170.9498\
],\
[\
1704070847420,\
14130205376.1709\
],\
[\
1704074443652,\
13697382902.2424\
]\
]
}
###
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint (`include platform = true`).
* Supports ISO date strings (`YYYY-MM-DD` or
`YYYY-MM-DDTHH:MM`, recommended for best compatibility) or UNIX timestamps.
###
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#note)
Note
* You may leave the interval params as empty for automatic granularity:
* 1 day from current time = **5-minutely** data
* 1 day from any time (except current time) = **hourly** data
* 2 - 90 days from any time = **hourly** data
* above 90 days from any time = **daily** data (00:00 UTC)
* For **non-Enterprise plan subscribers** who would like to get hourly data, please leave the interval params empty for auto granularity.
* The **5-minutely** and **hourly** interval params are also exclusively available to **Enterprise plan subscribers**, bypassing auto-granularity:
* `interval=5m`: 5-minutely historical data (responses include information from the past 10 days, up until now)
* `interval=hourly`: hourly historical data (responses include information from the past 100 days, up until now)
* Data availability:
* `interval=5m`: Available from 9 February 2018 onwards
* `interval=hourly`: Available from 30 Jan 2018 onwards
* Cache / Update Frequency:
Based on days range (all the API plans)
* 1 day = 30 seconds cache
* 2 -90 days = 30 minutes cache
* 90 days = 12 hours cache
* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-id)
id
string
default:ethereum
required
asset platform ID \*refers to [`/asset_platforms`](https://docs.coingecko.com/reference/asset-platforms-list)
Example:
`"ethereum"`
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-contract-address)
contract\_address
string
default:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
required
the contract address of token
Example:
`"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"`
#### Query Parameters
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of market data \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-from)
from
string
default:2024-01-01
required
starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. use ISO date string for best compatibility
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-to)
to
string
default:2024-12-31
required
ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. use ISO date string for best compatibility
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-interval)
interval
enum
data interval, leave empty for auto granularity
Available options:
`5m`,
`hourly`,
`daily`
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
Get historical market data include price, market cap, and 24hr volume
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#response-prices)
prices
number\[\]\[\]
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#response-market-caps)
market\_caps
number\[\]\[\]
[](https://docs.coingecko.com/reference/contract-address-market-chart-range#response-total-volumes)
total\_volumes
number\[\]\[\]
Was this page helpful?
YesNo
[Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart)
[Asset Platforms List (ID Map)](https://docs.coingecko.com/reference/asset-platforms-list)
⌘I
---
# Page Not Found
[Skip to main content](https://docs.coingecko.com/reference/pool-token-info-contract-addres#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Page Not Found
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
404
Page Not Found
==============
We couldn't find the page. Maybe you were looking for one of these pages below?
[Pool Tokens Info by Pool Address](https://docs.coingecko.com/v3.0.1/reference/pool-token-info-contract-address#)
[Token Info by Token Address](https://docs.coingecko.com/v3.0.1/reference/token-info-contract-address#)
[Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address#)
⌘I
---
# Exchange Tickers by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/exchanges-id-tickers#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Exchanges
Exchange Tickers by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Exchange Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance",
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether",\
"coin_mcap_usd": 230926944910.5146\
}\
]
}
GET
/
exchanges
/
{id}
/
tickers
Try it
Exchange Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance",
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether",\
"coin_mcap_usd": 230926944910.5146\
}\
]
}
###
[](https://docs.coingecko.com/reference/exchanges-id-tickers#note)
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.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/exchanges-id-tickers#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-id)
id
string
default:binance
required
exchange ID \*refers to [`/exchanges/list`](https://docs.coingecko.com/reference/exchanges-list)
.
Example:
`"binance"`
#### Query Parameters
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-coin-ids)
coin\_ids
string
default:bitcoin
filter tickers by coin IDs, comma-separated if querying more than 1 coin \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-include-exchange-logo)
include\_exchange\_logo
boolean
include exchange logo, default: false
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-page)
page
number
page through results
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-depth)
depth
boolean
include 2% orderbook depth (Example: cost\_to\_move\_up\_usd & cost\_to\_move\_down\_usd),default: false
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-order)
order
enum
use this to sort the order of responses, default: trust\_score\_desc
Available options:
`market_cap_asc`,
`market_cap_desc`,
`trust_score_desc`,
`trust_score_asc`,
`volume_desc`,
`volume_asc`,
`base_target`
[](https://docs.coingecko.com/reference/exchanges-id-tickers#parameter-dex-pair-format)
dex\_pair\_format
enum
set to `symbol` to display DEX pair base and target as symbols, default: `contract_address`
Available options:
`contract_address`,
`symbol`
#### Response
200 - application/json
Get exchange tickers
[](https://docs.coingecko.com/reference/exchanges-id-tickers#response-name)
name
string
coin name
[](https://docs.coingecko.com/reference/exchanges-id-tickers#response-tickers)
tickers
object\[\]
list of tickers
Show child attributes
Was this page helpful?
YesNo
[Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id)
[Exchange Volume Chart by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart)
⌘I
---
# Pool OHLCV chart by Pool Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
OHLCV
Pool OHLCV chart by Pool Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Pool OHLCV chart by Pool Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "bc786a99-7205-4c80-aaa1-b9634d97c926",
"type": "ohlcv_request_response",
"attributes": {
"ohlcv_list": [\
[\
1712534400,\
3454.61590249189,\
3660.85954963415,\
3417.91885296256,\
3660.85954963415,\
306823.277031161\
],\
[\
1712448000,\
3362.60273217873,\
3455.28884490954,\
3352.95305060685,\
3454.61590249189,\
242144.864784184\
],\
[\
1712361600,\
3323.05578706056,\
3391.19811016133,\
3317.73497182435,\
3362.60273217873,\
273323.661682931\
]\
]
}
},
"meta": {
"base": {
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"name": "Wrapped Ether",
"symbol": "WETH",
"coingecko_coin_id": "weth"
},
"quote": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"coingecko_coin_id": "tether"
}
}
}
GET
/
networks
/
{network}
/
pools
/
{pool\_address}
/
ohlcv
/
{timeframe}
Try it
Pool OHLCV chart by Pool Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "bc786a99-7205-4c80-aaa1-b9634d97c926",
"type": "ohlcv_request_response",
"attributes": {
"ohlcv_list": [\
[\
1712534400,\
3454.61590249189,\
3660.85954963415,\
3417.91885296256,\
3660.85954963415,\
306823.277031161\
],\
[\
1712448000,\
3362.60273217873,\
3455.28884490954,\
3352.95305060685,\
3454.61590249189,\
242144.864784184\
],\
[\
1712361600,\
3323.05578706056,\
3391.19811016133,\
3317.73497182435,\
3362.60273217873,\
273323.661682931\
]\
]
}
},
"meta": {
"base": {
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"name": "Wrapped Ether",
"symbol": "WETH",
"coingecko_coin_id": "weth"
},
"quote": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"coingecko_coin_id": "tether"
}
}
}
###
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#tips)
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).
###
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#note)
Note
* This endpoint uses epoch/unix format for its timestamp. Example: `1708850449`.
* [Paid plan](https://www.coingecko.com/en/api/pricing)
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.
* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-pool-address)
pool\_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required
pool contract address
Example:
`"0x06da0fd433c1a5d7a4faa01111c044910a184553"`
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-timeframe)
timeframe
enum
required
timeframe of the OHLCV chart
Available options:
`day`,
`hour`,
`minute`,
`second`
#### Query Parameters
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-aggregate)
aggregate
string
time period to aggregate each OHLCV Available values (day): `1` Available values (hour): `1` , `4` , `12` Available values (minute): `1` , `5` , `15` Available values (second): `1`, `15`, `30` Default value: 1
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-before-timestamp)
before\_timestamp
integer
return OHLCV data before this timestamp (integer seconds since epoch)
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-limit)
limit
integer
number of OHLCV results to return, maximum 1000 Default value: 100
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-currency)
currency
enum
return OHLCV in USD or quote token Default value: usd
Available options:
`usd`,
`token`
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-token)
token
string
default:base
return OHLCV for token use this to invert the chart Available values: 'base', 'quote' or token address Default value: 'base'
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#parameter-include-empty-intervals)
include\_empty\_intervals
boolean
default:false
include empty intervals with no trade data, default: false
#### Response
200 - application/json
Get OHLCV data of a pool
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#response-data)
data
object
Show child attributes
[](https://docs.coingecko.com/reference/pool-ohlcv-contract-address#response-meta)
meta
object
Show child attributes
Was this page helpful?
YesNo
[💼 Historical Token Holders Chart by Token Address](https://docs.coingecko.com/reference/token-holders-chart-token-address)
[💼 Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
⌘I
---
# Past 24 Hour Trades by Pool Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/pool-trades-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Trades
Past 24 Hour Trades by Pool Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Past 24 Hour Trades by Pool Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/trades \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_19612255_0x0b8ac5a16c291832c1b4d5f0d8ef2d9d58e207cd8132c32392295617daa4d422_158_1712595165",\
"type": "trade",\
"attributes": {\
"block_number": 19612255,\
"tx_hash": "0x0b8ac5a16c291832c1b4d5f0d8ef2d9d58e207cd8132c32392295617daa4d422",\
"tx_from_address": "0x42c037c594eefeca741e9dd66af91e7ffd930872",\
"from_token_amount": "1.51717616246451",\
"to_token_amount": "5535.099061",\
"price_from_in_currency_token": "1.0",\
"price_to_in_currency_token": "0.000274100995437363",\
"price_from_in_usd": "3656.8970003075",\
"price_to_in_usd": "1.00235910799619",\
"block_timestamp": "2024-04-08T16:52:35Z",\
"kind": "buy",\
"volume_in_usd": "5548.15695745452",\
"from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"\
}\
}\
]
}
GET
/
networks
/
{network}
/
pools
/
{pool\_address}
/
trades
Try it
Past 24 Hour Trades by Pool Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/trades \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_19612255_0x0b8ac5a16c291832c1b4d5f0d8ef2d9d58e207cd8132c32392295617daa4d422_158_1712595165",\
"type": "trade",\
"attributes": {\
"block_number": 19612255,\
"tx_hash": "0x0b8ac5a16c291832c1b4d5f0d8ef2d9d58e207cd8132c32392295617daa4d422",\
"tx_from_address": "0x42c037c594eefeca741e9dd66af91e7ffd930872",\
"from_token_amount": "1.51717616246451",\
"to_token_amount": "5535.099061",\
"price_from_in_currency_token": "1.0",\
"price_to_in_currency_token": "0.000274100995437363",\
"price_from_in_usd": "3656.8970003075",\
"price_to_in_usd": "1.00235910799619",\
"block_timestamp": "2024-04-08T16:52:35Z",\
"kind": "buy",\
"volume_in_usd": "5548.15695745452",\
"from_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"to_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/pool-trades-contract-address#note)
Note
* Cache/Update Frequency: Real-time (Cacheless) for Pro API (Basic, Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/pool-trades-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/pool-trades-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/pool-trades-contract-address#parameter-pool-address)
pool\_address
string
default:0x06da0fd433c1a5d7a4faa01111c044910a184553
required
pool contract address
Example:
`"0x06da0fd433c1a5d7a4faa01111c044910a184553"`
#### Query Parameters
[](https://docs.coingecko.com/reference/pool-trades-contract-address#parameter-trade-volume-in-usd-greater-than)
trade\_volume\_in\_usd\_greater\_than
number
filter trades by trade volume in USD greater than this value Default value: 0
[](https://docs.coingecko.com/reference/pool-trades-contract-address#parameter-token)
token
string
default:base
return trades for token use this to invert the chart Available values: 'base', 'quote' or token address Default value: 'base'
#### Response
200 - application/json
Get last 300 trades in past 24 hours from a pool
[](https://docs.coingecko.com/reference/pool-trades-contract-address#response-data)
data
object\[\]
Show child attributes
Was this page helpful?
YesNo
[💼 Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address)
[💼 Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address)
⌘I
---
# 💼 Token OHLCV chart by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/token-ohlcv-token-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
OHLCV
💼 Token OHLCV chart by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Token OHLCV chart by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "bc786a99-7205-4c80-aaa1-b9634d97c926",
"type": "ohlcv_request_response",
"attributes": {
"ohlcv_list": [\
[\
1712534400,\
3454.61590249189,\
3660.85954963415,\
3417.91885296256,\
3660.85954963415,\
306823.277031161\
],\
[\
1712448000,\
3362.60273217873,\
3455.28884490954,\
3352.95305060685,\
3454.61590249189,\
242144.864784184\
],\
[\
1712361600,\
3323.05578706056,\
3391.19811016133,\
3317.73497182435,\
3362.60273217873,\
273323.661682931\
]\
]
}
},
"meta": {
"base": {
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"name": "Wrapped Ether",
"symbol": "WETH",
"coingecko_coin_id": "weth"
},
"quote": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"coingecko_coin_id": "tether"
}
}
}
GET
/
networks
/
{network}
/
tokens
/
{token\_address}
/
ohlcv
/
{timeframe}
Try it
💼 Token OHLCV chart by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "bc786a99-7205-4c80-aaa1-b9634d97c926",
"type": "ohlcv_request_response",
"attributes": {
"ohlcv_list": [\
[\
1712534400,\
3454.61590249189,\
3660.85954963415,\
3417.91885296256,\
3660.85954963415,\
306823.277031161\
],\
[\
1712448000,\
3362.60273217873,\
3455.28884490954,\
3352.95305060685,\
3454.61590249189,\
242144.864784184\
],\
[\
1712361600,\
3323.05578706056,\
3391.19811016133,\
3317.73497182435,\
3362.60273217873,\
273323.661682931\
]\
]
}
},
"meta": {
"base": {
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"name": "Wrapped Ether",
"symbol": "WETH",
"coingecko_coin_id": "weth"
},
"quote": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"coingecko_coin_id": "tether"
}
}
}
###
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#note)
Note
* This endpoint will return OHLCV data of the **most liquid pool** of the specified token. You may use this endpoint [Top Pools by Token Address](https://docs.coingecko.com/update/reference/top-pools-contract-address#/)
to check the top pools of a token.
* This endpoint uses epoch/unix format for its timestamp. Example: `1708850449`.
* [Paid plan](https://www.coingecko.com/en/api/pricing)
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.
* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-network)
network
string
default:solana
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"solana"`
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-token-address)
token\_address
string
default:So11111111111111111111111111111111111111112
required
token contract address
Example:
`"So11111111111111111111111111111111111111112"`
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-timeframe)
timeframe
enum
required
timeframe of the OHLCV chart
Available options:
`day`,
`hour`,
`minute`,
`second`
#### Query Parameters
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-aggregate)
aggregate
string
time period to aggregate each OHLCV Available values (day): `1` Available values (hour): `1` , `4` , `12` Available values (minute): `1` , `5` , `15` Available values (second): `1`, `15`, `30` Default value: 1
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-before-timestamp)
before\_timestamp
integer
return OHLCV data before this timestamp (integer seconds since epoch)
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-limit)
limit
integer
number of OHLCV results to return, maximum 1000 Default value: 100
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-currency)
currency
enum
return OHLCV in USD or quote token Default value: usd
Available options:
`usd`,
`token`
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-include-empty-intervals)
include\_empty\_intervals
boolean
default:false
include empty intervals with no trade data, default: false
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#parameter-include-inactive-source)
include\_inactive\_source
boolean
default:false
include token data from inactive pools using the most recent swap, default: false
#### Response
200 - application/json
Get OHLCV data of a token
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#response-data)
data
object
Show child attributes
[](https://docs.coingecko.com/reference/token-ohlcv-token-address#response-meta)
meta
object
Show child attributes
Was this page helpful?
YesNo
[Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address)
[Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address)
⌘I
---
# Exchange Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/exchanges-id#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Exchanges
Exchange Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Exchange Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance",
"year_established": 2017,
"country": "Cayman Islands",
"description": "",
"url": "https://www.binance.com/",
"image": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
"facebook_url": "https://www.facebook.com/binanceexchange",
"reddit_url": "https://www.reddit.com/r/binance/",
"telegram_url": "",
"slack_url": "",
"other_url_1": "https://medium.com/binanceexchange",
"other_url_2": "https://steemit.com/@binanceexchange",
"twitter_handle": "binance",
"has_trading_incentive": false,
"centralized": true,
"public_notice": "",
"alert_notice": "",
"trust_score": 9,
"trust_score_rank": 6,
"trade_volume_24h_btc": 207319.133772613,
"coins": 384,
"pairs": 1281,
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether"\
}\
]
}
GET
/
exchanges
/
{id}
Try it
Exchange Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/exchanges/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance",
"year_established": 2017,
"country": "Cayman Islands",
"description": "",
"url": "https://www.binance.com/",
"image": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274",
"facebook_url": "https://www.facebook.com/binanceexchange",
"reddit_url": "https://www.reddit.com/r/binance/",
"telegram_url": "",
"slack_url": "",
"other_url_1": "https://medium.com/binanceexchange",
"other_url_2": "https://steemit.com/@binanceexchange",
"twitter_handle": "binance",
"has_trading_incentive": false,
"centralized": true,
"public_notice": "",
"alert_notice": "",
"trust_score": 9,
"trust_score_rank": 6,
"trade_volume_24h_btc": 207319.133772613,
"coins": 384,
"pairs": 1281,
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether"\
}\
]
}
###
[](https://docs.coingecko.com/reference/exchanges-id#notice)
Notice
* Please note that the `trade_volume_24h_btc_normalized` data field will no longer be supported by our API starting on June 16, 2025. Please refer to [changelog](https://docs.coingecko.com/changelog#may-2025)
for more details.
###
[](https://docs.coingecko.com/reference/exchanges-id#note)
Note
* The exchange volume in the response is provided in BTC. To convert it to other currencies, please use [/exchange\_rates](https://docs.coingecko.com/reference/exchange-rates)
endpoint.
* For derivatives (e.g. `bitmex`, `binance_futures`), to get derivatives exchanges data, please go to [/derivatives/exchange/{id}](https://docs.coingecko.com/reference/derivatives-exchanges-id)
endpoint.
* Tickers are limited to 100 items, to get more tickers, please go to [/exchanges/{id}/tickers](https://docs.coingecko.com/reference/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.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/exchanges-id#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/exchanges-id#parameter-id)
id
string
default:binance
required
exchange ID \*refers to [`/exchanges/list`](https://docs.coingecko.com/reference/exchanges-list)
.
Example:
`"binance"`
#### Query Parameters
[](https://docs.coingecko.com/reference/exchanges-id#parameter-dex-pair-format)
dex\_pair\_format
enum
set to `symbol` to display DEX pair base and target as symbols, default: `contract_address`
Available options:
`contract_address`,
`symbol`
#### Response
200 - application/json
Get exchange volume in BTC and top 100 tickers only
[](https://docs.coingecko.com/reference/exchanges-id#response-name)
name
string
exchange name
[](https://docs.coingecko.com/reference/exchanges-id#response-year-established)
year\_established
number
exchange established year
[](https://docs.coingecko.com/reference/exchanges-id#response-country)
country
string
exchange incorporated country
[](https://docs.coingecko.com/reference/exchanges-id#response-description)
description
string
exchange description
[](https://docs.coingecko.com/reference/exchanges-id#response-url)
url
string
exchange website url
[](https://docs.coingecko.com/reference/exchanges-id#response-image)
image
string
exchange image url
[](https://docs.coingecko.com/reference/exchanges-id#response-facebook-url)
facebook\_url
string
exchange facebook url
[](https://docs.coingecko.com/reference/exchanges-id#response-reddit-url)
reddit\_url
string
exchange reddit url
[](https://docs.coingecko.com/reference/exchanges-id#response-telegram-url)
telegram\_url
string
exchange telegram url
[](https://docs.coingecko.com/reference/exchanges-id#response-slack-url)
slack\_url
string
exchange slack url
[](https://docs.coingecko.com/reference/exchanges-id#response-other-url-1)
other\_url\_1
string
[](https://docs.coingecko.com/reference/exchanges-id#response-other-url-2)
other\_url\_2
string
[](https://docs.coingecko.com/reference/exchanges-id#response-twitter-handle)
twitter\_handle
string
exchange twitter handle
[](https://docs.coingecko.com/reference/exchanges-id#response-has-trading-incentive)
has\_trading\_incentive
boolean
exchange trading incentive
[](https://docs.coingecko.com/reference/exchanges-id#response-centralized)
centralized
boolean
exchange type (true for centralized, false for decentralized)
[](https://docs.coingecko.com/reference/exchanges-id#response-public-notice)
public\_notice
string
public notice for exchange
[](https://docs.coingecko.com/reference/exchanges-id#response-alert-notice)
alert\_notice
string
alert notice for exchange
[](https://docs.coingecko.com/reference/exchanges-id#response-trust-score)
trust\_score
number
exchange trust score
[](https://docs.coingecko.com/reference/exchanges-id#response-trust-score-rank)
trust\_score\_rank
number
exchange trust score rank
[](https://docs.coingecko.com/reference/exchanges-id#response-trade-volume-24h-btc)
trade\_volume\_24h\_btc
number
[](https://docs.coingecko.com/reference/exchanges-id#response-coins)
coins
number
number of coins listed on the exchange
[](https://docs.coingecko.com/reference/exchanges-id#response-pairs)
pairs
number
number of trading pairs on the exchange
[](https://docs.coingecko.com/reference/exchanges-id#response-tickers)
tickers
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Exchanges List (ID Map)](https://docs.coingecko.com/reference/exchanges-list)
[Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers)
⌘I
---
# NFTs Collection Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/nfts-id#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
NFTs (Beta)
NFTs Collection Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
NFTs Collection Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"id": "pudgy-penguins",
"contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
"asset_platform_id": "ethereum",
"name": "Pudgy Penguins",
"symbol": "PPG",
"image": {
"small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323",
"small_2x": "https://coin-images.coingecko.com/nft_contracts/images/38/small_2x/pudgy.jpg?1730778323"
},
"banner_image": "https://coin-images.coingecko.com/nft_contracts/images/20/bored-ape-yacht-club-banner.png?1708416120",
"description": "Pudgy Penguins is a collection of 8,888 unique NFTs featuring cute cartoon penguins, which are generated from a collection of 150 different hand-drawn traits.",
"native_currency": "ethereum",
"native_currency_symbol": "ETH",
"market_cap_rank": 3,
"floor_price": {
"native_currency": 12.5,
"usd": 42317
},
"market_cap": {
"native_currency": 111100,
"usd": 376114941
},
"volume_24h": {
"native_currency": 429.88,
"usd": 1455314
},
"floor_price_in_usd_24h_percentage_change": 1.07067,
"floor_price_24h_percentage_change": {
"usd": 1.07067060717791,
"native_currency": 1.21457489878543
},
"market_cap_24h_percentage_change": {
"usd": 1.07067060717767,
"native_currency": -0.404858299595142
},
"volume_24h_percentage_change": {
"usd": -3.19833776698741,
"native_currency": -1.80185531390094
},
"number_of_unique_addresses": 4752,
"number_of_unique_addresses_24h_percentage_change": 0.08425,
"volume_in_usd_24h_percentage_change": -3.19834,
"total_supply": 8888,
"one_day_sales": 36,
"one_day_sales_24h_percentage_change": -2.7027027027027,
"one_day_average_sale_price": 11.9411943888889,
"one_day_average_sale_price_24h_percentage_change": 0.925870927379588,
"links": {
"homepage": "https://www.pudgypenguins.com/",
"twitter": "https://twitter.com/pudgypenguins",
"discord": "https://discord.gg/pudgypenguins"
},
"floor_price_7d_percentage_change": {
"usd": -18.0014948262365,
"native_currency": -13.7931034482759
},
"floor_price_14d_percentage_change": {
"usd": -8.63235339431041,
"native_currency": -8.61905110022663
},
"floor_price_30d_percentage_change": {
"usd": -14.3765649314409,
"native_currency": -0.777901254167328
},
"floor_price_60d_percentage_change": {
"usd": 15.2779758703282,
"native_currency": -18.0327868852459
},
"floor_price_1y_percentage_change": {
"usd": 429.5685372855,
"native_currency": 196.208530805687
},
"explorers": [\
{\
"name": "Etherscan",\
"link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
},\
{\
"name": "Ethplorer",\
"link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
}\
],
"user_favorites_count": 3660,
"ath": {
"native_currency": 22.9,
"usd": 67535
},
"ath_change_percentage": {
"native_currency": -59.825327510917,
"usd": -64.3396788440525
},
"ath_date": {
"native_currency": "2024-02-17T09:25:05.056Z",
"usd": "2024-02-29T11:45:08.150Z"
}
}
GET
/
nfts
/
{id}
Try it
NFTs Collection Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"id": "pudgy-penguins",
"contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
"asset_platform_id": "ethereum",
"name": "Pudgy Penguins",
"symbol": "PPG",
"image": {
"small": "https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323",
"small_2x": "https://coin-images.coingecko.com/nft_contracts/images/38/small_2x/pudgy.jpg?1730778323"
},
"banner_image": "https://coin-images.coingecko.com/nft_contracts/images/20/bored-ape-yacht-club-banner.png?1708416120",
"description": "Pudgy Penguins is a collection of 8,888 unique NFTs featuring cute cartoon penguins, which are generated from a collection of 150 different hand-drawn traits.",
"native_currency": "ethereum",
"native_currency_symbol": "ETH",
"market_cap_rank": 3,
"floor_price": {
"native_currency": 12.5,
"usd": 42317
},
"market_cap": {
"native_currency": 111100,
"usd": 376114941
},
"volume_24h": {
"native_currency": 429.88,
"usd": 1455314
},
"floor_price_in_usd_24h_percentage_change": 1.07067,
"floor_price_24h_percentage_change": {
"usd": 1.07067060717791,
"native_currency": 1.21457489878543
},
"market_cap_24h_percentage_change": {
"usd": 1.07067060717767,
"native_currency": -0.404858299595142
},
"volume_24h_percentage_change": {
"usd": -3.19833776698741,
"native_currency": -1.80185531390094
},
"number_of_unique_addresses": 4752,
"number_of_unique_addresses_24h_percentage_change": 0.08425,
"volume_in_usd_24h_percentage_change": -3.19834,
"total_supply": 8888,
"one_day_sales": 36,
"one_day_sales_24h_percentage_change": -2.7027027027027,
"one_day_average_sale_price": 11.9411943888889,
"one_day_average_sale_price_24h_percentage_change": 0.925870927379588,
"links": {
"homepage": "https://www.pudgypenguins.com/",
"twitter": "https://twitter.com/pudgypenguins",
"discord": "https://discord.gg/pudgypenguins"
},
"floor_price_7d_percentage_change": {
"usd": -18.0014948262365,
"native_currency": -13.7931034482759
},
"floor_price_14d_percentage_change": {
"usd": -8.63235339431041,
"native_currency": -8.61905110022663
},
"floor_price_30d_percentage_change": {
"usd": -14.3765649314409,
"native_currency": -0.777901254167328
},
"floor_price_60d_percentage_change": {
"usd": 15.2779758703282,
"native_currency": -18.0327868852459
},
"floor_price_1y_percentage_change": {
"usd": 429.5685372855,
"native_currency": 196.208530805687
},
"explorers": [\
{\
"name": "Etherscan",\
"link": "https://etherscan.io/token/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
},\
{\
"name": "Ethplorer",\
"link": "https://ethplorer.io/address/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
}\
],
"user_favorites_count": 3660,
"ath": {
"native_currency": 22.9,
"usd": 67535
},
"ath_change_percentage": {
"native_currency": -59.825327510917,
"usd": -64.3396788440525
},
"ath_date": {
"native_currency": "2024-02-17T09:25:05.056Z",
"usd": "2024-02-29T11:45:08.150Z"
}
}
###
[](https://docs.coingecko.com/reference/nfts-id#note)
Note
* Cache / Update Frequency: every 60 seconds for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/nfts-id#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/nfts-id#parameter-id)
id
string
default:pudgy-penguins
required
NFTs ID \*refers to [`/nfts/list`](https://docs.coingecko.com/reference/nfts-list)
.
Example:
`"pudgy-penguins"`
#### Response
200 - application/json
Get NFTs data
[](https://docs.coingecko.com/reference/nfts-id#response-id)
id
string
NFT collection ID
[](https://docs.coingecko.com/reference/nfts-id#response-contract-address)
contract\_address
string
NFT collection contract address
[](https://docs.coingecko.com/reference/nfts-id#response-asset-platform-id)
asset\_platform\_id
string
NFT collection asset platform ID
[](https://docs.coingecko.com/reference/nfts-id#response-name)
name
string
NFT collection name
[](https://docs.coingecko.com/reference/nfts-id#response-symbol)
symbol
string
NFT collection symbol
[](https://docs.coingecko.com/reference/nfts-id#response-image)
image
object
NFT collection image url
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-banner-image)
banner\_image
object
NFT collection banner image url
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-description)
description
string
NFT collection description
[](https://docs.coingecko.com/reference/nfts-id#response-native-currency)
native\_currency
string
NFT collection native currency
[](https://docs.coingecko.com/reference/nfts-id#response-native-currency-symbol)
native\_currency\_symbol
string
NFT collection native currency symbol
[](https://docs.coingecko.com/reference/nfts-id#response-market-cap-rank)
market\_cap\_rank
number
coin market cap rank
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price)
floor\_price
object
NFT collection floor price
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-market-cap)
market\_cap
object
NFT collection market cap
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-volume-24h)
volume\_24h
object
NFT collection volume in 24 hours
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-in-usd-24h-percentage-change)
floor\_price\_in\_usd\_24h\_percentage\_change
number
NFT collection floor price in usd 24 hours percentage change
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-24h-percentage-change)
floor\_price\_24h\_percentage\_change
object
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-market-cap-24h-percentage-change)
market\_cap\_24h\_percentage\_change
object
NFT collection market cap 24 hours percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-volume-24h-percentage-change)
volume\_24h\_percentage\_change
object
NFT collection volume in 24 hours percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-number-of-unique-addresses)
number\_of\_unique\_addresses
number
number of unique address owning the NFTs
[](https://docs.coingecko.com/reference/nfts-id#response-number-of-unique-addresses-24h-percentage-change)
number\_of\_unique\_addresses\_24h\_percentage\_change
number
number of unique address owning the NFTs 24 hours percentage change
[](https://docs.coingecko.com/reference/nfts-id#response-volume-in-usd-24h-percentage-change)
volume\_in\_usd\_24h\_percentage\_change
number
NFT collection volume in usd 24 hours percentage change
[](https://docs.coingecko.com/reference/nfts-id#response-total-supply)
total\_supply
number
NFT collection total supply
[](https://docs.coingecko.com/reference/nfts-id#response-one-day-sales)
one\_day\_sales
number
NFT collection one day sales
[](https://docs.coingecko.com/reference/nfts-id#response-one-day-sales-24h-percentage-change)
one\_day\_sales\_24h\_percentage\_change
number
NFT collection one day sales 24 hours percentage change
[](https://docs.coingecko.com/reference/nfts-id#response-one-day-average-sale-price)
one\_day\_average\_sale\_price
number
NFT collection one day average sale price
[](https://docs.coingecko.com/reference/nfts-id#response-one-day-average-sale-price-24h-percentage-change)
one\_day\_average\_sale\_price\_24h\_percentage\_change
number
NFT collection one day average sale price 24 hours percentage change
[](https://docs.coingecko.com/reference/nfts-id#response-links)
links
object
NFT collection links
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-7d-percentage-change)
floor\_price\_7d\_percentage\_change
object
NFT collection floor price 7 days percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-14d-percentage-change)
floor\_price\_14d\_percentage\_change
object
NFT collection floor price 14 days percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-30d-percentage-change)
floor\_price\_30d\_percentage\_change
object
NFT collection floor price 30 days percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-60d-percentage-change)
floor\_price\_60d\_percentage\_change
object
NFT collection floor price 60 days percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-floor-price-1y-percentage-change)
floor\_price\_1y\_percentage\_change
object
NFT collection floor price 1 year percentage change
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-explorers)
explorers
object\[\]
NFT collection block explorers links
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-user-favorites-count)
user\_favorites\_count
number
NFT collection user favorites count
[](https://docs.coingecko.com/reference/nfts-id#response-ath)
ath
object
NFT collection all time highs
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-ath-change-percentage)
ath\_change\_percentage
object
NFT collection all time highs change percentage
Show child attributes
[](https://docs.coingecko.com/reference/nfts-id#response-ath-date)
ath\_date
object
NFT collection all time highs date
Show child attributes
Was this page helpful?
YesNo
[NFTs List (ID Map)](https://docs.coingecko.com/reference/nfts-list)
[NFTs Collection Data by Contract Address](https://docs.coingecko.com/reference/nfts-contract-address)
⌘I
---
# 💼 NFTs Collection Tickers by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/nfts-id-tickers#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
NFTs (Beta)
💼 NFTs Collection Tickers by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 NFTs Collection Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"tickers": [\
{\
"floor_price_in_native_currency": 44.21,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T15:36:00.225Z",\
"nft_marketplace_id": "looksrare",\
"name": "LooksRare",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/2/small/Looksrare.jpg?1686193414",\
"nft_collection_url": "https://looksrare.org/collections/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8?ref=9247712"\
},\
{\
"floor_price_in_native_currency": 12.17,\
"h24_volume_in_native_currency": 402.37,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.797Z",\
"nft_marketplace_id": "blur",\
"name": "Blur",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/20/small/blur_logo.jpg?1690993708",\
"nft_collection_url": "https://blur.io/collection/pudgypenguins"\
},\
{\
"floor_price_in_native_currency": 12.84,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.897Z",\
"nft_marketplace_id": "opensea",\
"name": "OpenSea",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/1/small/Opensea.png?1686193426",\
"nft_collection_url": "https://opensea.io/collection/pudgypenguins"\
},\
{\
"floor_price_in_native_currency": 199,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.979Z",\
"nft_marketplace_id": "x2y2",\
"name": "X2Y2",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/21/small/Logo.png?1693192556",\
"nft_collection_url": "https://x2y2.io/collection/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
}\
]
}
GET
/
nfts
/
{id}
/
tickers
Try it
💼 NFTs Collection Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/nfts/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"tickers": [\
{\
"floor_price_in_native_currency": 44.21,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T15:36:00.225Z",\
"nft_marketplace_id": "looksrare",\
"name": "LooksRare",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/2/small/Looksrare.jpg?1686193414",\
"nft_collection_url": "https://looksrare.org/collections/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8?ref=9247712"\
},\
{\
"floor_price_in_native_currency": 12.17,\
"h24_volume_in_native_currency": 402.37,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.797Z",\
"nft_marketplace_id": "blur",\
"name": "Blur",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/20/small/blur_logo.jpg?1690993708",\
"nft_collection_url": "https://blur.io/collection/pudgypenguins"\
},\
{\
"floor_price_in_native_currency": 12.84,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.897Z",\
"nft_marketplace_id": "opensea",\
"name": "OpenSea",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/1/small/Opensea.png?1686193426",\
"nft_collection_url": "https://opensea.io/collection/pudgypenguins"\
},\
{\
"floor_price_in_native_currency": 199,\
"h24_volume_in_native_currency": 0,\
"native_currency": "ethereum",\
"native_currency_symbol": "ETH",\
"updated_at": "2024-04-08T12:28:11.979Z",\
"nft_marketplace_id": "x2y2",\
"name": "X2Y2",\
"image": "https://assets.coingecko.com/nft_marketplaces/images/21/small/Logo.png?1693192556",\
"nft_collection_url": "https://x2y2.io/collection/0xBd3531dA5CF5857e7CfAA92426877b022e612cf8"\
}\
]
}
###
[](https://docs.coingecko.com/reference/nfts-id-tickers#note)
Note
* Cache/Update Frequency: every 30 seconds.
* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/nfts-id-tickers#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/nfts-id-tickers#parameter-id)
id
string
default:pudgy-penguins
required
NFTs ID \*refers to [`/nfts/list`](https://docs.coingecko.com/reference/nfts-list)
.
Example:
`"pudgy-penguins"`
#### Response
200 - application/json
Get NFTs tickers
[](https://docs.coingecko.com/reference/nfts-id-tickers#response-tickers)
tickers
object\[\]
Show child attributes
Was this page helpful?
YesNo
[💼 NFTs Collection Historical Chart Data by Contract Address](https://docs.coingecko.com/reference/nfts-contract-address-market-chart)
[BTC-to-Currency Exchange Rates](https://docs.coingecko.com/reference/exchange-rates)
⌘I
---
# Trending Pools List - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/trending-pools-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
Trending Pools List
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Trending Pools List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/trending_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
trending\_pools
Try it
Trending Pools List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/trending_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/trending-pools-list#tips)
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](https://docs.coingecko.com/reference/pools-megafilter)
endpoint.
###
[](https://docs.coingecko.com/reference/trending-pools-list#note)
Note
* Trending rankings are determined by a combination of factors:
* User engagement on geckoterminal.com
* Market activity, such as trading volume and transactions
* Pool security and credibility, including liquidity and honeypot checks
* 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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
* GeckoTerminal equivalent page (example): [https://www.geckoterminal.com](https://www.geckoterminal.com/)
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/trending-pools-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/trending-pools-list#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`, `network`. Example: `base_token` or `base_token,dex`
[](https://docs.coingecko.com/reference/trending-pools-list#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/trending-pools-list#parameter-duration)
duration
enum
duration to sort trending list by Default value: 24h
Available options:
`5m`,
`1h`,
`6h`,
`24h`
[](https://docs.coingecko.com/reference/trending-pools-list#parameter-include-gt-community-data)
include\_gt\_community\_data
boolean
include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false
#### Response
200 - application/json
Get trending pools across all networks
[](https://docs.coingecko.com/reference/trending-pools-list#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/trending-pools-list#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses)
[Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)
⌘I
---
# Token Info by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/token-info-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Tokens
Token Info by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Token Info by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token",
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
"image": {
"thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661",
"small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
"large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661"
},
"coingecko_coin_id": "tether",
"websites": [\
"https://tether.to/"\
],
"description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
"gt_score": 92.6605504587156,
"gt_score_details": {
"pool": 87.5,
"transaction": 0,
"creation": 100,
"info": 100,
"holders": 0
},
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": null,
"twitter_handle": "Tether_to",
"categories": [],
"gt_categories_id": [],
"holders": {
"count": 7041203,
"distribution_percentage": {
"top_10": "45.5782",
"11_30": "13.4293",
"31_50": "3.9681",
"rest": "37.0244"
},
"last_updated": "2025-03-12T05:28:50Z"
},
"mint_authority": null,
"freeze_authority": null,
"is_honeypot": false
}
}
}
GET
/
networks
/
{network}
/
tokens
/
{address}
/
info
Try it
Token Info by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/info \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token",
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
"image": {
"thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661",
"small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
"large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661"
},
"coingecko_coin_id": "tether",
"websites": [\
"https://tether.to/"\
],
"description": "Tether (USDT) is a cryptocurrency with a value meant to mirror the value of the U.S. dollar...",
"gt_score": 92.6605504587156,
"gt_score_details": {
"pool": 87.5,
"transaction": 0,
"creation": 100,
"info": 100,
"holders": 0
},
"discord_url": null,
"farcaster_url": null,
"zora_url": null,
"telegram_handle": null,
"twitter_handle": "Tether_to",
"categories": [],
"gt_categories_id": [],
"holders": {
"count": 7041203,
"distribution_percentage": {
"top_10": "45.5782",
"11_30": "13.4293",
"31_50": "3.9681",
"rest": "37.0244"
},
"last_updated": "2025-03-12T05:28:50Z"
},
"mint_authority": null,
"freeze_authority": null,
"is_honeypot": false
}
}
}
###
[](https://docs.coingecko.com/reference/token-info-contract-address#tips)
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}`](https://docs.coingecko.com/reference/token-data-contract-address)
instead.
* Cache/Update frequency: every 60 seconds.
* Learn more about GT score [here](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated)
.
* 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:
* [Coin Data by ID](https://docs.coingecko.com/reference/coins-id)
* [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address)
###
[](https://docs.coingecko.com/reference/token-info-contract-address#note)
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` is calculated based on the token’s total supply and includes all wallet types (CEX wallets, treasury/issuer wallets, etc.). Coverage includes:
* 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.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/token-info-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/token-info-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/token-info-contract-address#parameter-address)
address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required
token contract address
Example:
`"0xdac17f958d2ee523a2206206994597c13d831ec7"`
#### Response
200 - application/json
Get specific token info on a network
[](https://docs.coingecko.com/reference/token-info-contract-address#response-data)
data
object
Show child attributes
Was this page helpful?
YesNo
[Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
[Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address)
⌘I
---
# Search Pools - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/search-pools#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
Search Pools
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Search Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/search/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
search
/
pools
Try it
Search Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/search/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/search-pools#tips)
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.
###
[](https://docs.coingecko.com/reference/search-pools#note)
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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/search-pools#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/search-pools#parameter-query)
query
string
default:weth
search query
Example:
`"weth"`
[](https://docs.coingecko.com/reference/search-pools#parameter-network)
network
string
default:eth
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/search-pools#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`
[](https://docs.coingecko.com/reference/search-pools#parameter-page)
page
integer
page through results Default value: 1
#### Response
200 - application/json
Search for pools on a network
[](https://docs.coingecko.com/reference/search-pools#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/search-pools#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[🔥 Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)
[💼 Trending Search Pools](https://docs.coingecko.com/reference/trending-search-pools)
⌘I
---
# New Pools List - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/latest-pools-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
New Pools List
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
New Pools List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/new_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
new\_pools
Try it
New Pools List
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/new_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/latest-pools-list#tips)
Tips
* You may include values such as `page` to specify which page of responses you would like to show.
###
[](https://docs.coingecko.com/reference/latest-pools-list#note)
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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
* GeckoTerminal equivalent page (example): [https://www.geckoterminal.com/explore/new-crypto-pools](https://www.geckoterminal.com/explore/new-crypto-pools)
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/latest-pools-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/latest-pools-list#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`, `network`
[](https://docs.coingecko.com/reference/latest-pools-list#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/latest-pools-list#parameter-include-gt-community-data)
include\_gt\_community\_data
boolean
include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false
#### Response
200 - application/json
Get latest pools across all networks
[](https://docs.coingecko.com/reference/latest-pools-list#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/latest-pools-list#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex)
[New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)
⌘I
---
# Token Data by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/token-data-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Tokens
Token Data by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Token Data by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token",
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661",
"coingecko_coin_id": "tether",
"total_supply": "91775654692250534.0",
"normalized_total_supply": "91775654692.2505",
"price_usd": "0.999188255",
"fdv_usd": "91700939859.6687",
"total_reserve_in_usd": "405089394.14192413773442554227",
"volume_usd": {
"h24": "1142454033.37436"
},
"market_cap_usd": "171798403974.784",
"last_trade_timestamp": 1712534400
},
"relationships": {
"top_pools": {
"data": [\
{\
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"type": "pool"\
},\
{\
"id": "eth_0xf063bd202e45d6b2843102cb4ece339026645d4a",\
"type": "pool"\
},\
{\
"id": "eth_0x8aa4e11cbdf30eedc92100f4c8a31ff748e201d44712cc8c90d189edaa8e4e47",\
"type": "pool"\
}\
]
}
}
},
"included": [\
{\
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "0.999949947925521",\
"base_token_price_native_currency": "0.000223341206041575",\
"base_token_balance": "74198606.301554",\
"base_token_liquidity_usd": "74194892.50738515",\
"quote_token_price_usd": "0.99918825500163",\
"quote_token_price_native_currency": "0.000223171080110164",\
"quote_token_balance": "29771050.29628",\
"quote_token_liquidity_usd": "29746883.795105774",\
"base_token_price_quote_token": "1.0007623117",\
"quote_token_price_base_token": "0.9992382689",\
"address": "0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"name": "USDC / USDT",\
"pool_created_at": "2025-09-18T08:28:30Z",\
"token_price_usd": "0.99918825500163",\
"fdv_usd": "91700939859.6687",\
"market_cap_usd": "171798403975.064",\
"price_change_percentage": {\
"m5": "-0.02",\
"m15": "-0.65",\
"m30": "-0.01",\
"h1": "0",\
"h6": "-0.18",\
"h24": "-0.5"\
},\
"transactions": {\
"m5": {\
"buys": 0,\
"sells": 2,\
"buyers": 0,\
"sellers": 2\
},\
"m15": {\
"buys": 4,\
"sells": 7,\
"buyers": 3,\
"sellers": 5\
},\
"m30": {\
"buys": 12,\
"sells": 19,\
"buyers": 7,\
"sellers": 9\
},\
"h1": {\
"buys": 39,\
"sells": 48,\
"buyers": 16,\
"sellers": 15\
},\
"h6": {\
"buys": 180,\
"sells": 271,\
"buyers": 31,\
"sellers": 35\
},\
"h24": {\
"buys": 870,\
"sells": 1109,\
"buyers": 55,\
"sellers": 59\
}\
},\
"volume_usd": {\
"m5": "988.7572917698",\
"m15": "1857835.95996426",\
"m30": "3190909.49729904",\
"h1": "9434171.29930675",\
"h6": "84784863.3965608",\
"h24": "388004708.962186"\
},\
"reserve_in_usd": "103939687.035"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "fluid-ethereum",\
"type": "dex"\
}\
}\
}\
}\
]
}
GET
/
networks
/
{network}
/
tokens
/
{address}
Try it
Token Data by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token",
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661",
"coingecko_coin_id": "tether",
"total_supply": "91775654692250534.0",
"normalized_total_supply": "91775654692.2505",
"price_usd": "0.999188255",
"fdv_usd": "91700939859.6687",
"total_reserve_in_usd": "405089394.14192413773442554227",
"volume_usd": {
"h24": "1142454033.37436"
},
"market_cap_usd": "171798403974.784",
"last_trade_timestamp": 1712534400
},
"relationships": {
"top_pools": {
"data": [\
{\
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"type": "pool"\
},\
{\
"id": "eth_0xf063bd202e45d6b2843102cb4ece339026645d4a",\
"type": "pool"\
},\
{\
"id": "eth_0x8aa4e11cbdf30eedc92100f4c8a31ff748e201d44712cc8c90d189edaa8e4e47",\
"type": "pool"\
}\
]
}
}
},
"included": [\
{\
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "0.999949947925521",\
"base_token_price_native_currency": "0.000223341206041575",\
"base_token_balance": "74198606.301554",\
"base_token_liquidity_usd": "74194892.50738515",\
"quote_token_price_usd": "0.99918825500163",\
"quote_token_price_native_currency": "0.000223171080110164",\
"quote_token_balance": "29771050.29628",\
"quote_token_liquidity_usd": "29746883.795105774",\
"base_token_price_quote_token": "1.0007623117",\
"quote_token_price_base_token": "0.9992382689",\
"address": "0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",\
"name": "USDC / USDT",\
"pool_created_at": "2025-09-18T08:28:30Z",\
"token_price_usd": "0.99918825500163",\
"fdv_usd": "91700939859.6687",\
"market_cap_usd": "171798403975.064",\
"price_change_percentage": {\
"m5": "-0.02",\
"m15": "-0.65",\
"m30": "-0.01",\
"h1": "0",\
"h6": "-0.18",\
"h24": "-0.5"\
},\
"transactions": {\
"m5": {\
"buys": 0,\
"sells": 2,\
"buyers": 0,\
"sellers": 2\
},\
"m15": {\
"buys": 4,\
"sells": 7,\
"buyers": 3,\
"sellers": 5\
},\
"m30": {\
"buys": 12,\
"sells": 19,\
"buyers": 7,\
"sellers": 9\
},\
"h1": {\
"buys": 39,\
"sells": 48,\
"buyers": 16,\
"sellers": 15\
},\
"h6": {\
"buys": 180,\
"sells": 271,\
"buyers": 31,\
"sellers": 35\
},\
"h24": {\
"buys": 870,\
"sells": 1109,\
"buyers": 55,\
"sellers": 59\
}\
},\
"volume_usd": {\
"m5": "988.7572917698",\
"m15": "1857835.95996426",\
"m30": "3190909.49729904",\
"h1": "9434171.29930675",\
"h6": "84784863.3965608",\
"h24": "388004708.962186"\
},\
"reserve_in_usd": "103939687.035"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "fluid-ethereum",\
"type": "dex"\
}\
}\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/token-data-contract-address#tips)
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`](https://docs.coingecko.com/reference/token-info-contract-address)
instead.
###
[](https://docs.coingecko.com/reference/token-data-contract-address#note)
Note
* Address not found in GeckoTerminal.com will be ignored.
* The endpoint will only return the first top most liquid pool for each token. The top pool 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).
* 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 10 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/token-data-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/token-data-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/token-data-contract-address#parameter-address)
address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required
token contract address
Example:
`"0xdac17f958d2ee523a2206206994597c13d831ec7"`
#### Query Parameters
[](https://docs.coingecko.com/reference/token-data-contract-address#parameter-include)
include
enum
attributes to include
Available options:
`top_pools`
[](https://docs.coingecko.com/reference/token-data-contract-address#parameter-include-composition)
include\_composition
boolean
include pool composition, default: false
[](https://docs.coingecko.com/reference/token-data-contract-address#parameter-include-inactive-source)
include\_inactive\_source
boolean
default:false
include token data from inactive pools using the most recent swap, default: false
#### Response
200 - application/json
Get specific token on a network
[](https://docs.coingecko.com/reference/token-data-contract-address#response-data)
data
object
Show child attributes
[](https://docs.coingecko.com/reference/token-data-contract-address#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)
[Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses)
⌘I
---
# 💼 Top Gainers & Losers - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-top-gainers-losers#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
💼 Top Gainers & Losers
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Top Gainers & Losers
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"top_gainers": [\
{\
"id": "hemi",\
"symbol": "hemi",\
"name": "Hemi",\
"image": "https://coin-images.coingecko.com/coins/images/68469/original/hemi.png?1755838145",\
"market_cap_rank": 504,\
"usd": 0.11185590814980959,\
"usd_24h_vol": 37605963.6544256,\
"usd_24h_change": 97.50734564945273,\
"usd_1h_change": -0.17390830639913413,\
"usd_7d_change": 109.51907994608104,\
"usd_14d_change": 174.05573448108248,\
"usd_30d_change": null,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "pumpbtc-2",\
"symbol": "pump",\
"name": "PumpBTC",\
"image": "https://coin-images.coingecko.com/coins/images/55057/original/pumpbtc.jpg?1743518852",\
"market_cap_rank": 884,\
"usd": 0.16754354002402758,\
"usd_24h_vol": 140450837.37342194,\
"usd_24h_change": 79.0420542402058,\
"usd_1h_change": 8.40284698009908,\
"usd_7d_change": 28.741928455454058,\
"usd_14d_change": 313.0525092121525,\
"usd_30d_change": 324.6502118828966,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "thena",\
"symbol": "the",\
"name": "Thena",\
"image": "https://coin-images.coingecko.com/coins/images/28864/original/Symbol-Color200x200.png?1706810126",\
"market_cap_rank": 642,\
"usd": 0.6638151932043868,\
"usd_24h_vol": 487895427.62352824,\
"usd_24h_change": 61.81094922342915,\
"usd_1h_change": 0.9390562783319398,\
"usd_7d_change": 86.44786589199917,\
"usd_14d_change": 97.8025192992777,\
"usd_30d_change": 73.66796131254053,\
"usd_200d_change": 55.59406002775006,\
"usd_1y_change": 331.98491608746525\
}\
],
"top_losers": [\
{\
"id": "alchemist-ai",\
"symbol": "alch",\
"name": "Alchemist AI",\
"image": "https://coin-images.coingecko.com/coins/images/52302/original/small-logo.png?1733053544",\
"market_cap_rank": 756,\
"usd": 0.07041470135934932,\
"usd_24h_vol": 27971580.84457393,\
"usd_24h_change": -17.226320551694926,\
"usd_1h_change": -2.2542371779000514,\
"usd_7d_change": -23.040652631290545,\
"usd_14d_change": -19.470542701647435,\
"usd_30d_change": -46.09430540829394,\
"usd_200d_change": 45.86147201477917,\
"usd_1y_change": null\
},\
{\
"id": "openvpp",\
"symbol": "ovpp",\
"name": "OpenVPP",\
"image": "https://coin-images.coingecko.com/coins/images/68508/original/IMG_9538.jpeg?1756034149",\
"market_cap_rank": 656,\
"usd": 0.0928916427310922,\
"usd_24h_vol": 2056051.9687436165,\
"usd_24h_change": -16.433799392732045,\
"usd_1h_change": 6.52588781595783,\
"usd_7d_change": -30.059713680473045,\
"usd_14d_change": 26.47704349007484,\
"usd_30d_change": null,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "tutorial",\
"symbol": "tut",\
"name": "Tutorial",\
"image": "https://coin-images.coingecko.com/coins/images/54299/original/image_2025-02-08_18-56-13.png?1739165439",\
"market_cap_rank": 709,\
"usd": 0.07931969147215992,\
"usd_24h_vol": 100448249.77316675,\
"usd_24h_change": -14.152000966660887,\
"usd_1h_change": 1.2261498633124626,\
"usd_7d_change": 15.617617995365999,\
"usd_14d_change": 16.107294253488487,\
"usd_30d_change": 32.794999688255686,\
"usd_200d_change": 5109.0575785263345,\
"usd_1y_change": null\
}\
]
}
GET
/
coins
/
top\_gainers\_losers
Try it
💼 Top Gainers & Losers
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/top_gainers_losers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"top_gainers": [\
{\
"id": "hemi",\
"symbol": "hemi",\
"name": "Hemi",\
"image": "https://coin-images.coingecko.com/coins/images/68469/original/hemi.png?1755838145",\
"market_cap_rank": 504,\
"usd": 0.11185590814980959,\
"usd_24h_vol": 37605963.6544256,\
"usd_24h_change": 97.50734564945273,\
"usd_1h_change": -0.17390830639913413,\
"usd_7d_change": 109.51907994608104,\
"usd_14d_change": 174.05573448108248,\
"usd_30d_change": null,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "pumpbtc-2",\
"symbol": "pump",\
"name": "PumpBTC",\
"image": "https://coin-images.coingecko.com/coins/images/55057/original/pumpbtc.jpg?1743518852",\
"market_cap_rank": 884,\
"usd": 0.16754354002402758,\
"usd_24h_vol": 140450837.37342194,\
"usd_24h_change": 79.0420542402058,\
"usd_1h_change": 8.40284698009908,\
"usd_7d_change": 28.741928455454058,\
"usd_14d_change": 313.0525092121525,\
"usd_30d_change": 324.6502118828966,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "thena",\
"symbol": "the",\
"name": "Thena",\
"image": "https://coin-images.coingecko.com/coins/images/28864/original/Symbol-Color200x200.png?1706810126",\
"market_cap_rank": 642,\
"usd": 0.6638151932043868,\
"usd_24h_vol": 487895427.62352824,\
"usd_24h_change": 61.81094922342915,\
"usd_1h_change": 0.9390562783319398,\
"usd_7d_change": 86.44786589199917,\
"usd_14d_change": 97.8025192992777,\
"usd_30d_change": 73.66796131254053,\
"usd_200d_change": 55.59406002775006,\
"usd_1y_change": 331.98491608746525\
}\
],
"top_losers": [\
{\
"id": "alchemist-ai",\
"symbol": "alch",\
"name": "Alchemist AI",\
"image": "https://coin-images.coingecko.com/coins/images/52302/original/small-logo.png?1733053544",\
"market_cap_rank": 756,\
"usd": 0.07041470135934932,\
"usd_24h_vol": 27971580.84457393,\
"usd_24h_change": -17.226320551694926,\
"usd_1h_change": -2.2542371779000514,\
"usd_7d_change": -23.040652631290545,\
"usd_14d_change": -19.470542701647435,\
"usd_30d_change": -46.09430540829394,\
"usd_200d_change": 45.86147201477917,\
"usd_1y_change": null\
},\
{\
"id": "openvpp",\
"symbol": "ovpp",\
"name": "OpenVPP",\
"image": "https://coin-images.coingecko.com/coins/images/68508/original/IMG_9538.jpeg?1756034149",\
"market_cap_rank": 656,\
"usd": 0.0928916427310922,\
"usd_24h_vol": 2056051.9687436165,\
"usd_24h_change": -16.433799392732045,\
"usd_1h_change": 6.52588781595783,\
"usd_7d_change": -30.059713680473045,\
"usd_14d_change": 26.47704349007484,\
"usd_30d_change": null,\
"usd_200d_change": null,\
"usd_1y_change": null\
},\
{\
"id": "tutorial",\
"symbol": "tut",\
"name": "Tutorial",\
"image": "https://coin-images.coingecko.com/coins/images/54299/original/image_2025-02-08_18-56-13.png?1739165439",\
"market_cap_rank": 709,\
"usd": 0.07931969147215992,\
"usd_24h_vol": 100448249.77316675,\
"usd_24h_change": -14.152000966660887,\
"usd_1h_change": 1.2261498633124626,\
"usd_7d_change": 15.617617995365999,\
"usd_14d_change": 16.107294253488487,\
"usd_30d_change": 32.794999688255686,\
"usd_200d_change": 5109.0575785263345,\
"usd_1y_change": null\
}\
]
}
###
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#note)
Note
* The endpoint response only includes coins with a 24-hour trading volume of at least $50,000.
* CoinGecko equivalent page: [https://www.coingecko.com/en/crypto-gainers-losers](https://www.coingecko.com/en/crypto-gainers-losers)
.
* Cache/Update Frequency: Every 5 minutes.
* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of coins \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#parameter-duration)
duration
enum
filter result by time range Default value: `24h`
Available options:
`1h`,
`24h`,
`7d`,
`14d`,
`30d`,
`60d`,
`1y`
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#parameter-price-change-percentage)
price\_change\_percentage
string
include price change percentage timeframe, comma-separated if query more than 1 price change percentage timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#parameter-top-coins)
top\_coins
enum
filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap) Default value: `1000`
Available options:
`300`,
`500`,
`1000`,
`all`
#### Response
200 - application/json
List top 30 gainers and losers
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#response-top-gainers)
top\_gainers
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/coins-top-gainers-losers#response-top-losers)
top\_losers
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Coins List (ID Map)](https://docs.coingecko.com/reference/coins-list)
[💼 Recently Added Coins](https://docs.coingecko.com/reference/coins-list-new)
⌘I
---
# Coins Categories List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-categories-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Categories
Coins Categories List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coins Categories List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/categories/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"category_id": "aave-tokens",\
"name": "Aave Tokens"\
},\
{\
"category_id": "aaccount-abstraction",\
"name": "Account Abstraction"\
}\
]
GET
/
coins
/
categories
/
list
Try it
Coins Categories List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/categories/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"category_id": "aave-tokens",\
"name": "Aave Tokens"\
},\
{\
"category_id": "aaccount-abstraction",\
"name": "Account Abstraction"\
}\
]
###
[](https://docs.coingecko.com/reference/coins-categories-list#tips)
Tips
* You may use this endpoint to query the list of categories for other endpoints that contain params like `category`.
###
[](https://docs.coingecko.com/reference/coins-categories-list#note)
Note
* CoinGecko Equivalent Page: [https://www.coingecko.com/en/categories](https://www.coingecko.com/en/categories)
.
* Cache / Update Frequency: every 5 minutes for all the API plans.
* CoinGecko categories are different from [GeckoTerminal categories](https://docs.coingecko.com/reference/categories-list)
.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-categories-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
List all categories
[](https://docs.coingecko.com/reference/coins-categories-list#response-category-id)
category\_id
string
category ID
[](https://docs.coingecko.com/reference/coins-categories-list#response-name)
name
string
category name
Was this page helpful?
YesNo
[Token Lists by Asset Platform ID](https://docs.coingecko.com/reference/token-lists)
[Coins Categories List with Market Data](https://docs.coingecko.com/reference/coins-categories)
⌘I
---
# 💼 API Usage - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/api-usage#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Key
💼 API Usage
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 API Usage
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/key \
--header 'x-cg-pro-api-key: '
200
Copy
{
"plan": "Other",
"rate_limit_request_per_minute": 1000,
"monthly_call_credit": 1000000,
"current_total_monthly_calls": 104,
"current_remaining_monthly_calls": 999896
}
GET
/
key
Try it
💼 API Usage
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/key \
--header 'x-cg-pro-api-key: '
200
Copy
{
"plan": "Other",
"rate_limit_request_per_minute": 1000,
"monthly_call_credit": 1000000,
"current_total_monthly_calls": 104,
"current_remaining_monthly_calls": 999896
}
###
[](https://docs.coingecko.com/reference/api-usage#note)
Note
For a more comprehensive overview of your API usage, please log in to [https://www.coingecko.com/en/developers/dashboard](https://www.coingecko.com/en/developers/dashboard)
.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/api-usage#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
API Usage
[](https://docs.coingecko.com/reference/api-usage#response-plan)
plan
string
[](https://docs.coingecko.com/reference/api-usage#response-rate-limit-request-per-minute)
rate\_limit\_request\_per\_minute
number
[](https://docs.coingecko.com/reference/api-usage#response-monthly-call-credit)
monthly\_call\_credit
number
[](https://docs.coingecko.com/reference/api-usage#response-current-total-monthly-calls)
current\_total\_monthly\_calls
number
[](https://docs.coingecko.com/reference/api-usage#response-current-remaining-monthly-calls)
current\_remaining\_monthly\_calls
number
Was this page helpful?
YesNo
[Check API server status](https://docs.coingecko.com/reference/ping-server)
[Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)
⌘I
---
# 💼 Recently Added Coins - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-list-new#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
💼 Recently Added Coins
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Recently Added Coins
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/list/new \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "long-johnson",\
"symbol": "olong",\
"name": "Long Johnson",\
"activated_at": 1712562430\
},\
{\
"id": "dogita",\
"symbol": "doga",\
"name": "DOGITA",\
"activated_at": 1712562282\
},\
{\
"id": "bebe-on-base",\
"symbol": "bebe",\
"name": "Bebe on Base",\
"activated_at": 1712561709\
}\
]
GET
/
coins
/
list
/
new
Try it
💼 Recently Added Coins
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/list/new \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "long-johnson",\
"symbol": "olong",\
"name": "Long Johnson",\
"activated_at": 1712562430\
},\
{\
"id": "dogita",\
"symbol": "doga",\
"name": "DOGITA",\
"activated_at": 1712562282\
},\
{\
"id": "bebe-on-base",\
"symbol": "bebe",\
"name": "Bebe on Base",\
"activated_at": 1712561709\
}\
]
###
[](https://docs.coingecko.com/reference/coins-list-new#note)
Note
* CoinGecko equivalent page: [https://www.coingecko.com/en/new-cryptocurrencies](https://www.coingecko.com/en/new-cryptocurrencies)
.
* Cache/Update Frequency: Every 30 seconds.
* Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-list-new#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Response
200 - application/json
List latest 200 coins
[](https://docs.coingecko.com/reference/coins-list-new#response-items-id)
id
string
coin ID
[](https://docs.coingecko.com/reference/coins-list-new#response-items-symbol)
symbol
string
coin symbol
[](https://docs.coingecko.com/reference/coins-list-new#response-items-name)
name
string
coin name
[](https://docs.coingecko.com/reference/coins-list-new#response-items-activated-at)
activated\_at
number
timestamp when coin was activated on CoinGecko
Example:
[ { "id": "long-johnson", "symbol": "olong", "name": "Long Johnson", "activated_at": 1712562430 }, { "id": "dogita", "symbol": "doga", "name": "DOGITA", "activated_at": 1712562282 }, { "id": "bebe-on-base", "symbol": "bebe", "name": "Bebe on Base", "activated_at": 1712561709 }]
Was this page helpful?
YesNo
[💼 Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers)
[Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets)
⌘I
---
# 💼 Past 24 Hour Trades by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/token-trades-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Trades
💼 Past 24 Hour Trades by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Past 24 Hour Trades by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/trades \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_22294076_0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad_71_1744957467",\
"type": "trade",\
"attributes": {\
"pool_address": "0x06da0fd433c1a5d7a4faa01111c044910a184553",\
"pool_dex": "sushiswap",\
"block_number": 22294076,\
"tx_hash": "0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad",\
"tx_from_address": "0x30a6f82f360c3bedc46fc8780082bcbde194ba7c",\
"from_token_amount": "7.988",\
"to_token_amount": "0.00504351846703413",\
"price_from_in_currency_token": "0.000631386888712335",\
"price_to_in_currency_token": "1.0",\
"price_from_in_usd": "0.997016722096761",\
"price_to_in_usd": "1579.09",\
"block_timestamp": "2025-04-18T06:24:23Z",\
"kind": "sell",\
"volume_in_usd": "7.96416957610893",\
"from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\
"to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"\
}\
}\
]
}
GET
/
networks
/
{network}
/
tokens
/
{token\_address}
/
trades
Try it
💼 Past 24 Hour Trades by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/trades \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_22294076_0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad_71_1744957467",\
"type": "trade",\
"attributes": {\
"pool_address": "0x06da0fd433c1a5d7a4faa01111c044910a184553",\
"pool_dex": "sushiswap",\
"block_number": 22294076,\
"tx_hash": "0x1ff33129a907411d2c5fff604a07d9d0b8ae9e73eaca9a1702548c8a6f9e4bad",\
"tx_from_address": "0x30a6f82f360c3bedc46fc8780082bcbde194ba7c",\
"from_token_amount": "7.988",\
"to_token_amount": "0.00504351846703413",\
"price_from_in_currency_token": "0.000631386888712335",\
"price_to_in_currency_token": "1.0",\
"price_from_in_usd": "0.997016722096761",\
"price_to_in_usd": "1579.09",\
"block_timestamp": "2025-04-18T06:24:23Z",\
"kind": "sell",\
"volume_in_usd": "7.96416957610893",\
"from_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",\
"to_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/token-trades-contract-address#note)
Note
* Exclusive for all [Paid Plan](https://www.coingecko.com/en/api/pricing)
Subscribers (Analyst, Lite, Pro and Enterprise).
* Cache/Update Frequency: Real-time (Cacheless) for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/token-trades-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/token-trades-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/token-trades-contract-address#parameter-token-address)
token\_address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required
token contract address
Example:
`"0xdac17f958d2ee523a2206206994597c13d831ec7"`
#### Query Parameters
[](https://docs.coingecko.com/reference/token-trades-contract-address#parameter-trade-volume-in-usd-greater-than)
trade\_volume\_in\_usd\_greater\_than
number
filter trades by trade volume in USD greater than this value Default value: 0
#### Response
200 - application/json
Get last 300 trades in past 24 hours from a token
[](https://docs.coingecko.com/reference/token-trades-contract-address#response-data)
data
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address)
[💼 Categories List](https://docs.coingecko.com/reference/categories-list)
⌘I
---
# Crypto Treasury Holdings by Coin ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/companies-public-treasury#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Public Treasury
Crypto Treasury Holdings by Coin ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Crypto Treasury Holdings by Coin ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/{entity}/public_treasury/{coin_id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"total_holdings": 123,
"total_value_usd": 123,
"market_cap_dominance": 123,
"companies": [\
{\
"name": "",\
"symbol": "",\
"country": "",\
"total_holdings": 123,\
"total_entry_value_usd": 123,\
"total_current_value_usd": 123,\
"percentage_of_total_supply": 123\
}\
]
}
GET
/
{entity}
/
public\_treasury
/
{coin\_id}
Try it
Crypto Treasury Holdings by Coin ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/{entity}/public_treasury/{coin_id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"total_holdings": 123,
"total_value_usd": 123,
"market_cap_dominance": 123,
"companies": [\
{\
"name": "",\
"symbol": "",\
"country": "",\
"total_holdings": 123,\
"total_entry_value_usd": 123,\
"total_current_value_usd": 123,\
"percentage_of_total_supply": 123\
}\
]
}
###
[](https://docs.coingecko.com/reference/companies-public-treasury#note)
Note
* The responses are sorted in descending order based on total holdings.
* CoinGecko equivalent page: [https://www.coingecko.com/en/treasuries/bitcoin](https://www.coingecko.com/en/treasuries/bitcoin)
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/companies-public-treasury#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/companies-public-treasury#parameter-entity)
entity
enum
required
public company or government entity
Available options:
`companies`,
`governments`
[](https://docs.coingecko.com/reference/companies-public-treasury#parameter-coin-id)
coin\_id
string
default:bitcoin
required
coin ID. example: bitcoin, ethereum, solana, binancecoin
Example:
`"bitcoin"`
#### Response
200 - application/json
Get public companies & governments crypto treasury holding data
* Option 1
* Option 2
[](https://docs.coingecko.com/reference/companies-public-treasury#response-one-of-0-total-holdings)
total\_holdings
number
required
total crypto holdings of companies
[](https://docs.coingecko.com/reference/companies-public-treasury#response-one-of-0-total-value-usd)
total\_value\_usd
number
required
total crypto holdings value in usd
[](https://docs.coingecko.com/reference/companies-public-treasury#response-one-of-0-market-cap-dominance)
market\_cap\_dominance
number
required
market cap dominance
[](https://docs.coingecko.com/reference/companies-public-treasury#response-one-of-0-companies)
companies
object\[\]
required
Show child attributes
Was this page helpful?
YesNo
[Entities List (ID Map)](https://docs.coingecko.com/reference/entities-list)
[Crypto Treasury Holdings by Entity ID](https://docs.coingecko.com/reference/public-treasury-entity)
⌘I
---
# Derivatives Exchange Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/derivatives-exchanges-id#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Derivatives
Derivatives Exchange Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Derivatives Exchange Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/derivatives/exchanges/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance (Futures)",
"open_interest_btc": 350139.89,
"trade_volume_24h_btc": "689202.84",
"number_of_perpetual_pairs": 587,
"number_of_futures_pairs": 38,
"image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452",
"year_established": 2019,
"country": null,
"description": "",
"url": "https://www.binance.com/",
"tickers": [\
{\
"symbol": "ASTERUSDT",\
"base": "ASTER",\
"target": "USDT",\
"coin_id": "aster-2",\
"target_coin_id": "tether",\
"trade_url": "https://www.binance.com/en/futures/ASTERUSDT",\
"contract_type": "perpetual",\
"last": 1.873,\
"h24_percentage_change": -5.246,\
"index": 1.87233812,\
"index_basis_percentage": -0.035,\
"bid_ask_spread": 0.00015339028296849384,\
"funding_rate": 0.009,\
"open_interest_usd": 212983050.43153304,\
"h24_volume": 664881040,\
"converted_volume": {\
"btc": "10920.642311073362831692974453819990348041448031650635228",\
"eth": "296686.4951027005826156931722170663818779309188174859084723041529715688",\
"usd": "1245690448.4593867566376892"\
},\
"converted_last": {\
"btc": "0.00001642495672770780594329020790519156682230169780695",\
"eth": "0.00044622492935382934459327216221576476579619554020894611233357497",\
"usd": "1.873553874328235855"\
},\
"last_traded": 1759214622,\
"expired_at": null\
}\
]
}
GET
/
derivatives
/
exchanges
/
{id}
Try it
Derivatives Exchange Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/derivatives/exchanges/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Binance (Futures)",
"open_interest_btc": 350139.89,
"trade_volume_24h_btc": "689202.84",
"number_of_perpetual_pairs": 587,
"number_of_futures_pairs": 38,
"image": "https://coin-images.coingecko.com/markets/images/466/small/binance_futures.jpg?1706864452",
"year_established": 2019,
"country": null,
"description": "",
"url": "https://www.binance.com/",
"tickers": [\
{\
"symbol": "ASTERUSDT",\
"base": "ASTER",\
"target": "USDT",\
"coin_id": "aster-2",\
"target_coin_id": "tether",\
"trade_url": "https://www.binance.com/en/futures/ASTERUSDT",\
"contract_type": "perpetual",\
"last": 1.873,\
"h24_percentage_change": -5.246,\
"index": 1.87233812,\
"index_basis_percentage": -0.035,\
"bid_ask_spread": 0.00015339028296849384,\
"funding_rate": 0.009,\
"open_interest_usd": 212983050.43153304,\
"h24_volume": 664881040,\
"converted_volume": {\
"btc": "10920.642311073362831692974453819990348041448031650635228",\
"eth": "296686.4951027005826156931722170663818779309188174859084723041529715688",\
"usd": "1245690448.4593867566376892"\
},\
"converted_last": {\
"btc": "0.00001642495672770780594329020790519156682230169780695",\
"eth": "0.00044622492935382934459327216221576476579619554020894611233357497",\
"usd": "1.873553874328235855"\
},\
"last_traded": 1759214622,\
"expired_at": null\
}\
]
}
###
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#tips)
Tips
* For `include_tickers` param, you may change the value to either `all` to include all the tickers or `unexpired` to include unexpired tickers in the responses. You may leave it blank to omit the tickers data.
###
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#note)
Note
* Cache / Update Frequency: every 30 seconds for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#parameter-id)
id
string
default:binance\_futures
required
derivative exchange ID \*refers to [`/derivatives/exchanges/list`](https://docs.coingecko.com/reference/derivatives-exchanges-list)
.
Example:
`"binance_futures"`
#### Query Parameters
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#parameter-include-tickers)
include\_tickers
enum
include tickers data
Available options:
`all`,
`unexpired`
#### Response
200 - application/json
Get derivative exchange data
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-name)
name
string
derivatives exchange name
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-open-interest-btc)
open\_interest\_btc
number
derivatives exchange open interest in BTC
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-trade-volume-24h-btc)
trade\_volume\_24h\_btc
number
derivatives exchange trade volume in BTC in 24 hours
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-number-of-perpetual-pairs)
number\_of\_perpetual\_pairs
number
number of perpetual pairs in the derivatives exchange
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-number-of-futures-pairs)
number\_of\_futures\_pairs
number
number of futures pairs in the derivatives exchange
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-image)
image
string
derivatives exchange image url
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-year-established-one-of-0)
year\_established
number | null
derivatives exchange established year
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-country-one-of-0)
country
string | null
derivatives exchange incorporated country
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-description)
description
string
derivatives exchange description
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-url)
url
string
derivatives exchange website url
[](https://docs.coingecko.com/reference/derivatives-exchanges-id#response-tickers)
tickers
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Derivatives Exchanges List with Data](https://docs.coingecko.com/reference/derivatives-exchanges)
[Derivatives Exchanges List (ID Map)](https://docs.coingecko.com/reference/derivatives-exchanges-list)
⌘I
---
# 💼 Trending Search Pools - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/trending-search-pools#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
💼 Trending Search Pools
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Trending Search Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/trending_search \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"trending_rank": 0,\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"volume_usd": {\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"network": {\
"data": {\
"id": "eth",\
"type": "network"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
},\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
pools
/
trending\_search
Try it
💼 Trending Search Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/trending_search \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"trending_rank": 0,\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"volume_usd": {\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"network": {\
"data": {\
"id": "eth",\
"type": "network"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
},\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/trending-search-pools#note)
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.
* Cache/Update frequency: every 60 seconds.
* 💼 Exclusive for [Paid Plan](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/trending-search-pools#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/trending-search-pools#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`, `network`
[](https://docs.coingecko.com/reference/trending-search-pools#parameter-pools)
pools
integer
number of pools to return, maximum 10 Default value: 4
#### Response
200 - application/json
Get trending search pools across all networks
[](https://docs.coingecko.com/reference/trending-search-pools#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/trending-search-pools#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Search Pools](https://docs.coingecko.com/reference/search-pools)
[Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address)
⌘I
---
# Crypto Treasury Holdings by Entity ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/public-treasury-entity#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Public Treasury
Crypto Treasury Holdings by Entity ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Crypto Treasury Holdings by Entity ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Strategy",
"id": "strategy",
"type": "company",
"symbol": "MSTR.US",
"country": "US",
"website_url": "https://www.strategy.com/",
"twitter_screen_name": "Strategy",
"holdings": [\
{\
"coin_id": "bitcoin",\
"amount": 638985,\
"percentage_of_total_supply": 3.043\
}\
]
}
GET
/
public\_treasury
/
{entity\_id}
Try it
Crypto Treasury Holdings by Entity ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Strategy",
"id": "strategy",
"type": "company",
"symbol": "MSTR.US",
"country": "US",
"website_url": "https://www.strategy.com/",
"twitter_screen_name": "Strategy",
"holdings": [\
{\
"coin_id": "bitcoin",\
"amount": 638985,\
"percentage_of_total_supply": 3.043\
}\
]
}
###
[](https://docs.coingecko.com/reference/public-treasury-entity#note)
Note
* CoinGecko equivalent page: [https://www.coingecko.com/en/treasuries/bitcoin](https://www.coingecko.com/en/treasuries/bitcoin)
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/public-treasury-entity#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/public-treasury-entity#parameter-entity-id)
entity\_id
string
default:strategy
required
public company or government entity ID \*refers to [`/entities/list`](https://docs.coingecko.com/reference/entities-list)
.
Example:
`"strategy"`
#### Response
200 - application/json
Get public companies & governments crypto treasury holding data
[](https://docs.coingecko.com/reference/public-treasury-entity#response-name)
name
string
entity name
[](https://docs.coingecko.com/reference/public-treasury-entity#response-id)
id
string
entity ID
[](https://docs.coingecko.com/reference/public-treasury-entity#response-type)
type
string
entity type: company or government
[](https://docs.coingecko.com/reference/public-treasury-entity#response-symbol)
symbol
string
stock market symbol for public company
[](https://docs.coingecko.com/reference/public-treasury-entity#response-country)
country
string
country code of company or government location
[](https://docs.coingecko.com/reference/public-treasury-entity#response-website-url)
website\_url
string
official website URL of the entity
[](https://docs.coingecko.com/reference/public-treasury-entity#response-twitter-screen-name)
twitter\_screen\_name
string
official Twitter handle of the entity
[](https://docs.coingecko.com/reference/public-treasury-entity#response-holdings)
holdings
object\[\]
list of cryptocurrency assets held by the entity
Show child attributes
Was this page helpful?
YesNo
[Crypto Treasury Holdings by Coin ID](https://docs.coingecko.com/reference/companies-public-treasury)
[Crypto Treasury Holdings Historical Chart Data by ID](https://docs.coingecko.com/reference/public-treasury-entity-chart)
⌘I
---
# Coin Tickers by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-id-tickers#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
Coin Tickers by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Bitcoin",
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether"\
}\
]
}
GET
/
coins
/
{id}
/
tickers
Try it
Coin Tickers by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/tickers \
--header 'x-cg-pro-api-key: '
200
Copy
{
"name": "Bitcoin",
"tickers": [\
{\
"base": "BTC",\
"target": "USDT",\
"market": {\
"name": "Binance",\
"identifier": "binance",\
"has_trading_incentive": false,\
"logo": "https://assets.coingecko.com/markets/images/52/small/binance.jpg?1706864274"\
},\
"last": 69476,\
"volume": 20242.03975,\
"cost_to_move_up_usd": 19320706.3958517,\
"cost_to_move_down_usd": 16360235.3694131,\
"converted_last": {\
"btc": 1.000205,\
"eth": 20.291404,\
"usd": 69498\
},\
"converted_volume": {\
"btc": 20249,\
"eth": 410802,\
"usd": 1406996874\
},\
"trust_score": "green",\
"bid_ask_spread_percentage": 0.010014,\
"timestamp": "2024-04-08T04:02:01+00:00",\
"last_traded_at": "2024-04-08T04:02:01+00:00",\
"last_fetch_at": "2024-04-08T04:03:00+00:00",\
"is_anomaly": false,\
"is_stale": false,\
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",\
"token_info_url": null,\
"coin_id": "bitcoin",\
"target_coin_id": "tether"\
}\
]
}
###
[](https://docs.coingecko.com/reference/coins-id-tickers#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to google sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
* You may specify the `exchange_ids` if you want to retrieve tickers for specific exchange only.
* You may include values such as `page` to specify which page of responses you would like to show.
* You may also flag to include more data such as exchange logo and depth.
###
[](https://docs.coingecko.com/reference/coins-id-tickers#note)
Note
* The tickers are paginated to 100 items.
* 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.
* When order is sorted by `volume`, _**converted\_volume**_ will be used instead of _**volume**_.
* Cache / Update Frequency: every 2 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-id-tickers#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-id)
id
string
default:bitcoin
required
coin ID \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
Example:
`"bitcoin"`
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-exchange-ids)
exchange\_ids
string
default:binance
exchange ID \*refers to [`/exchanges/list`](https://docs.coingecko.com/reference/exchanges-list)
.
Example:
`"binance"`
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-include-exchange-logo)
include\_exchange\_logo
boolean
include exchange logo, default: false
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-page)
page
number
page through results
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-order)
order
enum
use this to sort the order of responses, default: trust\_score\_desc
Available options:
`trust_score_desc`,
`trust_score_asc`,
`volume_desc`,
`volume_asc`
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-depth)
depth
boolean
include 2% orderbook depth, ie. `cost_to_move_up_usd` and `cost_to_move_down_usd` Default: false
[](https://docs.coingecko.com/reference/coins-id-tickers#parameter-dex-pair-format)
dex\_pair\_format
enum
set to `symbol` to display DEX pair base and target as symbols, default: `contract_address`
Available options:
`contract_address`,
`symbol`
#### Response
200 - application/json
Get coin tickers
[](https://docs.coingecko.com/reference/coins-id-tickers#response-name)
name
string
coin name
[](https://docs.coingecko.com/reference/coins-id-tickers#response-tickers)
tickers
object\[\]
list of tickers
Show child attributes
Was this page helpful?
YesNo
[Coin Data by ID](https://docs.coingecko.com/reference/coins-id)
[Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history)
⌘I
---
# Coin Historical Chart Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-id-market-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
Coin Historical Chart Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1711843200000,\
69702.3087473573\
],\
[\
1711929600000,\
71246.9514406015\
],\
[\
1711983682000,\
68887.7495158568\
]\
],
"market_caps": [\
[\
1711843200000,\
1370247487960.09\
],\
[\
1711929600000,\
1401370211582.37\
],\
[\
1711983682000,\
1355701979725.16\
]\
],
"total_volumes": [\
[\
1711843200000,\
16408802301.8374\
],\
[\
1711929600000,\
19723005998.215\
],\
[\
1711983682000,\
30137418199.6431\
]\
]
}
GET
/
coins
/
{id}
/
market\_chart
Try it
Coin Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/market_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1711843200000,\
69702.3087473573\
],\
[\
1711929600000,\
71246.9514406015\
],\
[\
1711983682000,\
68887.7495158568\
]\
],
"market_caps": [\
[\
1711843200000,\
1370247487960.09\
],\
[\
1711929600000,\
1401370211582.37\
],\
[\
1711983682000,\
1355701979725.16\
]\
],
"total_volumes": [\
[\
1711843200000,\
16408802301.8374\
],\
[\
1711929600000,\
19723005998.215\
],\
[\
1711983682000,\
30137418199.6431\
]\
]
}
###
[](https://docs.coingecko.com/reference/coins-id-market-chart#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to google sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
* You may use tools like [epoch converter](https://www.epochconverter.com/)
to convert human readable date to UNIX timestamp.
###
[](https://docs.coingecko.com/reference/coins-id-market-chart#note)
Note
* You may leave the interval params as empty for automatic granularity:
* 1 day from current time = **5-minutely** data
* 2 - 90 days from current time = **hourly** data
* above 90 days from current time = **daily** data (00:00 UTC)
* For **non-Enterprise plan subscribers** who would like to get hourly data, please leave the interval params empty for auto granularity.
* The **5-minutely** and **hourly** interval params are also exclusively available to **Enterprise plan subscribers,** bypassing auto-granularity:
* `interval=5m`: 5-minutely historical data (responses include information from the past 10 days, up until now).
* `interval=hourly`: hourly historical data (responses include information from the past 100 days, up until now).
* Cache / Update Frequency:
* Every 30 seconds for all the API plans (for last data point).
* The last completed UTC day (00:00) data is available **10 minutes after midnight** on the next UTC day (00:10).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-id-market-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/coins-id-market-chart#parameter-id)
id
string
default:bitcoin
required
coin ID \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
Example:
`"bitcoin"`
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-id-market-chart#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of market data \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/coins-id-market-chart#parameter-days)
days
string
default:1
required
data up to number of days ago You may use any integer or `max` for number of days
[](https://docs.coingecko.com/reference/coins-id-market-chart#parameter-interval)
interval
enum
data interval, leave empty for auto granularity
Available options:
`5m`,
`hourly`,
`daily`
[](https://docs.coingecko.com/reference/coins-id-market-chart#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
Get historical market data include price, market cap, and 24hr volume (granularity auto)
[](https://docs.coingecko.com/reference/coins-id-market-chart#response-prices)
prices
number\[\]\[\]
[](https://docs.coingecko.com/reference/coins-id-market-chart#response-market-caps)
market\_caps
number\[\]\[\]
[](https://docs.coingecko.com/reference/coins-id-market-chart#response-total-volumes)
total\_volumes
number\[\]\[\]
Was this page helpful?
YesNo
[Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history)
[Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range)
⌘I
---
# Crypto Treasury Holdings Historical Chart Data by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/public-treasury-entity-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Public Treasury
Crypto Treasury Holdings Historical Chart Data by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Crypto Treasury Holdings Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id}/{coin_id}/holding_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"holdings": [\
[\
1733097600000,\
402100\
],\
[\
1733616000000,\
423650\
]\
],
"holding_value_in_usd": [\
[\
1733097600000,\
39129037461.438065\
],\
[\
1733616000000,\
42272572276.103065\
]\
]
}
GET
/
public\_treasury
/
{entity\_id}
/
{coin\_id}
/
holding\_chart
Try it
Crypto Treasury Holdings Historical Chart Data by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id}/{coin_id}/holding_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"holdings": [\
[\
1733097600000,\
402100\
],\
[\
1733616000000,\
423650\
]\
],
"holding_value_in_usd": [\
[\
1733097600000,\
39129037461.438065\
],\
[\
1733616000000,\
42272572276.103065\
]\
]
}
###
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#tips)
Tips
* You may obtain the entity ID and coin ID (API IDs) via several ways:
* For `entity_id`:
* refers to respective public treasury entity page and find ‘API ID’.
* refers to [`/entities/list`](https://docs.coingecko.com/reference/entities-list)
endpoint.
* For `coin_id`:
* refers to respective coin page and find ‘API ID’.
* refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to google sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
###
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#note)
Note
* Data available from August 2020 onwards.
* Different API plans can access up to different historical periods via `days` param:
| Plan | Maximum period | `days` value availability |
| --- | --- | --- |
| Public/Demo | 1 year | `7, 14, 30, 90, 180, 365` |
| Basic | 2 years | `7, 14, 30, 90, 180, 365, 730` |
| Analyst and above | Full | `7, 14, 30, 90, 180, 365, 730, max` |
* To access longer historical periods, check out [our API plans here](https://www.coingecko.com/en/api/pricing)
* For `include_empty_intervals` param:
* When `false` (default): Only intervals with transaction data are returned.
* When `true`: All requested intervals are returned, populated with the most recent available transaction data.
* CoinGecko equivalent page: [https://www.coingecko.com/en/treasuries/companies/strategy](https://www.coingecko.com/en/treasuries/companies/strategy)
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#parameter-entity-id)
entity\_id
string
default:strategy
required
public company or government entity ID \*refers to [`/entities/list`](https://docs.coingecko.com/reference/entities-list)
.
Example:
`"strategy"`
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#parameter-coin-id)
coin\_id
string
default:bitcoin
required
coin ID. example: bitcoin, ethereum, solana, binancecoin
Example:
`"bitcoin"`
#### Query Parameters
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#parameter-days)
days
string
default:365
required
data up to number of days ago Valid values: `7, 14, 30, 90, 180, 365, 730, max`
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#parameter-include-empty-intervals)
include\_empty\_intervals
boolean
default:false
include empty intervals with no transaction data, default: false
#### Response
200 - application/json
Get public companies & governments crypto treasury holding historical chart data
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#response-holdings)
holdings
number\[\]\[\]
[](https://docs.coingecko.com/reference/public-treasury-entity-chart#response-holding-value-in-usd)
holding\_value\_in\_usd
number\[\]\[\]
Was this page helpful?
YesNo
[Crypto Treasury Holdings by Entity ID](https://docs.coingecko.com/reference/public-treasury-entity)
[Crypto Treasury Transaction History by Entity ID](https://docs.coingecko.com/reference/public-treasury-transaction-history)
⌘I
---
# Coin Price by Token Addresses - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/simple-token-price#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Simple
Coin Price by Token Addresses
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Price by Token Addresses
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/token_price/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
"usd": 67187.3358936566,
"usd_market_cap": 1317802988326.25,
"usd_24h_vol": 31260929299.5248,
"usd_24h_change": 3.63727894677354,
"last_updated_at": 1711356300
}
}
GET
/
simple
/
token\_price
/
{id}
Try it
Coin Price by Token Addresses
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/simple/token_price/{id} \
--header 'x-cg-pro-api-key: '
200
Copy
{
"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599": {
"usd": 67187.3358936566,
"usd_market_cap": 1317802988326.25,
"usd_24h_vol": 31260929299.5248,
"usd_24h_change": 3.63727894677354,
"last_updated_at": 1711356300
}
}
###
[](https://docs.coingecko.com/reference/simple-token-price#tips)
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`](https://docs.coingecko.com/reference/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.
###
[](https://docs.coingecko.com/reference/simple-token-price#note)
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](https://www.coingecko.com/)
and learn more about our price methodology [here](https://www.coingecko.com/en/methodology)
.
* Cache/Update Frequency: every 20 seconds for Pro API (Analyst, Lite, Pro, Enterprise).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/simple-token-price#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/simple-token-price#parameter-id)
id
string
default:ethereum
required
asset platform's ID \*refers to [`/asset_platforms`](https://docs.coingecko.com/reference/asset-platforms-list)
.
Example:
`"ethereum"`
#### Query Parameters
[](https://docs.coingecko.com/reference/simple-token-price#parameter-contract-addresses)
contract\_addresses
string
default:0x2260fac5e5542a773aa44fbcfedf7c193bc2c599
required
the contract addresses of tokens, comma-separated if querying more than 1 token's contract address
[](https://docs.coingecko.com/reference/simple-token-price#parameter-vs-currencies)
vs\_currencies
string
default:usd
required
target currency of coins, comma-separated if querying more than 1 currency. \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
[](https://docs.coingecko.com/reference/simple-token-price#parameter-include-market-cap)
include\_market\_cap
boolean
include market capitalization, default: false
[](https://docs.coingecko.com/reference/simple-token-price#parameter-include-24hr-vol)
include\_24hr\_vol
boolean
include 24hr volume, default: false
[](https://docs.coingecko.com/reference/simple-token-price#parameter-include-24hr-change)
include\_24hr\_change
boolean
include 24hr change default: false
[](https://docs.coingecko.com/reference/simple-token-price#parameter-include-last-updated-at)
include\_last\_updated\_at
boolean
include last updated price time in UNIX , default: false
[](https://docs.coingecko.com/reference/simple-token-price#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
price(s) of cryptocurrency
[](https://docs.coingecko.com/reference/simple-token-price#response-usd)
usd
number
price in USD
[](https://docs.coingecko.com/reference/simple-token-price#response-usd-market-cap)
usd\_market\_cap
number
market cap in USD
[](https://docs.coingecko.com/reference/simple-token-price#response-usd-24h-vol)
usd\_24h\_vol
number
24hr volume in USD
[](https://docs.coingecko.com/reference/simple-token-price#response-usd-24h-change)
usd\_24h\_change
number
24hr change in USD
[](https://docs.coingecko.com/reference/simple-token-price#response-last-updated-at)
last\_updated\_at
number
last updated timestamp
Was this page helpful?
YesNo
[Coin Price by IDs](https://docs.coingecko.com/reference/simple-price)
[Supported Currencies List](https://docs.coingecko.com/reference/simple-supported-currencies)
⌘I
---
# 🔥 Megafilter for Pools - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/pools-megafilter#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
🔥 Megafilter for Pools
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
🔥 Megafilter for Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
pools
/
megafilter
Try it
🔥 Megafilter for Pools
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812"\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/pools-megafilter#tips)
Tips
* Using `checks` param to filter pools based on various checks:
* `checks=no_honeypot` — Filter out Honeypot pools, using GoPlus Token Security and De.Fi Scanner.
* `checks=good_gt_score` — Show only pools with a GT Score of at least 75.
* `checks=on_coingecko` — Show only pools with tokens that are listed on CoinGecko.
* `checks=has_social` — Show only pools with their social links and token information updated.
* You may include values such as `page` to specify which page of responses you would like to show.
###
[](https://docs.coingecko.com/reference/pools-megafilter#note)
Note
* Trending rankings are determined by a combination of factors:
* User engagement on geckoterminal.com
* Market activity, such as trading volume and transactions
* Pool security and credibility, including liquidity and honeypot checks
* `dexes` param can only be used when **only 1`networks`** is specified.
* 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.
* Setting `include_unknown_honeypot_tokens=true` will include tokens with an ‘unknown’ honeypot status.
* Please note that this param only takes effect when `checks=no_honeypot` is specified.
* Cache/Update frequency: every 30 seconds.
* 💼 Exclusive for [Paid Plan](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/pools-megafilter#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`, `network`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-page)
page
integer
default:1
page through results Default value: 1
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-networks)
networks
string
filter pools by networks, comma-separated if more than one Network ID refers to [/networks](https://docs.coingecko.com/reference/networks-list)
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-dexes)
dexes
string
filter pools by DEXes, comma-separated if more than one DEX ID refers to [/networks/{network}/dexes](https://docs.coingecko.com/reference/dexes-list)
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sort)
sort
enum
default:h6\_trending
sort the pools by field Default value: h6\_trending
Available options:
`m5_trending`,
`h1_trending`,
`h6_trending`,
`h24_trending`,
`h24_tx_count_desc`,
`h24_volume_usd_desc`,
`m5_price_change_percentage_asc`,
`h1_price_change_percentage_asc`,
`h6_price_change_percentage_asc`,
`h24_price_change_percentage_asc`,
`m5_price_change_percentage_desc`,
`h1_price_change_percentage_desc`,
`h6_price_change_percentage_desc`,
`h24_price_change_percentage_desc`,
`fdv_usd_asc`,
`fdv_usd_desc`,
`reserve_in_usd_asc`,
`reserve_in_usd_desc`,
`pool_created_at_desc`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-fdv-usd-min)
fdv\_usd\_min
number
minimum fully diluted value in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-fdv-usd-max)
fdv\_usd\_max
number
maximum fully diluted value in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-reserve-in-usd-min)
reserve\_in\_usd\_min
number
minimum reserve in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-reserve-in-usd-max)
reserve\_in\_usd\_max
number
maximum reserve in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-h24-volume-usd-min)
h24\_volume\_usd\_min
number
minimum 24hr volume in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-h24-volume-usd-max)
h24\_volume\_usd\_max
number
maximum 24hr volume in USD
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-pool-created-hour-min)
pool\_created\_hour\_min
number
minimum pool age in hours
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-pool-created-hour-max)
pool\_created\_hour\_max
number
maximum pool age in hours
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-tx-count-min)
tx\_count\_min
integer
minimum transaction count
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-tx-count-max)
tx\_count\_max
integer
maximum transaction count
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-tx-count-duration)
tx\_count\_duration
enum
default:24h
duration for transaction count metric Default value: 24h
Available options:
`5m`,
`1h`,
`6h`,
`24h`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-buys-min)
buys\_min
integer
minimum number of buy transactions
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-buys-max)
buys\_max
integer
maximum number of buy transactions
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-buys-duration)
buys\_duration
enum
default:24h
duration for buy transactions metric Default value: 24h
Available options:
`5m`,
`1h`,
`6h`,
`24h`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sells-min)
sells\_min
integer
minimum number of sell transactions
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sells-max)
sells\_max
integer
maximum number of sell transactions
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sells-duration)
sells\_duration
enum
default:24h
duration for sell transactions metric Default value: 24h
Available options:
`5m`,
`1h`,
`6h`,
`24h`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-checks)
checks
string
default:no\_honeypot
filter options for various checks, comma-separated if more than one Available values: `no_honeypot`, `good_gt_score`, `on_coingecko`, `has_social`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-include-unknown-honeypot-tokens)
include\_unknown\_honeypot\_tokens
boolean
when `checks` includes `no_honeypot`, set to `true` to also include 'unknown honeypot' tokens. Default value: `false`
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-buy-tax-percentage-min)
buy\_tax\_percentage\_min
number
minimum buy tax percentage
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-buy-tax-percentage-max)
buy\_tax\_percentage\_max
number
maximum buy tax percentage
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sell-tax-percentage-min)
sell\_tax\_percentage\_min
number
minimum sell tax percentage
[](https://docs.coingecko.com/reference/pools-megafilter#parameter-sell-tax-percentage-max)
sell\_tax\_percentage\_max
number
maximum sell tax percentage
#### Response
200 - application/json
Get pools based on various filters across all networks
[](https://docs.coingecko.com/reference/pools-megafilter#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/pools-megafilter#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network)
[Search Pools](https://docs.coingecko.com/reference/search-pools)
⌘I
---
# Entities List (ID Map) - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/entities-list#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Public Treasury
Entities List (ID Map)
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Entities List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/entities/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "usbc",\
"symbol": "USBC.US",\
"name": "USBC",\
"country": "US"\
},\
{\
"id": "mara-holdings",\
"symbol": "MARA.US",\
"name": "MARA Holdings",\
"country": "US"\
}\
]
GET
/
entities
/
list
Try it
Entities List (ID Map)
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/entities/list \
--header 'x-cg-pro-api-key: '
200
Copy
[\
{\
"id": "usbc",\
"symbol": "USBC.US",\
"name": "USBC",\
"country": "US"\
},\
{\
"id": "mara-holdings",\
"symbol": "MARA.US",\
"name": "MARA Holdings",\
"country": "US"\
}\
]
###
[](https://docs.coingecko.com/reference/entities-list#note)
Note
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/entities-list#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/entities-list#parameter-entity-type)
entity\_type
enum
filter by entity type, default: false
Available options:
`company`,
`government`
[](https://docs.coingecko.com/reference/entities-list#parameter-per-page)
per\_page
integer
total results per page, default: 100 Valid values: 1...250
[](https://docs.coingecko.com/reference/entities-list#parameter-page)
page
integer
page through results, default: 1
#### Response
200 - application/json
List all entities with ID, name, symbol, and country
[](https://docs.coingecko.com/reference/entities-list#response-items-id)
id
string
entity ID
[](https://docs.coingecko.com/reference/entities-list#response-items-symbol)
symbol
string
ticker symbol of public company
[](https://docs.coingecko.com/reference/entities-list#response-items-name)
name
string
entity name
[](https://docs.coingecko.com/reference/entities-list#response-items-country)
country
string
country code
Example:
[ { "id": "usbc", "symbol": "USBC.US", "name": "USBC", "country": "US" }, { "id": "mara-holdings", "symbol": "MARA.US", "name": "MARA Holdings", "country": "US" }]
Was this page helpful?
YesNo
[Derivatives Exchanges List (ID Map)](https://docs.coingecko.com/reference/derivatives-exchanges-list)
[Crypto Treasury Holdings by Coin ID](https://docs.coingecko.com/reference/companies-public-treasury)
⌘I
---
# Crypto Treasury Transaction History by Entity ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/public-treasury-transaction-history#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Public Treasury
Crypto Treasury Transaction History by Entity ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Crypto Treasury Transaction History by Entity ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id}/transaction_history \
--header 'x-cg-pro-api-key: '
200
Copy
{
"transactions": [\
{\
"date": 1763337600000,\
"source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt27517abcb8f459e3/691aaadfcd08266e2ec6fbe9/form-8-k_11-17-2025.pdf",\
"coin_id": "bitcoin",\
"type": "buy",\
"holding_net_change": 8178,\
"transaction_value_usd": 835554438,\
"holding_balance": 649870,\
"average_entry_value_usd": 102171\
},\
{\
"date": 1762732800000,\
"source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/bltdba4fc803e019d1e/69114d2ecc0c83c2fa618ffc/form-8-k_11-10-2025.pdf",\
"coin_id": "bitcoin",\
"type": "buy",\
"holding_net_change": 487,\
"transaction_value_usd": 49945259,\
"holding_balance": 641692,\
"average_entry_value_usd": 102557\
}\
]
}
GET
/
public\_treasury
/
{entity\_id}
/
transaction\_history
Try it
Crypto Treasury Transaction History by Entity ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/public_treasury/{entity_id}/transaction_history \
--header 'x-cg-pro-api-key: '
200
Copy
{
"transactions": [\
{\
"date": 1763337600000,\
"source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt27517abcb8f459e3/691aaadfcd08266e2ec6fbe9/form-8-k_11-17-2025.pdf",\
"coin_id": "bitcoin",\
"type": "buy",\
"holding_net_change": 8178,\
"transaction_value_usd": 835554438,\
"holding_balance": 649870,\
"average_entry_value_usd": 102171\
},\
{\
"date": 1762732800000,\
"source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/bltdba4fc803e019d1e/69114d2ecc0c83c2fa618ffc/form-8-k_11-10-2025.pdf",\
"coin_id": "bitcoin",\
"type": "buy",\
"holding_net_change": 487,\
"transaction_value_usd": 49945259,\
"holding_balance": 641692,\
"average_entry_value_usd": 102557\
}\
]
}
###
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#tips)
Tips
* You may obtain the entity ID via several ways:
* refers to respective public treasury entity page and find ‘API ID’.
* refers to [`/entities/list`](https://docs.coingecko.com/reference/entities-list)
endpoint.
* `coin_ids` param allows you to filter transaction history by specific coin IDs, comma-separated if more than 1 coin. You may obtain the coin IDs via several ways:
* refers to respective coin page and find ‘API ID’.
* refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to google sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
###
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#note)
Note
* Data available from August 2020 onwards.
* Only Analyst plan and above can request with `page` value greater than `1`.
* To unlock multi-page access, check out [our API plans here](https://www.coingecko.com/en/api/pricing)
* CoinGecko equivalent page: [https://www.coingecko.com/en/treasuries/companies/strategy](https://www.coingecko.com/en/treasuries/companies/strategy)
* Cache / Update Frequency: every 5 minutes for all the API plans.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#parameter-entity-id)
entity\_id
string
default:strategy
required
public company or government entity ID \*refers to [`/entities/list`](https://docs.coingecko.com/reference/entities-list)
.
Example:
`"strategy"`
#### Query Parameters
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#parameter-per-page)
per\_page
number
default:100
total results per page, default: `100` Valid values: 1...250
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#parameter-page)
page
number
default:1
page through results, default: `1`
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#parameter-order)
order
enum
default:date\_desc
use this to sort the order of transactions, default: `date_desc`
Available options:
`date_desc`,
`date_asc`,
`holding_net_change_desc`,
`holding_net_change_asc`,
`transaction_value_usd_desc`,
`transaction_value_usd_asc`,
`average_cost_desc`,
`average_cost_asc`
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#parameter-coin-ids)
coin\_ids
string
filter transactions by coin IDs, comma-separated if querying more than 1 coin \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
#### Response
200 - application/json
Get public companies & governments crypto treasury transaction history
[](https://docs.coingecko.com/reference/public-treasury-transaction-history#response-transactions)
transactions
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Crypto Treasury Holdings Historical Chart Data by ID](https://docs.coingecko.com/reference/public-treasury-entity-chart)
[NFTs List (ID Map)](https://docs.coingecko.com/reference/nfts-list)
⌘I
---
# New Pools by Network - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/latest-pools-network#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
New Pools by Network
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
New Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/new_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
{network}
/
new\_pools
Try it
New Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/new_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/latest-pools-network#tips)
Tips
* You may include values such as `page` to specify which page of responses you would like to show.
###
[](https://docs.coingecko.com/reference/latest-pools-network#note)
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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
* GeckoTerminal equivalent page (example): [https://www.geckoterminal.com/explore/new-crypto-pools/solana](https://www.geckoterminal.com/explore/new-crypto-pools/solana)
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/latest-pools-network#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/latest-pools-network#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
#### Query Parameters
[](https://docs.coingecko.com/reference/latest-pools-network#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`
[](https://docs.coingecko.com/reference/latest-pools-network#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/latest-pools-network#parameter-include-gt-community-data)
include\_gt\_community\_data
boolean
include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false
#### Response
200 - application/json
Get latest pools on a network
[](https://docs.coingecko.com/reference/latest-pools-network#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/latest-pools-network#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[New Pools List](https://docs.coingecko.com/reference/latest-pools-list)
[🔥 Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter)
⌘I
---
# 💼 Global Market Cap Chart Data - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/global-market-cap-chart#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Global
💼 Global Market Cap Chart Data
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
💼 Global Market Cap Chart Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/global/market_cap_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"market_cap_chart": {
"market_cap": [\
[\
1741777205268,\
2766533155566\
],\
[\
1741780800808,\
2784800753369\
],\
[\
1741784401211,\
2819864149659\
]\
],
"volume": [\
[\
1741777205268,\
141144791036\
],\
[\
1741780800808,\
140341392201\
],\
[\
1741784401211,\
146221695370\
]\
]
}
}
GET
/
global
/
market\_cap\_chart
Try it
💼 Global Market Cap Chart Data
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/global/market_cap_chart \
--header 'x-cg-pro-api-key: '
200
Copy
{
"market_cap_chart": {
"market_cap": [\
[\
1741777205268,\
2766533155566\
],\
[\
1741780800808,\
2784800753369\
],\
[\
1741784401211,\
2819864149659\
]\
],
"volume": [\
[\
1741777205268,\
141144791036\
],\
[\
1741780800808,\
140341392201\
],\
[\
1741784401211,\
146221695370\
]\
]
}
}
###
[](https://docs.coingecko.com/reference/global-market-cap-chart#note)
Note
* CoinGecko equivalent page: [https://www.coingecko.com/en/global-charts](https://www.coingecko.com/en/global-charts)
.
* Data Granularity (auto):
* 1 day from now = **hourly** data
* 2 days & above from now = **daily** data
* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
* The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). The cache will **always expire at 00:05 UTC**. If you wish to get the latest daily data (00:00 UTC), you can make request at 00:05 UTC or later.
* Cache / Update Frequency: every 1 minute.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/global-market-cap-chart#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Query Parameters
[](https://docs.coingecko.com/reference/global-market-cap-chart#parameter-days)
days
enum
required
data up to number of days ago Valid values: any integer
Available options:
`1`,
`7`,
`14`,
`30`,
`90`,
`180`,
`365`,
`max`
[](https://docs.coingecko.com/reference/global-market-cap-chart#parameter-vs-currency)
vs\_currency
string
default:usd
target currency of market cap, default: usd \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
Example:
`"usd"`
#### Response
200 - application/json
Get cryptocurrency global market cap chart data
[](https://docs.coingecko.com/reference/global-market-cap-chart#response-market-cap-chart)
market\_cap\_chart
object
Show child attributes
Was this page helpful?
YesNo
[Global DeFi Market Data](https://docs.coingecko.com/reference/global-defi)
[Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price)
⌘I
---
# Top Pools by Network - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/top-pools-network#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
Top Pools by Network
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Top Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
{network}
/
pools
Try it
Top Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/top-pools-network#tips)
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](https://docs.coingecko.com/reference/pools-megafilter)
endpoint.
###
[](https://docs.coingecko.com/reference/top-pools-network#note)
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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
* GeckoTerminal equivalent page (example): [https://www.geckoterminal.com/solana/pools?sort=-24h\_transactions](https://www.geckoterminal.com/solana/pools?sort=-24h_transactions)
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/top-pools-network#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/top-pools-network#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
#### Query Parameters
[](https://docs.coingecko.com/reference/top-pools-network#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`
[](https://docs.coingecko.com/reference/top-pools-network#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/top-pools-network#parameter-sort)
sort
enum
sort the pools by field Default value: h24\_tx\_count\_desc
Available options:
`h24_tx_count_desc`,
`h24_volume_usd_desc`
[](https://docs.coingecko.com/reference/top-pools-network#parameter-include-gt-community-data)
include\_gt\_community\_data
boolean
include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false
#### Response
200 - application/json
Get top pools on a network
[](https://docs.coingecko.com/reference/top-pools-network#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/top-pools-network#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network)
[Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex)
⌘I
---
# Top Pools by Token Address - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/top-pools-contract-address#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Tokens
Top Pools by Token Address
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Top Pools by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"last_trade_timestamp": 1712534400\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
{network}
/
tokens
/
{token\_address}
/
pools
Try it
Top Pools by Token Address
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"last_trade_timestamp": 1712534400\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/top-pools-contract-address#tips)
Tips
* You may include values such as `page` to specify which page of responses you would like to show.
###
[](https://docs.coingecko.com/reference/top-pools-contract-address#note)
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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/top-pools-contract-address#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-token-address)
token\_address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required
token contract address
Example:
`"0xdac17f958d2ee523a2206206994597c13d831ec7"`
#### Query Parameters
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-include-inactive-source)
include\_inactive\_source
boolean
default:false
include tokens from inactive pools using the most recent swap, default: false
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/top-pools-contract-address#parameter-sort)
sort
enum
sort the pools by field Default value: h24\_volume\_usd\_liquidity\_desc
Available options:
`h24_volume_usd_liquidity_desc`,
`h24_tx_count_desc`,
`h24_volume_usd_desc`
#### Response
200 - application/json
Get top pools for a token
[](https://docs.coingecko.com/reference/top-pools-contract-address#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/top-pools-contract-address#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[💼 Trending Search Pools](https://docs.coingecko.com/reference/trending-search-pools)
[Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address)
⌘I
---
# Coin OHLC Chart by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-id-ohlc#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
Coin OHLC Chart by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin OHLC Chart by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/ohlc \
--header 'x-cg-pro-api-key: '
200
Copy
[\
[\
1709395200000,\
61942,\
62211,\
61721,\
61845\
],\
[\
1709409600000,\
61828,\
62139,\
61726,\
62139\
],\
[\
1709424000000,\
62171,\
62210,\
61821,\
62068\
]\
]
GET
/
coins
/
{id}
/
ohlc
Try it
Coin OHLC Chart by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/ohlc \
--header 'x-cg-pro-api-key: '
200
Copy
[\
[\
1709395200000,\
61942,\
62211,\
61721,\
61845\
],\
[\
1709409600000,\
61828,\
62139,\
61726,\
62139\
],\
[\
1709424000000,\
62171,\
62210,\
61821,\
62068\
]\
]
###
[](https://docs.coingecko.com/reference/coins-id-ohlc#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to Google Sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
* For historical chart data with better granularity, you may consider using [/coins/{id}/market\_chart](https://docs.coingecko.com/reference/coins-id-market-chart)
endpoint.
###
[](https://docs.coingecko.com/reference/coins-id-ohlc#note)
Note
* The timestamp displayed in the payload (response) indicates the end (or close) time of the OHLC data.
* Data granularity (candle’s body) is automatic:
* 1 - 2 days: 30 minutes
* 3 - 30 days: 4 hours
* 31 days and beyond: 4 days
* Cache / Update Frequency:
* Every 15 minutes for all the API plans
* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35).
* Exclusive **daily** and **hourly** candle interval parameter for all paid plan subscribers (`interval = daily`, `interval=hourly`)
* ‘**daily**’ interval is available for **1 / 7 / 14 / 30 / 90 / 180** days only.
* ‘**hourly**’ interval is available for **1 / 7 / 14 / 30 / 90** days only.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-id-ohlc#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/coins-id-ohlc#parameter-id)
id
string
default:bitcoin
required
coin ID \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
Example:
`"bitcoin"`
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-id-ohlc#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of price data \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/coins-id-ohlc#parameter-days)
days
enum
required
data up to number of days ago
Available options:
`1`,
`7`,
`14`,
`30`,
`90`,
`180`,
`365`,
`max`
[](https://docs.coingecko.com/reference/coins-id-ohlc#parameter-interval)
interval
enum
data interval, leave empty for auto granularity
Available options:
`daily`,
`hourly`
[](https://docs.coingecko.com/reference/coins-id-ohlc#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
Get coin's OHLC
Example:
[ [1709395200000, 61942, 62211, 61721, 61845], [1709409600000, 61828, 62139, 61726, 62139], [1709424000000, 62171, 62210, 61821, 62068]]
Was this page helpful?
YesNo
[Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range)
[💼 Coin OHLC Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-ohlc-range)
⌘I
---
# Coin Historical Chart Data within Time Range by ID - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/coins-id-market-chart-range#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Coins
Coin Historical Chart Data within Time Range by ID
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Coin Historical Chart Data within Time Range by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/market_chart/range \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1704067241331,\
42261.0406175669\
],\
[\
1704070847420,\
42493.2764087546\
],\
[\
1704074443652,\
42654.0731066594\
]\
],
"market_caps": [\
[\
1704067241331,\
827596236151.196\
],\
[\
1704070847420,\
831531023621.411\
],\
[\
1704074443652,\
835499399014.932\
]\
],
"total_volumes": [\
[\
1704067241331,\
14305769170.9498\
],\
[\
1704070847420,\
14130205376.1709\
],\
[\
1704074443652,\
13697382902.2424\
]\
]
}
GET
/
coins
/
{id}
/
market\_chart
/
range
Try it
Coin Historical Chart Data within Time Range by ID
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/coins/{id}/market_chart/range \
--header 'x-cg-pro-api-key: '
200
Copy
{
"prices": [\
[\
1704067241331,\
42261.0406175669\
],\
[\
1704070847420,\
42493.2764087546\
],\
[\
1704074443652,\
42654.0731066594\
]\
],
"market_caps": [\
[\
1704067241331,\
827596236151.196\
],\
[\
1704070847420,\
831531023621.411\
],\
[\
1704074443652,\
835499399014.932\
]\
],
"total_volumes": [\
[\
1704067241331,\
14305769170.9498\
],\
[\
1704070847420,\
14130205376.1709\
],\
[\
1704074443652,\
13697382902.2424\
]\
]
}
###
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#tips)
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`](https://docs.coingecko.com/reference/coins-list)
endpoint.
* refers to google sheets [here](https://docs.google.com/spreadsheets/d/1wTTuxXt8n9q7C4NDXqQpI3wpKu1_5bGVmP9Xz0XGSyU/edit?usp=sharing)
.
* Supports ISO date strings (`YYYY-MM-DD` or
`YYYY-MM-DDTHH:MM`, recommended for best compatibility) or UNIX timestamps.
###
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#note)
Note
* You may leave the interval params as empty for automatic granularity:
* 1 day from current time = **5-minutely** data
* 1 day from any time (except current time) = **hourly** data
* 2 - 90 days from any time = **hourly** data
* above 90 days from any time = **daily** data (00:00 UTC)
* For **non-Enterprise plan subscribers** who would like to get hourly data, please leave the interval params empty for auto granularity.
* The **5-minutely** and **hourly** interval params are also exclusively available to **Enterprise plan subscribers**, bypassing auto-granularity:
* `interval=5m`: 5-minutely historical data, supports up to **any 10 days** date range per request.
* `interval=hourly`: hourly historical data, supports up to **any 100 days** date range per request.
* Data availability:
* `interval=5m`: Available from 9 February 2018 onwards.
* `interval=hourly`: Available from 30 Jan 2018 onwards.
* Cache / Update Frequency:
Based on days range (all the API plans)
* 1 day = 30 seconds cache
* 2 -90 days = 30 minutes cache
* 90 days = 12 hours cache
* The last completed UTC day (00:00) is available 35 minutes after midnight on the next UTC day (00:35). The cache will always expire at 00:40 UTC.
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-id)
id
string
default:bitcoin
required
coin ID \*refers to [`/coins/list`](https://docs.coingecko.com/reference/coins-list)
.
Example:
`"bitcoin"`
#### Query Parameters
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-vs-currency)
vs\_currency
string
default:usd
required
target currency of market data \*refers to [`/simple/supported_vs_currencies`](https://docs.coingecko.com/reference/simple-supported-currencies)
.
Example:
`"usd"`
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-from)
from
string
default:2024-01-01
required
starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. use ISO date string for best compatibility
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-to)
to
string
default:2024-12-31
required
ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. use ISO date string for best compatibility
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-interval)
interval
enum
data interval, leave empty for auto granularity
Available options:
`5m`,
`hourly`,
`daily`
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#parameter-precision)
precision
enum
decimal place for currency price value
Available options:
`full`,
`0`,
`1`,
`2`,
`3`,
`4`,
`5`,
`6`,
`7`,
`8`,
`9`,
`10`,
`11`,
`12`,
`13`,
`14`,
`15`,
`16`,
`17`,
`18`
#### Response
200 - application/json
Get historical market data include price, market cap, and 24hr volume (granularity auto)
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#response-prices)
prices
number\[\]\[\]
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#response-market-caps)
market\_caps
number\[\]\[\]
[](https://docs.coingecko.com/reference/coins-id-market-chart-range#response-total-volumes)
total\_volumes
number\[\]\[\]
Was this page helpful?
YesNo
[Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart)
[Coin OHLC Chart by ID](https://docs.coingecko.com/reference/coins-id-ohlc)
⌘I
---
# Trending Pools by Network - CoinGecko API
[Skip to main content](https://docs.coingecko.com/reference/trending-pools-network#content-area)
[CoinGecko API home page](https://docs.coingecko.com/)
Search...
⌘K
Search...
Navigation
Pools
Trending Pools by Network
[Guides](https://docs.coingecko.com/)
[API Reference (Pro)](https://docs.coingecko.com/reference/authentication)
[API Reference (Demo)](https://docs.coingecko.com/v3.0.1/reference/authentication)
[Websocket (Beta)](https://docs.coingecko.com/websocket)
[Changelog](https://docs.coingecko.com/changelog)
Trending Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/trending_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
GET
/
networks
/
{network}
/
trending\_pools
Try it
Trending Pools by Network
cURL
Copy
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/trending_pools \
--header 'x-cg-pro-api-key: '
200
Copy
{
"data": [\
{\
"id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"type": "pool",\
"attributes": {\
"base_token_price_usd": "3653.12491645176",\
"base_token_price_native_currency": "1.0",\
"quote_token_price_usd": "0.998343707926245",\
"quote_token_price_native_currency": "0.000273040545093221",\
"base_token_price_quote_token": "3662.46",\
"quote_token_price_base_token": "0.00027304",\
"address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",\
"name": "WETH / USDC 0.05%",\
"pool_created_at": "2021-12-29T12:35:14Z",\
"fdv_usd": "11007041041",\
"market_cap_usd": null,\
"price_change_percentage": {\
"m5": "0",\
"m15": "0.21",\
"m30": "0.31",\
"h1": "0.51",\
"h6": "0.86",\
"h24": "7.71"\
},\
"transactions": {\
"m5": {\
"buys": 7,\
"sells": 2,\
"buyers": 7,\
"sellers": 2\
},\
"m15": {\
"buys": 19,\
"sells": 27,\
"buyers": 19,\
"sellers": 27\
},\
"m30": {\
"buys": 49,\
"sells": 61,\
"buyers": 45,\
"sellers": 57\
},\
"h1": {\
"buys": 97,\
"sells": 144,\
"buyers": 83,\
"sellers": 124\
},\
"h24": {\
"buys": 2966,\
"sells": 3847,\
"buyers": 1625,\
"sellers": 2399\
}\
},\
"volume_usd": {\
"m5": "868581.7348314",\
"m15": "2056262.885098",\
"m30": "4081230.098456",\
"h1": "16798158.0138526",\
"h6": "164054610.850188",\
"h24": "536545444.904535"\
},\
"reserve_in_usd": "163988541.3812",\
"sentiment_vote_positive_percentage": 0,\
"sentiment_vote_negative_percentage": 0,\
"community_sus_report": 0\
},\
"relationships": {\
"base_token": {\
"data": {\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token"\
}\
},\
"quote_token": {\
"data": {\
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",\
"type": "token"\
}\
},\
"dex": {\
"data": {\
"id": "uniswap_v3",\
"type": "dex"\
}\
}\
}\
}\
],
"included": [\
{\
"id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"type": "token",\
"attributes": {\
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",\
"name": "Wrapped Ether",\
"symbol": "WETH",\
"decimals": 18,\
"image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",\
"coingecko_coin_id": "weth"\
}\
}\
]
}
###
[](https://docs.coingecko.com/reference/trending-pools-network#tips)
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](https://docs.coingecko.com/reference/pools-megafilter)
endpoint.
###
[](https://docs.coingecko.com/reference/trending-pools-network#note)
Note
* Trending rankings are determined by a combination of factors:
* User engagement on geckoterminal.com
* Market activity, such as trading volume and transactions
* Pool security and credibility, including liquidity and honeypot checks
* 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](https://www.coingecko.com/en/api/pricing)
subscribers (Analyst plan or above).
* Cache/Update frequency: every 30 seconds.
* GeckoTerminal equivalent page (example): [https://www.geckoterminal.com/base/pools](https://www.geckoterminal.com/base/pools)
#### Authorizations
apiKeyAuthapiKeyQueryParam
[](https://docs.coingecko.com/reference/trending-pools-network#authorization-x-cg-pro-api-key)
x-cg-pro-api-key
string
header
required
#### Path Parameters
[](https://docs.coingecko.com/reference/trending-pools-network#parameter-network)
network
string
default:eth
required
network ID \*refers to [/networks](https://docs.coingecko.com/reference/networks-list)
Example:
`"eth"`
#### Query Parameters
[](https://docs.coingecko.com/reference/trending-pools-network#parameter-include)
include
string
default:base\_token
attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex`
[](https://docs.coingecko.com/reference/trending-pools-network#parameter-page)
page
integer
page through results Default value: 1
[](https://docs.coingecko.com/reference/trending-pools-network#parameter-duration)
duration
enum
duration to sort trending list by Default value: 24h
Available options:
`5m`,
`1h`,
`6h`,
`24h`
[](https://docs.coingecko.com/reference/trending-pools-network#parameter-include-gt-community-data)
include\_gt\_community\_data
boolean
include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false
#### Response
200 - application/json
Get trending pools on a network
[](https://docs.coingecko.com/reference/trending-pools-network#response-data)
data
object\[\]
Show child attributes
[](https://docs.coingecko.com/reference/trending-pools-network#response-included)
included
object\[\]
Show child attributes
Was this page helpful?
YesNo
[Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list)
[Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network)
⌘I
---