[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

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 [email protected] .

CoinGecko API Team

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

Request 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 Address

By 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
      }
    }
  ]

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

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

Notice: Upcoming Change to CoinGecko API Endpoints - Removal ofnormalized_volume_btc Data

Effective Date: 16 June 2025

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

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

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

[Pro-API Exclusive] New Endpoint - On-chain Trending Search Data

With this new endpoint Trending Search Pools, you can now retrieve the on-chain trending search pools and tokens data, as seen on GeckoTerminal.com .

By default, this endpoint returns the top 4 trending pools data, you may specify 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).



[Pro-API Exclusive] Improved Endpoint - Trending Search List

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

Trending Search on CoinGecko.com



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

The 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 Example

Token Data Returned

Remarks

pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&symbols=btc&include_tokens=top

  1. Bitcoin

When symbols and 'include_tokens=top' is specified, only the top market cap tokens will be returned.

pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&symbols=btc&include_tokens=all

  1. Bitcoin
  2. Osmosis allBTC
  3. atcat
  4. Meld Bridged BTC (Meld)
  5. BlackrockTradingCurrency

When symbols and 'include_tokens=all' is specified, all the coins that share the same symbol will be returned.

All the 5 coins stated in the example have the same symbol 'btc'.



/coins/markets Endpoint Improvement

We've enhanced the/coins/markets endpoint Coins List with Market Data, by including 'total' and 'per-page' values in the Response Headers.

This addition to the Response Headers enables developers to identify the total number of active coins on coingecko.com and specify the required pagination to retrieve all available data.

per-page: 250
total:16989

Notice: Upcoming Change to CoinGecko API Endpoints - Removal oftwitter_followers Data

Effective Date: 15 May 2025

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

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

[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 [email protected] .

CoinGecko API Team