What’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.

Note: access to data beyond the past 6 months is only available to Paid Plan 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.

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:


Timeline:

Bitcoin: Updated on Jan 14, 2025

Other PoW Coins: Scheduled for Jan 22, 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.

EndpointsPrevious Update FrequencyCurrent Update Frequency
CoinGecko /simple/price30s20s
CoinGecko /simple/token_price30s20s
Onchain /simple/networks/../token_price60s30s
Onchain /networks/../pools/../trades60s30s
Onchain /networks/../pools/..60s30s
Onchain /networks/../pools/multi/..60s30s

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] .

CoinGecko API Team

For the following 4 historical chart endpoints, the data of the last 48 hours from now is no longer excluded.

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)

NEW: 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'.


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:

  1. Token Info by Token Address
  2. Pool Tokens Info by Pool Address

Payload example:

  "categories": [
    "Doge",
    "Baby",
    "Animal"
  ],
  "gt_category_ids": [
    "doge",
    "baby",
    "animal"

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 flagging status=inactive

Payload example:

  {
    "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:


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.

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 ✅]

**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

  • /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

You may also identify the list of bridged coins via API: you may also use /categories/list endpoint to look for bridged categories such as:

  1. bridged-usdc
  2. bridged-wbtc
  3. bridged-weth

Then you may use /coins/market endpoint to retrieve the list of coins

[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.

EndpointsCurrent Update FrequencyNew Update Frequency
CoinGecko /simple/price30s20s
CoinGecko /simple/token_price30s20s
Onchain /simple/networks/../token_price60s30s
Onchain /networks/../pools/../trades60s30s
Onchain /networks/../pools/..60s30s
Onchain /networks/../pools/multi/..60s30s

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] .

CoinGecko API Team

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


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:

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 now includes Snapshot link, e.g.

"snapshot_url": "https://snapshot.org/#/lido-snapshot.eth",

CG Exchange Info: Included Number of Coins and Pairs

https://docs.coingecko.com/reference/exchanges-id now includes "coins" and "pairs", e.g.

 "coins": 384,
 "pairs": 1281,

Onchain: 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 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 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-penguins

{
  "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",
..

Global 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:

    "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 now provides coins id of the top 3 coins of a category.

For example:

"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
  2. 👑 Circulating Supply chart within Time Range by ID
  3. 👑 Total Supply Chart by ID
  4. 👑 Total Supply Chart within time range by ID