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

We've added 'user_favorites_count', and 'ath' (all-time-high) related data to the following NFT endpoints:

Example of responses:

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

We've introduced a new endpoint /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.

We've expanded functionality to include support for the interval=hourly parameter within the /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

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

Additionally, historical data for inactive coins can be queried using their IDs in the following endpoints:


Please note that these features are available exclusively for paid plan subscribers only