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

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

CoinGecko API Team

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
2. Trending Pools by Network
3. Specific Pool Data by Pool Address
4. Multiple Pools Data by Pool Addresses
5. Top Pools by Network
6. Top Pools by Dex
7. New Pools by Network
8. New Pools List
9. Search Pools
10. Top Pools by Token Address
11. Token Data by Token Address
12. Tokens Data by Token Addresses
13. Token Info by Token Address
14. Pool Tokens Info by Pool Address
15. Most Recently Updated Tokens List

Improved endpoints with metadata (images, websites, description, socials):

1. Token Info by Token Address
2. Pool Tokens Info by Pool Address
3. Most Recently Updated Tokens List

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
• Coin Data by Token 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
2. Multiple Pools Data by Pool 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 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.

Onchain Pools Data: Supported 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
2. Top Pools by Token Address
3. Trending Pools List
4. Trending Pools by Network
5. New Pools by Network
6. New Pools List
7. Top Pools by Network
8. Top Pools by Dex

Onchain Trades: Added Token Filter

Endpoint: Past 24 Hour Trades by Pool 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:

?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

Onchain Simple Token Price: Added Market Cap and 24h Volume Data

Endpoint: Token Price by Token Addresses

• You can now flag include_market_cap=true and include_24hr_vol=true to retrieve market cap and 24h trading volume data. e.g.

{
  "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
• NFTs Collection Data by Contract Address

  "market_cap_rank": 75,

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

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.

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:

• Current Data
  • Coin Data by ID
  • Coins List with Market Data
• Historical Darta
  • Total Supply Chart by ID
  • Total Supply chart within time range by ID

Timeline:

Bitcoin: Updated on Jan 14, 2025

Other 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)

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

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 .

CoinGecko API Team

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

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

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

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:

• Exchange Volume Chart by ID
• Exchange Volume Chart within Time Range by ID

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.