September 2025
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:Payload example:π Now Supporting Pooled Token Balance Data
The following endpoints now support additional pool token balance data by flagging this parameterinclude_composition=true
:- Specific Pool Data by Pool Address
- Multiple Pools Data by Pool Addresses
- Token Data by Token Address (requires
include=top_pools
parameter to be flagged together) - Tokens Data by Token Addresses (requires
include=top_pools
parameter to be flagged together)
π Other improvements
- Onchain 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
- Top Gainers & Losers endpoint now support to additional price change percentage data by flagging duration parameter. The available options are:
1h,24h,7d,14d,30d,60d,200d,1y
.-
Payload example:
-
Payload example:
- Exchange Tickers by ID endpoint now supports to sort tickers based on market cap, by flagging the
order
parameter.- Available options:
market_cap_desc
,market_cap_asc
- Available options:
August 2025
Improved Update Frequency for selected Pro-API On-chain Endpoints
ποΈ August 18, 2025[Changes below are applicable to all paid plan subscribers.]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 | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
Token Data by Token Address | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
Tokens Data by Token Addresses | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s |
Specific Pool Data by Pool Address | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s |
Multiple Pools Data by Pool Addresses | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s |
Pool OHLCV chart by Pool Address | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
Token OHLCV chart by Token Address | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
Past 24 Hour Trades by Pool Address | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s |
Past 24 Hour Trades by Token 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.
- 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.
Now Supported: Launchpad Data (Pump.fun & More), Granular OHLCV, and Honeypot Info
ποΈ August 05, 2025Weβ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 | solana | meteora-dbc |
Pump.fun | solana | pump-fun |
Raydium Launchpad (LetsBonkFun) | solana | raydium-launchlab |
Boop.fun | solana | boop-fun |
Virtuals (Base) | base | virtuals-base |
- Token Data by Token Address
- Tokens Data by Token Addresses
- Specific Pool Data by Pool Address
- Multiple Pools Data by Pool Addresses
sort=pool_created_at_desc
Request example (Get latest pools on Pump.fun):[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 |
- 1s
- 15s
- 30s
π― 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:Example Payload:[Pro-API Exclusive] New Filtering Option in Megafilter
Previously, thePools 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.
π Expanded Pool Data
Endpoint: Pool Tokens Info by Pool AddressBy addinginclude=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
June 2025
SOL Currency Is Now Supported for CoinGecko Endpoints
ποΈ June 19, 2025Weβ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 granularityImproved endpoints:
- Coin Price by IDs
- Coin Price by Token Addresses
- Supported Currencies List
- Top Gainers & Losers
- Coins List with Market Data
- Coin Data by ID
- Coin Historical Data by ID
- Coin Historical Chart Data by ID
- Coin Historical Chart Data within Time Range by ID
- Coin OHLC Chart by ID
- Coin OHLC Chart within Time Range by ID
- Coin Data by Token Address
- Coin Historical Chart Data by Token Address
- Coin Historical Chart Data within Time Range by Token Address
- Trending Search List
- Crypto Global Market Data
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.
[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.
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 underincluded
relationships.quote_token
, including but not limited to:May 2025
Upcoming Change Notice: Removal of normalized_volume_btc Data
ποΈ May 30, 2025Notice: Upcoming Change to CoinGecko API Endpoints - Removal ofnormalized_volume_btc Data
Effective Date: 16 June 2025Affected Endpoints: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: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 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, 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:By flagginginclude_volume_breakdown=true
, you can surface the following data:- net_buy_volume_usd
- buy_volume_usd
- sell_volume_usd
JSON
Improved Endpoint - On-Chain OHLCV endpoint
Pool OHLCV chart by Pool Address endpoint now supports to include empty intervals by flagginginclude_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.
Improved Endpoints - Support Large Images
The following endpoints now support more size options for coin logo image:Sample Response:Improved Endpoints - Support Normalized Supply Data
The following endpoints now supportnormalized_total_supply
:Sample Response:Improved Endpoints - Support Pool βNameβ and βFeeβ Data
The following endpoints now supportpool_name
and pool_fee
:Sample Response:Improved Endpoints - Support Symbols of DEX Pairs
The following endpoints now allow to flagdex_pair_format=symbol
to return DEX pair symbols instead of contract address.Sample Response:April 2025
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, 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 thepools
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 subscribers (Analyst plan & above).[Pro-API Exclusive] Improved Endpoint - Trending Search List
Paid plan subscribers (Analyst plan & above) can now use Trending Search List endpoint and flagshow_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: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. 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 |
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.
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, 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)
Upcoming Change Notice: Removal of twitter_followers Data
ποΈ April 25, 2025Notice: Upcoming Change to CoinGecko API Endpoints - Removal oftwitter_followers Data
Effective Date: 15 May 2025Affected Endpoints: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: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.March 2025
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 theholders
parameter to retrieve up to top 50 holders data.Network supported:- EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base
- Solana
- Sui
- TON
- Ronin
- 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.
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) endpoint and flagstatus=inactive
.Note: these endpoints below are exclusive for Enterprise plan customers only.Improved endpoints:- Circulating Supply Chart by ID
- Circulating Supply Chart within Time Range by ID
- Total Supply Chart by ID
- Total Supply Chart within time range by ID
Onchain Pool Data endpoints - Locked Liquidity
Now supportlocked_liquidity_percentage
data.Improved endpoints: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.
- 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
Onchain Simple Token Price endpoint - Market Cap to FDV Fallback
The Onchain Simple Token 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.
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 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.- Effective from 02:00 UTC, March 25, 2025:
- Effective from 02:00 UTC, March 26, 2025:
- Effective from 02:00 UTC, March 27, 2025:
- 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.
- 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.
Multiple Improvement: Holders data, Pool Stats, Simple Token Price
ποΈ March 14, 2025Onchain Token Info endpoints - Holders data
Now support the following holder data (Beta):- holders count
- top holders distribution percentage
Onchain Pool Data endpoints - More Data Support
Now support the following data:price_change_percentage
: m15, m30volume_usd
: m15, m30transactions
: h6
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)
February 2025
New Megafilter Endpoint, 200+ Chains Supported: Hyperliquid, Abstract, Berachain & MOAR!
ποΈ February 27, 2025Powered 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π 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
- 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π Live Filtering on GeckoTerminal
Update Frequency Improvements for selected Pro-API endpoints
ποΈ February 14, 2025[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers 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/ | 02:00 UTC, February 24, 2025 | 60s | 30s |
Onchain /networks/../tokens/multi/ | 06:00 UTC, February 24, 2025 | 60s | 30s |
Onchain /networks/../pools/../ohlcv | 02:00 UTC, February 25, 2025 - Enterprise plan subscribers only | 60s | 30s |
Onchain /networks/../pools/../ohlcv | 02:00 UTC, February 26, 2025 - Analyst/Lite/Pro plan subscribers | 60s | 30s |
- 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.
- 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.
Enhanced Onchain Metadata, Increased Max Address Limit for Multi Endpoints, Improved Exchange Tickers Sorting
ποΈ February 09, 2025Onchain Metadata: Improved Coverage
Previously: Payload may return βmissing.pngβ forimage_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:- Trending Pools List
- Trending Pools by Network
- Specific Pool Data by Pool Address
- Multiple Pools Data by Pool Addresses
- Top Pools by Network
- Top Pools by Dex
- New Pools by Network
- New Pools List
- Search Pools
- Top Pools by Token Address
- Token Data by Token Address
- Tokens Data by Token Addresses
- Token Info by Token Address
- Pool Tokens Info by Pool Address
- Most Recently Updated Tokens List
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: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 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
, thena->Z
.
January 2025
Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter
ποΈ January 27, 2025Onchain 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:- Search Pools
- Top Pools by Token Address
- Trending Pools List
- Trending Pools by Network
- New Pools by Network
- New Pools List
- Top Pools by Network
- Top Pools by Dex
Onchain Trades: Added Token Filter
Endpoint: Past 24 Hour Trades by Pool AddressPreviously: 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
Multiple Improvements: Onchain Token Price, NFT Market Cap
ποΈ January 24, 2025Onchain Simple Token Price: Added Market Cap and 24h Volume Data
Endpoint: Token Price by Token Addresses- You can now flag
include_market_cap=true
andinclude_24hr_vol=true
to retrieve market cap and 24h trading volume data. e.g.
json
NFT Data: Added βMarket Cap Rankβ
You can now obtain themarket_cap_rank
data of NFT collections via the following endpoints:example
Removal of Unsupported Categories
ποΈ January 23, 2025Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API
Summary
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 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 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, 2025Whatβs New?
Weβve improved the Pool OHLCV Chart by Pool 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.
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 thebefore_timestamp
parameter to fetch additional data.Update to Total Supply of POW Coins
ποΈ January 15, 2025Whatβ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).
- Total Supply: Now reflects the actual number of mined coins.
Affected endpoints that contain βtotal_supplyβ data:
- Current Data
- Historical Darta
Timeline:
Bitcoin: Updated on Jan 14, 2025Other PoW Coins: Scheduled for Jan 22, 2025- Bitcoin Cash
- Litecoin
- Ethereum Classic
- Bitcoin SV
- Zcash
- eCash
- Dash
- Verus Coin
- Ravencoin
- Kadena
- Decred
- Flux (Zelcash)
- DigiByte
- Quantum Resistant Ledger
- Komodo
- Groestlcoin
- Firo
- Litecoin Cash
- LuckyCoin
- Enecuum
- Wownero
- Radiant
- Tidecoin
- Handshake
- Neoxa
- Vertcoin
- Feathercoin
- Bitcore
- Phoenixcoin
- BitcoinZ
- Hush
- DigitalNote
- EquityPay
- Evadore
- Swap
- DeVault
- AXE
- Iridium
- X-Cash
- Bolivarcoin
- uPlexa
- WorldCoin (WDC)
Improved Update Frequency for selected Pro-API endpoints
ποΈ January 13, 2025[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers 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 | 30s | 20s |
CoinGecko /simple/token_price | 30s | 20s |
Onchain /simple/networks/../token_price | 60s | 30s |
Onchain /networks/../pools/../trades | 60s | 30s |
Onchain /networks/../pools/.. | 60s | 30s |
Onchain /networks/../pools/multi/.. | 60s | 30s |
- 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.
- 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.
Improved 5-minutely data for Historical Chart Data endpoints
ποΈ January 09, 2025For 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
- Coin Historical Chart Data within Time Range by ID
- Coin Historical Chart Data by Token Address
- Coin Historical Chart Data within Time Range by Token Address
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 onwardsinterval=hourly
: Available from 30 Jan 2018 onwards
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)
December 2024
Added: Onchain Categories Data, CG data improvements
ποΈ December 24, 2024NEW: Onchain Categories : Get Categories on GeckoTerminal.com
This new 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 subscribers only.
NEW: Onchain Catergory Pools: Get Pools of a specific Category
This new Pools by Category ID 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 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:Payload example:json
Onchain New Pools Data: Bug Fixed
Previously, this /networks/new_pools 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) endpoint, by flaggingstatus=inactive
Payload example:json
CoinGecko Historical Chart Data: Faster Last UTC Day (00:00) Data Update
For Coin Historical Chart Data by ID 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, 2024As 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 β ]**For full list of FAQs and updated infomation, please refer here
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.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. 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/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
- /coins/id/contract/contract_address
- /coins/id/contract/contract_address/market_chart
- /coins/id/contract/contract_address/market_chart/range
- /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 SheetsYou may also identify the list of bridged coins via API: you may also use /categories/list endpoint to look for bridged categories such as:- bridged-usdc
- bridged-wbtc
- bridged-weth
Enhancing Your Access to Even Fresher Data!
ποΈ December 16, 2024[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers 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 | 30s | 20s |
CoinGecko /simple/token_price | 30s | 20s |
Onchain /simple/networks/../token_price | 60s | 30s |
Onchain /networks/../pools/../trades | 60s | 30s |
Onchain /networks/../pools/.. | 60s | 30s |
Onchain /networks/../pools/multi/.. | 60s | 30s |
- 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.
- 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.
Multiple Improvements: Onchain Trending Pools, CG New Currencies Support, Snapshot, Exchange Info
ποΈ December 15, 2024Onchain 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, usingduration
parameter. e.g. duration=5m
- Trending Pools List: query all the trending pools across all networks on GeckoTerminal
- Trending Pools by 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: query latest price in selected currencies, by coin id
- Coin Price by Token Addresses: query latest price in selected currencies, by token address
- BTC-to-Currency Exchange Rates: query BTC exchange rates with other currencies
- Colombia | COP
- Kenya | KES
- Romania | RON
- Dominican Republic | DOP
- Costa Rica | CRC
- Honduras | HNL
- Zambia | ZMW
- El Salvador | SVC
- Bosnia and Herzegovina | BAM
- Peru | PEN
- Guatemala | GTQ
- Lebanon | LBP
- Armenian Dram | AMD
CG Coin Info: Included Snapshot URL
Coin Data by ID now includes Snapshot link, e.g.json
CG Exchange Info: Included Number of Coins and Pairs
https://docs.coingecko.com/reference/exchanges-id now includes βcoinsβ and βpairsβ, e.g.json
October 2024
Multiple Improvements: Onchain Simple Price, Onchain Recently Updated Info, NFT Collection Data
ποΈ October 09, 2024Onchain: Simple Price - Increased Token Address Limit from 30 to 100
Token Price by Token Addresses 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 now allows to filter by blockchain network, by flagging thenetwork
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 endpoint.
NFT Collection Data - Included Banner Image
NFTs Collection Data by ID now provides banner image of a NFT collection.View banner image example on: https://www.coingecko.com/en/nft/pudgy-penguinsSeptember 2024
Multiple Improvements: Global Market Chart, Asset Platforms, Coin Categories, Historical Supply Chart
ποΈ September 26, 2024Global Market Chart - Improved Daily Data Update
Previously, for Global Market Cap Chart Data endpoint , 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) now provides the logos of blockchain networks.For example:Coins Categories - Included Ids of Top 3 Coins
Coins Categories List with Market Data now provides coins id of the top 3 coins of a category.For example: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.- π Circulating Supply Chart by ID
- π Circulating Supply chart within Time Range by ID
- π Total Supply Chart by ID
- π Total Supply Chart within time range by ID
Improvement of update frequency for OHLC endpoints
ποΈ September 04, 2024The cache & update frequency of the following endpoints have been improved from every 30 minutes to every 15 minutes:August 2024
Included new fields - NFT data
ποΈ August 18, 2024Weβve added βuser_favorites_countβ, and βathβ (all-time-high) related data to the following NFT endpoints:Example of responses:May 2024
Introduced /coins/id/ohlc/range endpoint
ποΈ May 10, 2024Weβve introduced a new endpoint /coins//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, 2024Weβve expanded functionality to include support for theinterval=hourly
parameter within the /coins//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
April 2024
Added support for inactive coins in /coins/list and historical data endpoints
ποΈ April 30, 2024Weβve now enhanced the /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
- /coins//history
- /coins//market_chart
- /coins//market_chart/range
- /coins//contract//market_chart
- /coins//contract//market_chart/range
March 2024
February 2024
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
-
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 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 endpoint now includes the base and target token metadata in the response
Example of responses:JSON
Introduced /networks/network/trending_pools endpoint (Onchain/GT)
ποΈ February 19, 2024Trending Pools endpoint, /networks//trending_pools 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, 2024Added new endpoint to search for pools /search/pools based on keywords passed into query.January 2024
December 2023
Deprecated response fields for /coins/id
ποΈ December 13, 2023The following data is now deprecated for /coins/ 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, 2023Weβve introduced Historical Total Supply data to Enterprise plan subscribers via these 2 exclusive endpoints:- /coins//total_supply_chart : get historical total supply of a coin, by number of days away from now.
- /coins//total_supply_chart/range : get historical total supply of a coin, within a range of timestamp.
Included more trending coins
ποΈ December 07, 2023Weβve expanded the capabilities of the /search/trending 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, 2023Pool 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 responseNovember 2023
Multiple Improvements
ποΈ November 21, 2023The web_slug data is now available in the following endpoints.This addition allows users to accurately link to a CoinGecko coin page using www.coingecko.com/en/.Example of responses:JSON
JSON
Introduced /simple/networks/network/token_price/addresses endpoint (Onchain/GT)
ποΈ November 10, 2023Inspired by CoinGecko API most popular endpoint, we have launched the /simple/networks//token_price/, simple endpoint. Simply pass in addresses of any tokens on supported blockchain and get price data for itIntroduced /networks/network/pools/pool_address/trades endpoint (Onchain/GT)
ποΈ November 08, 2023You can now get the latest 300 trades in the past 24 hours of a given pool from this endpoint /networks//pools//trades. You may optionally filter by trade size as well. You can now build your own telegram bot alert!October 2023
Introduced new endpoints (Onchain/GT)
ποΈ October 23, 2023You 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
- To fetch information of a specific token use /networks//tokens//info
- If you like to get token information of the most recently updated tokens, use /tokens/info_recently_updated
September 2023
Included new fields (Onchain/GT)
ποΈ September 11, 2023Pool 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 valuesIntroduced new endpoints (Onchain/GT)
ποΈ September 06, 2023Added new endpoints to allow querying multiple pools and tokens in a single API call. /networks/network/pools/multi/addresses and /networks/network/tokens/multi/addressesJune 2023
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, 2023The uses of βprecisionβ parameter allows to specify price data in full or 0-18 decimals, and previously was only made available for /simple/price and /simple/token_price/ endpoints.This parameter is now supported for more endpoints as listed below:- /coins/markets
- /coins/market_chart
- /coins/market_chart/range
- /coins//contract//market_chart
- /coins//contract//market_chart/range
- /coins//ohlc
Multiple Improvements
ποΈ June 01, 2023Weβ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 endpoint
- Near Protocol contract address (e.g. wrap.near) is now supported for /coins//contract/ endpoint
May 2023
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 endpoint
Added interval daily params to /coins/id/ohlc
ποΈ May 22, 2023The /coins//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.April 2023
Included new fields
ποΈ April 26, 2023Weβve added βwatchlist_portfolio_usersβ field to /coins/ endpoint responses.This refers to number of users who added the coin into a watchlist or portfolio.Example of responses:JSON
Increased Rate Limit (Onchain/GT)
ποΈ April 19, 2023Weβve increased the rate limit of Public Plan from 10 calls per minute to 30 calls per minuteMultiple 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
- /networks//new_pools endpoint added to query new pools discovered for a network
- /networks/new_pools endpoint added to query new pools discovered across all networks
Included new fields
ποΈ April 03, 2023Weβve added βsymbolβ field to these NFT endpoints responses:Example of responses:JSON
March 2023
Included new fields
ποΈ March 27, 2023Weβve added βlinksβ field (e.g. homepage, twitter, discord) to these NFT endpoints responses:Example of responses:Introduced /coins/top_gainer_losers endpoint
ποΈ March 23, 2023Weβve added /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/ now returns more granularityday,
hour
, minute
and multiple aggregatesFebruary 2023
Multiple Improvements
ποΈ February 23, 2023Weβ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 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.
- Previously, the /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, 2023Weβve introduced the /exchange//volume_chart/range endpoint for Paid Plan Subscribers.This exclusive feature allows users to query full historical volume data of an exchange.January 2023
Introduced /coins/list/new endpoint
ποΈ January 09, 2023Weβve introduced the /coins/list/new endpoint for Paid Plan Subscribers.This exclusive feature allows users to query the latest 200 coins on CoinGecko.December 2022
Introduced new NFT endpoints
ποΈ December 15, 2022Weβve added exclusive NFTs beta endpoints for Paid Plan Subscribers. These endpoints include:- /nfts//market_chart (for historical market data)
- /nfts//market_chart (for historical market data based on contract address)
- /nfts//tickers (to retrieve floor price and volume information on each marketplace)
October 2022
Introduced new endpoints and improvements
ποΈ October 25, 2022Weβve added new /global/market_cap_chart endpoint for Paid Plan Subscribers. This allows users to query historical market cap chart data.Weβve introduced a filter param, currently limited to βnft,β to the /asset_platforms endpoint. This allows users to obtain a comprehensive list of NFT blockchain networks supported by CoinGecko.A new parameter, βprecision,β has been added to the /simple/price endpoint. This enhancement allows users to customize the returned coin price based on the specified number of decimals or retrieve it with full decimal precision.September 2022
Introduced NFTs and Token Lists Endpoints
ποΈ September 29, 2022Weβve introduced beta endpoints for NFTs:- /nfts/list
- /nfts/
- /nfts//contract/
- /nfts/market (Exclusive for Enterprise Plan Subscribers)
Included new fields to multiple endpoints
ποΈ September 06, 2022We have added a new field, βdetails_platform,β to the /coins/ and /coins//contract/ endpoints responses.The field contains information about the asset platform, specifically the βdecimal_places,β providing details on the decimal places associated with the asset platform.Example of responses:JSON
February 2022
Introduced historical circulating supply endpoint
ποΈ February 21, 2022Weβve introduced the Historical Circulating Supply endpoint exclusively for Enterprise plan subscribers.These endpoints provide access to historical circulating supply data of a specific coin.September 2020
Deprecated event endpoint
ποΈ September 07, 2020Event endpoint deprecatedIncluded new fields to /exchanges/id
ποΈ September 07, 2020Weβve enhanced the /exchanges/ endpoint by adding two new fields, public_notice and alert_notice.These additions provide information on public notices and alerts associated with the specified exchange.Example of responses:JSON
August 2020
Introduced /search/trending endpoint
ποΈ August 03, 2020Weβve introduced new /search/trending endpoint.This addition allows users to access trending search data including coins on CoinGecko.Introduced category filter params to /coins/markets
ποΈ August 03, 2020Weβve implemented a category filter, currently limited to βdecentralized_finance_defi,β for the /coins/markets endpoint.This addition allows users to filter and retrieve market data specifically related to decentralized finance (DeFi) within the endpoint.July 2020
Introduced /coins/id/ohlc endpoint
ποΈ July 15, 2020Weβve introduced new /coins//ohlc endpoint.This endpoint allows you to retrieve Open, High, Low, and Close (OHLC) data for a specific coin.April 2020
Included new fields to /coins/markets
ποΈ April 23, 2020Weβve introduced three new fields atl, atl_change_percentage, and atl_date to the responses of /coins/markets endpoint.These additions provide valuable data on the all-time low (atl) price, percentage change since the all-time low, and the date of the all-time low for improved analysis and insights.Example of responses:March 2020
Improved /coins/id/tickers
ποΈ March 31, 2020Starting from April 14th, 2020, thereβs a crucial update to the /coins//tickers API endpoint. Previously, the converted_last value represented the converted price per coin in USD. Now, it will accurately reflect the market price of the base currency itself.For example, if querying coins/tether/tickers, and thereβs a BTC/USDT ticker pair, the old converted_last might show 6491.51 USD. After the update, it will return 1, representing the actual market price of Tether.If you utilize converted_last for calculations, be aware of potential breaking changes and take necessary actions. If itβs solely for display, no action is required, as this update ensures a more accurate representation of the intended value.Example of responses:JSON
January 2020
Updated params for /derivatives endpoint
ποΈ January 09, 2020We have made updates to theinclude_tickers
parameter for /derivatives/exchanges/ endpoint.Please refer to the documentation for a comprehensive list of available values for this parameterNovember 2019
Introduced finance and derivatives endpoints
ποΈ November 08, 2019We have introduced finance and derivatives endpoints to our API.Feel free to explore these new features, and your feedback and suggestions are highly encouraged.July 2019
Introduced /exchanges/id/volume_chart
ποΈ July 22, 2019We have added a new endpoint, /exchanges//volume_chart.This endpoint is designed to provide volume chart data related to the specified exchange, with the information presented in BTC.Example of responses:JSON
June 2019
Set default params value for tickers endpoints
ποΈ June 13, 2019Weβve implemented an enhancement to the /coins//tickers and /exchanges//tickers endpoints.Now, users have the flexibility to use the optionalorder
parameter, which defaults to trust_score_desc.This addition allows users to customize the sorting order of tickers based on trust score, providing a more tailored experience for data retrieval.Included new trust score field to tickers
ποΈ June 12, 2019We have addedtrust_score
field to /coins//tickers and /exchanges//tickers endpointsExample of responses:/coins//tickers endpointJSON
JSON
Included new fields
ποΈ June 10, 2019We have introduced two new fields, last_traded_at and last_fetched_at, to the ticker data.The existing timestamp field, which currently reflects the last_traded_at value, will be retained for compatibility.However, please be advised that the timestamp field may be deprecated in the future.We recommend updating your application to make use of the newly added last_traded_at and last_fetched_at fields for improved accuracy and compatibility.Example of responses:/coins//tickers endpointJSON
JSON
April 2019
Introduced optional params for multiple endpoints
ποΈ April 10, 2019Addedcoin_ids
optional params to /exchanges//tickers endpoint. Users can specify the coin_ids
to get the exchanges tickers for a particular coin.Added exchange_ids
optional params to /coins//tickers endpoint. Users can specify the exchange_ids
to get the coin tickers on a particular exchange.January 2019
Introduced /exchanges/list endpoint
ποΈ January 24, 2019We have introduced a new endpoint: /exchanges/list.This addition expands the functionality of our API, allowing users to retrieve a list of available exchanges on CoinGecko with id and name easily.Set default params value for /coins/markets
ποΈ January 18, 2019To minimize bandwidth usage, the /coins/markets endpoint will now automatically default to retrieving data for the top 100 coins by market cap when the βidsβ parameter is left blank.This implies that the Order parameters will automatically default tomarket_cap_desc
, ensuring a descending order based on market cap. The Per_Page
parameters will default to 100, optimizing the response by providing data for the 100 results of coins per page if no coinβs ids are mentioned.This enhancement aims to streamline the user experience while conserving bandwidth resources.December 2018
Reduced the usage of /coins (paginated) endpoint
ποΈ December 10, 2018Recognizing the limitations of the paginated /coins feature, particularly its inability to query for specific coins, we have temporarily hidden it from the documentation to prevent confusion for new users.Rest assured, there are no plans to remove or deprecate it in the near future.Instead, we encourage you to transition to the more versatile /coins/list and coins/ options for a more tailored and efficient experience.Increased Requests Per Minute (RPM)
ποΈ December 07, 2018Due the substantial volume of requests weβve received, we are adjusting the API rate for Public API to 100 requests per minute, allowing for over 4 million requests per month.The increased capacity aims to accommodate the growing demand and ensure a smoother experience for our users.November 2018
Introduced /simple endpoints
ποΈ November 30, 2018In response to user feedback requesting reduced API payloads, we have introduced our /simple endpoints, offering simplified responses.Additional simple endpoints will be released soon to further enhance user experience.Improved /exchanges/id endpoint
ποΈ November 13, 2018To ensure the consistent uptime and scalability of this API, we can only provide a maximum of 100 tickers in the responses for a specific exchange through the /exchanges/ endpoint.Improved /coins/id endpoint
ποΈ November 07, 2018To ensure the consistent uptime and scalability of this API, we can only provide a maximum of 100 tickers in the responses across multiple exchanges through the /coins/ endpoint.JSON