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.
EndpointsEffective Date & TimeCurrent Update FrequencyNew Update Frequency
Token Price by Token AddressesTuesday, 02:00 UTC, September 2, 202530s10s
Token Data by Token AddressTuesday, 02:00 UTC, September 2, 202530s10s
Tokens Data by Token AddressesTuesday, 02:00 UTC, September 2, 202530s10s
Specific Pool Data by Pool AddressWednesday, 02:00 UTC, September 3, 202530s10s
Multiple Pools Data by Pool AddressesWednesday, 02:00 UTC, September 3, 202530s10s
Pool OHLCV chart by Pool AddressThursday, 02:00 UTC, September 4, 202530s10s
Token OHLCV chart by Token AddressThursday, 02:00 UTC, September 4, 202530s10s
Past 24 Hour Trades by Pool AddressThursday, 02:00 UTC, September 4, 202530s10s
Past 24 Hour Trades by Token AddressThursday, 02:00 UTC, September 4, 202530s10s

What This Means for You:

  • Fresher Data, Quicker: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!
  • No Extra Credits for Cached Data: If your request hits the cache (now updated every 10 seconds for endpoints above), there will be no additional credits charged - just like before.
Things to Keep in Mind:
  • If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
  • To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration.
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to soonaik@coingecko.com .CoinGecko API Team

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:
Launchpadnetwork id (API)dex id (API)
Meteora DBCsolanameteora-dbc
Pump.funsolanapump-fun
Raydium Launchpad (LetsBonkFun)solanaraydium-launchlab
Boop.funsolanaboop-fun
Virtuals (Base)basevirtuals-base
Improved endpoints to track launchpad data:More launchpad-specific data will be supported soon for the endpoints above!Tips: use megafilter endpoint to retrieve latest launchpad data, by flagging sort=pool_created_at_descRequest example (Get latest pools on Pump.fun):
https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool_created_at_desc&x_cg_pro_api_key=YOUR_KEY

[Pro-API Exclusive] More Granular OHLCV Data

On-chain OHLCV endpoints now support higher frequency intervals, down to 1-second granularity.
TimeframeAggregate (Before)Aggregate (New)
day11
hour1, 4, 121, 4, 12
minute1, 5, 151, 5, 15
secondn/a1, 15, 30
Improved Endpoints:New interval supported:
  • 1s
  • 15s
  • 30s
Example Request (Get the last 100 1-second intervals for a pool on Ethereum):
https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/second?aggregate=1&limit=100&include_empty_intervals=false&x_cg_pro_api_key=YOUR_KEY

🍯 Enhanced Honeypot Information

We’ve expanded our honeypot detection features to provide more comprehensive risk assessment. You can now check if a token is a potential honeypot using the main info endpoints.Improved Endpoints:Example Payload:
{
 "mint_authority": null,
 "freeze_authority": null,
 "is_honeypot": true  // possible values: true / false / unknown
}

[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.
Example Request (Get trending pools that are not confirmed honeypots, including those with an unknown status):
https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&sort=h6_trending&checks=no_honeypot&include_unknown_honeypot_tokens=true&x_cg_pro_api_key=YOUR_KEY

πŸ“ˆ Expanded Pool Data

Endpoint: Pool Tokens Info by Pool AddressBy adding include=pool to your request on the pool tokens endpoint, you can now retrieve additional context about the pool itself.
  • Base and quote token address
  • Sentiment vote percentage (positive and negative)
  • Community suspicious reports count
Payload Example:
  "included": [
    {
      "id": "eth_0x06da0fd433c1a5d7a4faa01111c044910a184553",
      "type": "pool",
      "attributes": {
        "base_token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "quote_token_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "sentiment_vote_positive_percentage": 100,
        "sentiment_vote_negative_percentage": 0,
        "community_sus_report": 0
      }
    }
  ]
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 granularity

Improved endpoints:

Example: price of Bitcoin in Solana, using Coin Price by IDs endpoint.
{
  "bitcoin": {
    "sol": 720.21
  }
}
Example: historical daily price, market cap and volume of Trump in Solana, using Coin Historical Chart Data by ID endpoint.
{
  "prices": [
    [
      1750118400000,
      0.0640701365814472
    ],
    [
      1750204800000,
      0.0644263929356261
    ],
    [
      1750291200000,
      0.0639713357587322
    ],
    [
      1750326151000,
      0.06415963364804504
    ]
  ],
  "market_caps": [
    [
      1750118400000,
      12843589.584485611
    ],
    [
      1750204800000,
      12882547.839086628
    ],
    [
      1750291200000,
      12793790.726102708
    ],
    [
      1750326151000,
      12826247.390733324
    ]
  ],
  "total_volumes": [
    [
      1750118400000,
      2425793.780846796
    ],
    [
      1750204800000,
      2055697.9106767387
    ],
    [
      1750291200000,
      1871087.4334618242
    ],
    [
      1750326151000,
      2008278.189223005
    ]
  ]
}

New Endpoints & Improvements: Historical Token Holders Chart, OHLCV by Token Address, Multi-pool Token Data Support

πŸ—“οΈ June 09, 2025

[Pro-API Exclusive] New Endpoint - Historical Token Holders Chart by Token Address

This new endpoint allows you to get the historical token holders chart based on the provided token contract address on a network.
  • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
Check it out now: Historical Token Holders Chart by Token Address

[Pro-API Exclusive] New Endpoint - Token OHLCV chart by Token Address

This endpoint allows you to get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network.
  • This endpoint will return OHLCV data of the most liquid pool of the specified token. You may use this endpoint Top Pools by Token Address to check the top pools of a token.
Check it out now: Token OHLCV chart by Token Address

Improved Endpoints - Support Multi-pool Token Data

Previously, we only surfaced 1 quote token for pools with more than 2 tokens. With this new improvements, for pools that have 2 or more tokens:
  • Extra quote tokens being listed under a new key relationships.quote_tokens
  • If include=quote_token is flagged, the extra quote tokens will be also listed under included
    "relationships": {  
      "base_token": {
        "data": {
          "id": "eth_0x40d16fc0246ad3160ccc09b8d0d3a2cd28ae6c2f",
          "type": "token"
        }
      },
      "quote_token": {
        "data": {
          "id": "eth_0x8353157092ed8be69a9df8f95af097bbf33cb2af",
          "type": "token"
        }
      },
      "quote_tokens": {
        "data": [
          {
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "type": "token"
          },
          {
            "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
            "type": "token"
          }
This improvement is applicable to all onchain pool endpoints that support relationships.quote_token, including but not limited to:
May 2025

Upcoming Change Notice: Removal of normalized_volume_btc Data

πŸ—“οΈ May 30, 2025Notice: Upcoming Change to CoinGecko API Endpoints - Removal ofnormalized_volume_btc DataEffective 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": 47765.5886637453
  },
After the effective date, the trade_volume_24h_btc_normalized field will no longer be present in the API responses for these endpoints.Action Required:If your applications or integrations currently rely on the trade_volume_24h_btc_normalized data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 16 June 2025 to avoid potential errors or data discrepancies.

New Endpoint & Improvements: On-Chain Trades, Net Buy Volume, and More

πŸ—“οΈ May 29, 2025

[Pro-API Exclusive] New Endpoint - On-chain Trades by Token Address

Previously, the Past 24 Hour Trades by Pool Address 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 flagging include_volume_breakdown=true , you can surface the following data:
  • net_buy_volume_usd
  • buy_volume_usd
  • sell_volume_usd
Sample Response:
JSON
{
  "data": {
    "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
    "type": "pool",
    "attributes": {
      ...
      },
      "net_buy_volume_usd": {
        "m5":  "-40796.577553965",
        "m15": "-69765.771189161",
        "m30": "-88014.095440243",
        "h1":   "0.000000000000",
        "h6":   "1884879.921855301",
        "h24":  "17555422.243003801"
      },
      "buy_volume_usd": {
        "m5":  "30597.433165473",
        "m15": "139531.542378324",
        "m30": "396063.429481099",
        "h1":  "969922.728762430",
        "h6":  "10366839.570204150",
        "h24": "52666266.729011402"
      },
      "sell_volume_usd": {
        "m5":  "71394.010719438",
        "m15": "209297.313567485",
        "m30": "484077.524921342",
        "h1":  "969922.728762430",
        "h6":  "8481959.648348849",
        "h24": "35110844.486007601"
      },

Improved Endpoint - On-Chain OHLCV endpoint

Pool OHLCV chart by Pool Address endpoint now supports to include empty intervals by flagging include_empty_intervals=true .
  • By default, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded (or skipped) from the response.
  • This new parameter option provides the flexibility to get padded data, when there’s no trade data.
Sample Response:
{
  "data": {
    "id": "81da0682-1c4f-445a-9bed-9b5454004df5",
    "type": "ohlcv_request_response",
    "attributes": {
      "ohlcv_list": [
        [
          1744712700,
          0.000212149802253853,
          0.000212173305907688,
          0.000212149802253853,
          0.000212173305907688,
          46.48164903882
        ],
        [
          1744712400,
          0.000212149802253853,  πŸ‘ˆ O β€” Follow previous Close value
          0.000212149802253853,  πŸ‘ˆ H β€” Follow previous Close value
          0.000212149802253853,  πŸ‘ˆ L β€” Follow previous Close value
          0.000212149802253853,  πŸ‘ˆ C β€” Follow previous Close value
          0.0  πŸ‘ˆ V β€” Set to zero
        ],
        [
          1744712100,
          0.000210532522666822,
          0.000212149802253853,
          0.000210532522666822,
          0.000212149802253853,  πŸ‘ˆ Previous Close value
          46.4765
        ],
...
}

Improved Endpoints - Support Large Images

The following endpoints now support more size options for coin logo image:Sample Response:
  "data": {
    "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
    "type": "token",
    "attributes": {
...
      "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
      "image": {
        "thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661",
        "small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661",
        "large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661"
      },

Improved Endpoints - Support Normalized Supply Data

The following endpoints now support normalized_total_supply:Sample Response:
      "decimals": 6,
      "total_supply": "49999156520373530.0",
      "normalized_total_supply": "49999156520.37353",

Improved Endpoints - Support Pool β€˜Name’ and β€˜Fee’ Data

The following endpoints now support pool_name and pool_fee:Sample Response:
        "name": "WETH / USDC 0.05%",
        "pool_name": "WETH / USDC",
        "pool_fee_percentage": "0.05",

Improved Endpoints - Support Symbols of DEX Pairs

The following endpoints now allow to flag dex_pair_format=symbol to return DEX pair symbols instead of contract address.Sample Response:
// before
{
      "base": "0X8FC8F8269EBCA376D046CE292DC7EAC40C8D358A",
      "target": "0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48",
      "market": {
        "name": "Uniswap V2 (Ethereum)",
        "identifier": "uniswap_v2",
...
}

// now when "dex_pair_format=symbol" is flagged
{
      "base": "DFI",
      "target": "USDC",
      "market": {
        "name": "Uniswap V2 (Ethereum)",
        "identifier": "uniswap_v2",
...
}
April 2025
πŸ—“οΈ April 25, 2025With 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 the pools parameter to retrieve up to top 10 pools data.Tips: you may flag include=base_token to retrieve the trending tokens data.Note: this exclusive endpoint is available for our API paid plan subscribers (Analyst plan & above).Paid plan subscribers (Analyst plan & above) can now use Trending Search List endpoint and flag show_max parameter to retrieve more trending coins, NFTs and coin categories on CoinGecko.com.
Trending DataPublic API (Demo plan)Paid API (Analyst plan & above)
Coins1530
NFTs710
Coin Categories610

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 IdsSymbolName
bitcoinbtcBitcoin
tetherusdtTether
usd-coinusdcUSDC
Lookup Priority: When multiple lookup parameters are provided, the system applies the following priority order: id (highest) > name > symbol (lowest).Filtering by Symbol withinclude_tokensThe include_tokensparameter has been added to provide flexibility when filtering by symbol:
  • include_tokens=top : Returns only the top market cap token for the specified symbol.
  • include_tokens=all: Returns all tokens that share the specified symbol.
Example Request & Data:
Request ExampleToken Data ReturnedRemarks
pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&symbols=btc&include_tokens=top1. BitcoinWhen 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=all1. 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)
per-page: 250
total:16989

Upcoming Change Notice: Removal of twitter_followers Data

πŸ—“οΈ April 25, 2025Notice: Upcoming Change to CoinGecko API Endpoints - Removal oftwitter_followers DataEffective 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:
"community_data": {  
  "twitter_followers": 7694251,
  // ... other community data points ...
}
After the effective date, the twitter_followers field will no longer be present in the API responses for these endpoints.Action Required:If your applications or integrations currently rely on the twitter_followers data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 15 May 2025 to avoid potential errors or data discrepancies.Important Note Regarding Previously Storedtwitter_followers Data:Please be aware that if you have previously stored twitter_followers data obtained from the CoinGecko API and archived it within your own systems, you are solely responsible for its continued use and any implications thereof.We appreciate your understanding as we adapt to changes in third-party platforms to maintain the stability and reliability of our API. If you have any questions or require further clarification, please do not hesitate to contact our support team.
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 the holders parameter to retrieve up to top 50 holders data.Network supported:
  • EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base
  • Solana
  • Sui
  • TON
  • Ronin
πŸ‘‰ Visit the endpoint reference page - Top Token Holders by Token Address to learn more and try it out now!Note: this exclusive endpoint is available for our API paid plan subscribers (Analyst plan & above).
  • The holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
  • For Solana tokens, the maximum number of retrievable top holders data is 40 instead of 50.
Tips: You may also use the following endpoints to retrieve token holders count and top holders distribution percentage data:

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 flag status=inactive.Note: these endpoints below are exclusive for Enterprise plan customers only.Improved endpoints:

Onchain Pool Data endpoints - Locked Liquidity

Now support locked_liquidity_percentage data.Improved endpoints:
{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "3653.12491645176",
        "base_token_price_native_currency": "1.0",
..
        "volume_usd": {
          "m5": "868581.7348314",
          "h1": "16798158.0138526",
          "h6": "164054610.850188",
          "h24": "536545444.904535"
        },
        "reserve_in_usd": "163988541.3812",
        "locked_liquidity_percentage": "99.82"
      },

Onchain Token Info endpoints - GT Score, Mint Authority, Freeze Authority

The following Token Info endpoints now provide more security related information:
  • GeckoTerminal Score Details - Learn more about GT Score here.
    • Pool - Combination of pool signals such as honeypot risk, buy/sell tax, proxy contract, liquidity amount, and whether the liquidity is locked.
    • Transaction - Total number of transactions and trading volume in the last 24 hours.
    • Creation - Age of the pool since creation. The longer, the better it is for the score.
    • Info - Submitted social info and metadata to the token.
    • Holders - Distribution of tokens among unique addresses.
  • Mint Authority
  • Freeze Authority
Improved endpoints:
        "gt_score": 92.6605504587156,    
        "gt_score_details": {
          "pool": 0,
          "transaction": 32.2,
          "creation": 0,
          "info": 0,
          "holders": 0
        }
        "mint_authority": "no",   
        "freeze_authority": "no" 

Onchain Simple Token Price endpoint - Market Cap to FDV Fallback

The Onchain Simple Token Price endpoint now supports fallback option for Market Cap to return FDV value, when the Market Cap value is not available.Notes:
  • If the token’s market cap is not verified by the CoinGecko team, the onchain endpoints will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
  • Market Cap can be verified by and sourced from CoinGecko, and the number may be higher than FDV as it may include Market Cap of tokens issued on other blockchain network.
If you require the Market Cap key (market_cap_usd) to return FDV value (as seen on GeckoTerminal.com) when Market Cap data is unavailable, please specify this parameter marketcap_fdv_fallback=true.

Update Frequency Improvements for selected Pro-API endpoints (March 2025)

πŸ—“οΈ March 14, 2025[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers only.]Dear CoinGecko API paid plan subscribers,We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting 02:00 UTC, March 25, 2025, the edge cache duration for the following endpoints will be reduced from 60s to 30s, allowing you to retrieve updated data more frequently.
  1. Effective from 02:00 UTC, March 25, 2025:
    1. Trending Pools List
    2. Trending Pools by Network
    3. Top Pools by Network
    4. Top Pools by Dex
  2. Effective from 02:00 UTC, March 26, 2025:
    1. New Pools by Network
    2. New Pools List
    3. Megafilter for Pools
    4. Search Pools
  3. Effective from 02:00 UTC, March 27, 2025:
    1. Top Pools by Token Address
    2. Most Recently Updated Tokens List
    3. Pools by Category ID
What This Means for You:
  • Fresher Data, Quicker: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!
  • No Extra Credits for Cached Data: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before.
Things to Keep in Mind:
  • If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
  • To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration.
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to soonaik@coingecko.com .CoinGecko API Team

Multiple Improvement: Holders data, Pool Stats, Simple Token Price

πŸ—“οΈ March 14, 2025

Onchain Token Info endpoints - Holders data

Now support the following holder data (Beta):
  • holders count
  • top holders distribution percentage
Improved endpoints:
    "holders": {
      "count": 1432761,
      "distribution_percentage": {
        "top_10": "1.3019",
        "11_20": "0.1024",
        "21_40": "0.095",
        "rest": "98.5007"
      },
      "last_updated": "2025-03-06T01:21:18Z"

Onchain Pool Data endpoints - More Data Support

Now support the following data:
  • price_change_percentage: m15, m30
  • volume_usd: m15, m30
  • transactions: h6
Improved endpoints:
        "price_change_percentage": {
          "m5": "0.06",
          "m15": "0.06",
          "m30": "0.89",
          "h1": "-4.31",
          "h6": "-1.02",
          "h24": "3.32"
        },
        "transactions": {
          "m5": {
            "buys": 0,
            "sells": 2,
            "buyers": 0,
            "sellers": 2
          },
          "m15": {
            "buys": 0,
            "sells": 2,
            "buyers": 0,
            "sellers": 2
          },
          "m30": {
            "buys": 0,
            "sells": 3,
            "buyers": 0,
            "sellers": 3
          },
          "h1": {
            "buys": 1,
            "sells": 23,
            "buyers": 1,
            "sellers": 7
          },
          "h6": {
            "buys": 60,
            "sells": 38,
            "buyers": 23,
            "sellers": 18
          },
          "h24": {
            "buys": 206,
            "sells": 138,
            "buyers": 96,
            "sellers": 77
          }
        },
        "volume_usd": {
          "m5": "130.5119858698",
          "m15": "130.5119858698",
          "m30": "177.109036156",
          "h1": "4942.2463835639",
          "h6": "28362.2127269542",
          "h24": "112426.585893123"
        }

Onchain Simple Token Price endpoint - Liquidity & Price Change Percentage data

Now supports the following optional parameter to return more data.
  • include_24hr_price_change (24hr price change percentage)
  • include_total_reverse_in_usd (token liquidity data - total liquidity portion attributable to a specific token across all available pools)
Improved Endpoint:
{
  "data": {
    "id": "e58258f7-8368-4968-bbe1-b5343540cd71",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "1.00276143983565",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3175.22870146126"
      },
      "market_cap_usd": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "25000000000",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "500000000000"
      },
      "h24_volume_usd": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "50000000",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10000000000"
      },
      "h24_price_change_percentage": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "-0.15",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1.15"
      },
      "total_reserve_in_usd": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "417994486.4342195821530162288",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "417994486.4342195821530162288" 
    }
  }
}
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
Here’s some quick examples:
  • Track fresh pools on Uniswap V4 & Aerodrome with liquidity above $1,000
  • Discover trending DEX pools across Solana, Base, and other chains with a high GT Score.
  • Filter out risky pools with built-in honeypot protection & fraud checks
  • Customize data retrieval based on your strategy: time-based, volume-based, or trend-driven

Try it out now!

πŸš€ API Docs: Megafilter for Pools
πŸ”— 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.
EndpointsEffective Date & TimeCurrent Update FrequencyNew Update Frequency
Onchain /networks/../tokens/02:00 UTC, February 24, 202560s30s
Onchain /networks/../tokens/multi/06:00 UTC, February 24, 202560s30s
Onchain /networks/../pools/../ohlcv02:00 UTC, February 25, 2025 - Enterprise plan subscribers only60s30s
Onchain /networks/../pools/../ohlcv02:00 UTC, February 26, 2025 - Analyst/Lite/Pro plan subscribers60s30s
What This Means for You:
  • Fresher Data, Quicker: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!
  • No Extra Credits for Cached Data: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before.
Things to Keep in Mind:
  • If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
  • To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration.
We’re committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to soonaik@coingecko.com .CoinGecko API Team

Enhanced Onchain Metadata, Increased Max Address Limit for Multi Endpoints, Improved Exchange Tickers Sorting

πŸ—“οΈ February 09, 2025

Onchain Metadata: Improved Coverage

Previously: Payload may return β€˜missing.png’ for image_url for tokens that do not have image data.Now: Coverage of metadata (images, websites, description, socials) is now improved for tokens on Solana, Ton, Base, and Sui networks. For tokens that do not contain image data, β€˜null’ value will be returned for image_url.Improved endpoints with image data:
  1. Trending Pools List
  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:

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

Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter

πŸ—“οΈ January 27, 2025

Onchain Pools Data: Supports more than 10 pages of data

Previously: There was a limitation of a maximum of 10 pages for accessing pools data in the related endpoints.Now: All paid plan subscribers (Analyst & above) can access more than 10 pages of pools data for the endpoints below.Improved Endpoints:
  1. Search Pools
  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 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:
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

Multiple Improvements: Onchain Token Price, NFT Market Cap

πŸ—“οΈ January 24, 2025

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

Endpoint: Token Price by Token Addresses
  • You can now flag include_market_cap=true and include_24hr_vol=true to retrieve market cap and 24h trading volume data. e.g.
json
{
  "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:
example

  "market_cap_rank": 75,

Removal of Unsupported Categories

πŸ—“οΈ January 23, 2025

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.
NoCategory NameCategory ID
1US Election 2020us-election-2020
2Governancegovernance
3Cryptocurrencycryptocurrency
4Technology and Sciencetechnology-science
5Presale Memepresale-meme-coins
6Business Platformbusiness-platform
7Numbernumber
8Structured Productstructured-products
9Investmentinvestment
10Niftex Shardsniftex-shards
11Ethereum POW IOUethereum-pow-iou
12Mirrored Assetsmirrored-assets
13Remittanceremittance
14Protocolprotocol
15Unicly Ecosystemutokens
16Finance and Bankingfinance-banking
17Eth 2.0 Stakingeth-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, 2025

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.

Update to Total Supply of POW Coins

πŸ—“οΈ January 15, 2025

What’s Changing?

We are updating the definition of Total Supply for PoW (Proof-of-Work) coins to reflect the actual number of mined coins rather than the maximum supply. This change ensures consistency and accuracy in representing the supply data.

Key Updates

  • Previous Behavior:
    • Total Supply: Displayed as the maximum possible supply (e.g., Bitcoin: 21,000,000).
  • New Behavior:
    • Total Supply: Now reflects the actual number of mined coins.
      For example: Bitcoin: ~19,500,000 (as of January 2025).
This update will also affect historical Total Supply data for consistency. This change applies to all affected PoW coins, including Bitcoin, Bitcoin Cash, Litecoin, Ethereum Classic, and more.

Affected endpoints that contain β€œtotal_supply” data:

Timeline:

Bitcoin: Updated on Jan 14, 2025Other PoW Coins: Scheduled for Jan 22, 2025

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.
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 soonaik@coingecko.com .CoinGecko API Team

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.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)
December 2024

Added: Onchain Categories Data, CG data improvements

πŸ—“οΈ December 24, 2024

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

[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/
Coins
  • /coins/markets
  • /coins/
  • /coins//tickers
  • /coins//history
  • /coins//market_chart
  • /coins//market_chart/range
  • /coins//ohlc
  • /coins//ohlc/range
  • /coins//circulating_supply_chart
  • /coins//circulating_supply_chart/range
  • /coins//total_supply_chart
  • /coins//total_supply_chart/range
Contract
  • /coins//contract/
  • /coins//contract//market_chart
  • /coins//contract//market_chart/range
Exchange
  • /exchanges//tickers
  • /exchanges//volume_chart
  • /exchanges//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:
  1. bridged-usdc
  2. bridged-wbtc
  3. bridged-weth
Then you may use /coins/market endpoint to retrieve the list of coins

Enhancing Your Access to Even Fresher Data!

πŸ—“οΈ December 16, 2024[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers 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 soonaik@coingecko.com .CoinGecko API Team
πŸ—“οΈ December 15, 2024You 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.
json
"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.
json
 "coins": 384,
 "pairs": 1281,
October 2024

Multiple Improvements: Onchain Simple Price, Onchain Recently Updated Info, NFT Collection Data

πŸ—“οΈ October 09, 2024

Onchain: Simple Price - Increased Token Address Limit from 30 to 100

Token Price by Token Addresses 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",
..
September 2024

Multiple Improvements: Global Market Chart, Asset Platforms, Coin Categories, Historical Supply Chart

πŸ—“οΈ September 26, 2024

Global Market Chart - Improved Daily Data Update

Previously, for Global Market Cap Chart Data endpoint , 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

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:
{
  "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"
}
May 2024

Introduced /coins//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//ohlc

πŸ—“οΈ May 04, 2024We’ve expanded functionality to include support for the interval=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
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
March 2024

Introduced /key endpoint

πŸ—“οΈ March 27, 2024We’ve introduced a new endpoint /key for conveniently monitoring your account’s API usage, including rate limits and remaining credits.Example of responses:
{
  "plan": "Other",
  "rate_limit_request_per_minute": 1000,
  "monthly_call_credit": 1000000,
  "current_total_monthly_calls": 307,
  "current_remaining_monthly_calls": 999693
}
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
     "data": {
        "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
        "type": "token",
        "attributes": {
          "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "name": "Tether USD",
          "symbol": "USDT",
          "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", πŸ‘ˆ
          ......
          "market_cap_usd": "100719721661.467"
        },
        "relationships": {}
    }
    
  • We’ve added sorting parameters such as order= h24_volume_usd_desc and order= h24_tx_count_desc for /pools endpoints
  • The β€˜token’ parameter within the /ohlcv 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
    {
      "data": {
        "id": "46303eb4-fba1-44f3-a3c8-c542e4cd5d1a",
        "type": "ohlcv_request_response",
        "attributes": {
          "ohlcv_list": []
        }
      },
      "meta": {
        "base": {
          "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "name": "Tether USD",
          "symbol": "USDT",
          "coingecko_coin_id": "tether"
        },
        "quote": {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "name": "Wrapped Ether",
          "symbol": "WETH",
          "coingecko_coin_id": "weth"
        }
      }
    }
    

Introduced /networks//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

Included new field for /coins/ endpoint

πŸ—“οΈ January 18, 2024We’ve included a new field β€œwhitepaper” under β€œlinks” section for /coins/ endpointExample of responses:
{
  "id": "bitcoin",
  ......
  "links": {
    "homepage": [],
    "whitepaper": "https://bitcoin.org/bitcoin.pdf", πŸ‘ˆ
    "blockchain_site": [],
    "official_forum_url": [],
    "chat_url": [],
    "announcement_url": [],
    "twitter_screen_name": "bitcoin",
    "facebook_username": "bitcoins",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "",
    "subreddit_url": "https://www.reddit.com/r/Bitcoin/",
    "repos_url": {}
  },
  .......
}
December 2023

Deprecated response fields for /coins/

πŸ—“οΈ 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:
πŸ—“οΈ 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 response
November 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
{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "web_slug": "bitcoin", πŸ‘ˆ
  ......
  "tickers": [...]
}
For the /asset_platforms endpoint, we’ve introduced the native_coin_id data. This enables users to obtain the coin ID of different blockchain networks or asset platforms that may not have a contract address to look upExample of responses:
JSON
{
  "id": "polygon-pos",
  "chain_identifier": 137,
  "name": "Polygon POS",
  "shortname": "MATIC", 
  "native_coin_id": "matic-network" πŸ‘ˆ
},

Introduced /simple/networks//token_price/ 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 it

Introduced /networks//pools//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:
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 values

Introduced new endpoints (Onchain/GT)

πŸ—“οΈ September 06, 2023Added new endpoints to allow querying multiple pools and tokens in a single API call. /networks//pools/multi/ and /networks//tokens/multi/
June 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:

Multiple Improvements

πŸ—“οΈ June 01, 2023We’ve made enhancements to the /search/trending and /coins//contract/ 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//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
{
"id": "bitcoin",
......
"watchlist_portfolio_users": 1449601, πŸ‘ˆ
"market_cap_rank": 1,
......
"tickers": []
}

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 minute

Multiple Improvements (Onchain/GT)

πŸ—“οΈ April 18, 2023
  • base_token_native_currency and quote_token_native_currency added to the pools endpoint response. This allows you to obtain price in the network’s native currency in addition to in USD
  • reserve_in_usd added to the pools endpoint response. This returns the total liquidity/reserve of the pool in USD
  • pool_created_at added to the pools endpoint response
Example of responses for /networks//pools/ :
{
"data": {
    "id": "eth_0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f",
    "type": "pool",
    "attributes": {
    "base_token_price_usd": "0.0000186523882966482",
    "base_token_price_native_currency": "0.00000000647822280242372", πŸ‘ˆ
    "quote_token_price_usd": "2881.71870575097",
    "quote_token_price_native_currency": "1.0", πŸ‘ˆ
    "base_token_price_quote_token": "0.000000006478222802",
    "quote_token_price_base_token": "154363323",
    "address": "0xeb2eae8a9912a09cb0f13bfafd5ad56cd263bb3f",
    "name": "DGX-1 / WETH",
    "pool_created_at": "2024-02-18T08:10:59Z", πŸ‘ˆ
    "fdv_usd": "784687",
    "market_cap_usd": null,
    "price_change_percentage": {
    "h1": "34.67",
    "h24": "8406.81"
    },
    "transactions": {},
    "volume_usd": {},
    "reserve_in_usd": "110214.6247" πŸ‘ˆ
    },
    "relationships": {}
    }
}

Included new fields

πŸ—“οΈ April 03, 2023We’ve added β€œsymbol” field to these NFT endpoints responses:Example of responses:
JSON
{
	"id": "pudgy-penguins",
  "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  "asset_platform_id": "ethereum",
  "name": "Pudgy Penguins",
  "symbol": "PPG", πŸ‘ˆ
  ....
},
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:
{
  "id": "pudgy-penguins",
  "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  .......
  "links": {
    "homepage": "https://www.pudgypenguins.com/", πŸ‘ˆ
    "twitter": "https://twitter.com/pudgypenguins",πŸ‘ˆ
    "discord": "https://discord.gg/pudgypenguins" πŸ‘ˆ
  },
	.......
}

Introduced /coins/top_gainer_losers endpoint

πŸ—“οΈ March 23, 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 granularity day, hour, minute and multiple aggregates
February 2023

Multiple Improvements

πŸ—“οΈ February 23, 2023We’ve made some updates to the /coins/categories and /simple/token_price/ 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//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:
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:Furthermore we’ve introduced the Token Lists endpoint 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
{
  "id": "arbitrum",
  "symbol": "arb",
  "name": "Arbitrum",
  "web_slug": "arbitrum",
  "asset_platform_id": "arbitrum-one",
  "platforms": {},
  "detail_platforms": {
      "arbitrum-one": { πŸ‘ˆ
      	"decimal_place": 18, πŸ‘ˆ
      	"contract_address": "0x912ce59144191c1204e64559fe8253a0e49e6548" πŸ‘ˆ
      },
      ......
  }, 
   ......
}
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 deprecated

Included new fields to /exchanges/

πŸ—“οΈ 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
{
  "name": "Uniswap V3 (Ethereum)",
  ......
  "centralized": false,
  "public_notice": "This page refers to Uniswap V3. This is an alpha release of the exchange tracker, we will continue to improve the stats here specifically for the new approach introduced by the V3 protocol. For Uniswap V2, please refer to https://www.coingecko.com/en/exchanges/uniswap-v2-ethereum", πŸ‘ˆ
  "alert_notice": "", πŸ‘ˆ
	......
  "status_updates": []
}
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//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:
[
  {
  "id": "bitcoin",
  "symbol": "btc",

  "ath": 69045,
  "ath_change_percentage": -38.01241,
  "ath_date": "2021-11-10T14:24:11.849Z",
  "atl": 67.81, πŸ‘ˆ
  "atl_change_percentage": 63017.26399, πŸ‘ˆ
  "atl_date": "2013-07-06T00:00:00.000Z", πŸ‘ˆ
  "roi": null,
  "last_updated": "2024-02-05T07:23:50.583Z"
	},
  ......
]
March 2020

Improved /coins//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
{
  "name": "Tether",
  "tickers": [
   {
    "base": "BTC",
    "target": "USDT",
    ......
    "converted_last": {
      "btc": 0.00002336, //USDT price in BTC
      "eth": 0.00043493, // USDT price in ETH
      "usd": 0.99901 πŸ‘ˆ //showing USDT price instead of Bitcoin Price
    },
    ......
    "coin_id": "bitcoin",
    "target_coin_id": "tether"
    },
    ......
  ]

}

January 2020

Updated params for /derivatives endpoint

πŸ—“οΈ January 09, 2020We have made updates to the include_tickers parameter for /derivatives/exchanges/ endpoint.Please refer to the documentation for a comprehensive list of available values for this parameter
November 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//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
[
  [
    1707030000000,
    "141206.9308600928467152" πŸ‘ˆ value in BTC
  ],
  [
    1707030600000,
    "141639.1493761186305005" πŸ‘ˆ value in BTC
  ],
  ......
 ]
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 optional order 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 added trust_score field to /coins//tickers and /exchanges//tickers endpointsExample of responses:/coins//tickers endpoint
JSON
{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      ......
      "trust_score": "green", πŸ‘ˆ
      ........
      "coin_id": "bitcoin",
      "target_coin_id": "tether"
    },
    ...
  ]
},
/exchanges//tickers endpoint
JSON
{
  "name": "Binance",
  "tickers": [
    {
      "base": "USDC",
      ......
      "trust_score": "green", πŸ‘ˆ
      ......
      "coin_id": "usd-coin",
      "target_coin_id": "tether"
		},
    {...},
    {...},
  ]

},

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 endpoint
JSON
{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      ......
      "last_traded_at": "2024-02-05T04:36:55+00:00", πŸ‘ˆ
      "last_fetch_at": "2024-02-05T04:36:55+00:00",  πŸ‘ˆ
      ......
      "coin_id": "bitcoin",
      "target_coin_id": "tether"
    },
    ...
  ]
},
/exchanges//tickers endpoint
JSON
{
  "name": "Binance",
  "tickers": [
    {
      "base": "USDC",
      ......
      "last_traded_at": "2024-02-05T04:49:34+00:00", πŸ‘ˆ
      "last_fetch_at": "2024-02-05T04:49:34+00:00",  πŸ‘ˆ
      ......
      "coin_id": "usd-coin",
      "target_coin_id": "tether"
		},
    {...},
    {...},
  ]

},
April 2019

Introduced optional params for multiple endpoints

πŸ—“οΈ April 10, 2019Added coin_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 to market_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/ 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.
{
  "name": "Binance",
  "year_established": 2017,
  ......
  "tickers": [...], //100 items πŸ‘ˆ
  "status_updates": [...] //7 items
}
To retrieve more tickers, kindly utilize /exchanges//tickers endpoint.

Improved /coins/ 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
{
"id": "bitcoin",
"symbol": "btc",
......
"last_updated": "2024-02-05T03:45:46.327Z",
"tickers": [...] //100 items πŸ‘ˆ
}
To retrieve more tickers, kindly utilize /coins//tickers endpoint.