Changelog

​

Improved Update Frequency for selected Pro-API On-chain Endpoints

​

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.

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

​

Now Supported: Launchpad Data (Pump.fun & More), Granular OHLCV, and Honeypot Info

​

🚀 Now Supporting Launchpad Data (Pump.fun & More!)

• Token Data by Token Address
• Tokens Data by Token Addresses
• Specific Pool Data by Pool Address
• Multiple Pools Data by Pool Addresses

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

• Pool OHLCV chart by Pool Address
• Token OHLCV chart by Token Address

• 1s
• 15s
• 30s

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

• Token Info by Token Address
• Pool Tokens Info by Pool Address

{
 "mint_authority": null,
 "freeze_authority": null,
 "is_honeypot": true  // possible values: true / false / unknown
}

​

[Pro-API Exclusive] New Filtering Option in Megafilter

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

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

• Base and quote token address
• Sentiment vote percentage (positive and negative)
• Community suspicious reports count

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

​

SOL Currency Is Now Supported for CoinGecko Endpoints

​

Improved endpoints:

• Coin Price by IDs
• Coin Price by Token Addresses
• Supported Currencies List
• Top Gainers & Losers
• Coins List with Market Data
• Coin Data by ID
• Coin Historical Data by ID
• Coin Historical Chart Data by ID
• Coin Historical Chart Data within Time Range by ID
• Coin OHLC Chart by ID
• Coin OHLC Chart within Time Range by ID
• Coin Data by Token Address
• Coin Historical Chart Data by Token Address
• Coin Historical Chart Data within Time Range by Token Address
• Trending Search List
• Crypto Global Market Data

{
  "bitcoin": {
    "sol": 720.21
  }
}

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

​

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

• Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.

​

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

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

​

Improved Endpoints - Support Multi-pool Token Data

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

• Top Pools by Token Address
• Search Pools
• Megafilter for Pools
• Trending Pools List
• Specific Pool Data by Pool Address
• Top Pools by Network
• New Pools List

​

Upcoming Change Notice: Removal of normalized_volume_btc Data

• Exchange Data by ID
• Exchanges List with Data

  {
    "trade_volume_24h_btc_normalized": 47765.5886637453
  },

​

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

​

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

​

Improved Endpoints - Support Net Buy Volume Data

• Specific Pool Data by Pool Address
• Multiple Pools Data by Pool Addresses

• net_buy_volume_usd
• buy_volume_usd
• sell_volume_usd

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

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

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

• Token Info by Token Address
• Pool Tokens Info by Pool Address

  "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

• Token Data by Token Address
• Tokens Data by Token Addresses

      "decimals": 6,
      "total_supply": "49999156520373530.0",
      "normalized_total_supply": "49999156520.37353",

​

Improved Endpoints - Support Pool ‘Name’ and ‘Fee’ Data

• Specific Pool Data by Pool Address
• Multiple Pools Data by Pool Addresses

        "name": "WETH / USDC 0.05%",
        "pool_name": "WETH / USDC",
        "pool_fee_percentage": "0.05",

​

Improved Endpoints - Support Symbols of DEX Pairs

• Coin Data by ID
• Coin Tickers by ID
• Exchange Tickers by ID
• Exchange Data by ID

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

​

New Endpoint & Improvements: On-Chain Trending Data, Enhanced Trending Search, and Improved Token Lookup

​

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

​

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

​

Improved Endpoints - Support Token Lookup by Symbol and Name

• Coin Price by IDs and Symbols
• Coins List with Market Data

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

​

/coins/markets Endpoint Improvement

per-page: 250
total:16989

​

Upcoming Change Notice: Removal of twitter_followers Data

• Coin Data by ID
• Coin Data by Token Address
• Coin Historical Data by ID

"community_data": {  
  "twitter_followers": 7694251,
  // ... other community data points ...
}

​

New Endpoint & Multiple Improvements: On-Chain Top Token Holder Address, Security Data, Historical Supply.

​

[Pro-API Exclusive] New Endpoint - Top Token Holder Address Data

• EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base
• Solana
• Sui
• TON
• Ronin

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

• Token Info by Token Address
• Pool Tokens Info by Pool Address

​

Historical Supply endpoints - Support for Inactive Coins

• Circulating Supply Chart by ID
• Circulating Supply Chart within Time Range by ID
• Total Supply Chart by ID
• Total Supply Chart within time range by ID

​

Onchain Pool Data endpoints - Locked Liquidity

• Specific Pool Data by Pool Address
• Multiple Pools Data by Pool Addresses

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

• 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

• Token Info by Token Address
• Pool Tokens Info by Pool Address

        "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

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

​

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

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

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

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

​

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

​

Onchain Token Info endpoints - Holders data

• holders count
• top holders distribution percentage

• Token Info by Token Address
• Pool Tokens Info by Pool Address

    "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

• price_change_percentage: m15, m30
• volume_usd: m15, m30
• transactions: h6

• Specific Pool Data by Pool Address
• Multiple Pools Data by Pool Addresses

        "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

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

• Token Price by Token Addresses

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

​

New Megafilter Endpoint, 200+ Chains Supported: Hyperliquid, Abstract, Berachain & MOAR!

​

🔥 What’s Megafilter?

​

👀 What Can You Do?

• 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

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

​

Update Frequency Improvements for selected Pro-API endpoints

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

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

​

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

​

Onchain Metadata: Improved Coverage

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

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

• Coin Data by ID
• Coin Data by Token Address

​

Improved Max Address Limit for onchain /multi endpoints

1. Tokens Data by Token Addresses
2. Multiple Pools Data by Pool Addresses

​

Improved Data Consistency for Exchange Tickers by ID

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

pro-api.coingecko.com/api/v3/exchanges/binance/tickers?order=base_target

​

Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter

​

Onchain Pools Data: Supports more than 10 pages of data

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

• Parameter: token
• Value options:
  • base
  • quote
  • {token_address}

?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

​

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

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

{
  "data": {
    "id": "e1979db1-5c3e-4ba8-b103-cb0258af4a7c",
    "type": "simple_token_price",
    "attributes": {
      "token_prices": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "0.999365729816931",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "3399.24368371279"
      },
      "market_cap_usd": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "51963214441.24363",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "10005535878.50094"
      },
      "h24_volume_usd": {
        "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": "2095689865.85327",
        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "2544539948.02599"
      }
    }
  }
}

​

NFT Data: Added ‘Market Cap Rank’

• NFTs Collection Data by ID
• NFTs Collection Data by Contract Address

  "market_cap_rank": 75,

​

Removal of Unsupported Categories

​

Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API

​

Summary

​

Reason for Removal

​

Impact

​

Action Required

​

Extended Historical Data for Onchain OHLCV Endpoint

​

What’s New?

​

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.

​

Action Required

​

Update to Total Supply of POW Coins

​

What’s Changing?

​

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

​

Affected endpoints that contain “total_supply” data:

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

​

Timeline:

• Bitcoin Cash
• Litecoin
• Ethereum Classic
• Bitcoin SV
• Zcash
• eCash
• Dash
• Verus Coin
• Ravencoin
• Kadena
• Decred
• Flux (Zelcash)
• DigiByte
• Quantum Resistant Ledger
• Komodo
• Groestlcoin
• Firo
• Litecoin Cash
• LuckyCoin
• Enecuum
• Wownero
• Radiant
• Tidecoin
• Handshake
• Neoxa
• Vertcoin
• Feathercoin
• Bitcore
• Phoenixcoin
• BitcoinZ
• Hush
• DigitalNote
• EquityPay
• Evadore
• Swap
• DeVault
• AXE
• Iridium
• X-Cash
• Bolivarcoin
• uPlexa
• WorldCoin (WDC)

​

Improved Update Frequency for selected Pro-API endpoints

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

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

​

Improved 5-minutely data for Historical Chart Data endpoints

• Coin Historical Chart Data by ID
• Coin Historical Chart Data within Time Range by ID
• Coin Historical Chart Data by Token Address
• Coin Historical Chart Data within Time Range by Token Address

• 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

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

​

Added: Onchain Categories Data, CG data improvements

​

NEW: Onchain Categories : Get Categories on GeckoTerminal.com

• This endpoint is exclusively available for Analyst/Lite/Pro/Enterprise plan subscribers only.

​

NEW: Onchain Catergory Pools: Get Pools of a specific Category

• 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

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

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

​

Onchain New Pools Data: Bug Fixed

​

CoinGecko Exchange Data: Added support of inactive exchange id

  {
    "id": "ftx",
    "name": "FTX (Derivatives)"
  },
  {
    "id": "ftx_spot",
    "name": "FTX"
  },
  {
    "id": "ftx_tr",
    "name": "FTX TR"
  },
  {
    "id": "ftx_us",
    "name": "FTX.US"
  },

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

​

CoinGecko Historical Chart Data: Faster Last UTC Day (00:00) Data Update

​

[Updated: Q4 2024] CoinGecko Asset Issuance Standardisation Initiative Updates

• Wrapped Bitcoin (WBTC)
• Wrapped Ethereum (WETH)
• Dai (DAI)

​

What’s New in Q4 2024? 👈

• Frax (FRAX)
• Wrapped AVAX (WAVAX)
• Wrapped BNB (WBNB)
• Wrapped stETH (wstETH)

​

Tips and FAQs for API users

​

1. How does this affect my current API setup?

• /simple/price
• /simple/token_price/

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

• /coins//contract/
• /coins//contract//market_chart
• /coins//contract//market_chart/range

• /exchanges//tickers
• /exchanges//volume_chart
• /exchanges//volume_chart/range

​

2. Do I have to make changes to my API?

​

3. What will happen to the coins that are separated into a new coin page?

​

4. How do I identify the list of coins that will be separated?

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

​

Enhancing Your Access to Even Fresher Data!

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

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

​

Multiple Improvements: Onchain Trending Pools, CG New Currencies Support, Snapshot, Exchange Info

​

Onchain Trending Pools: Added Support to Filter by Duration

• Trending Pools List: query all the trending pools across all networks on GeckoTerminal
• Trending Pools by Network: query the trending pools based on the provided network

​

CG Coin Prices: Added Support for New Fiat Currencies

• Coin Price by IDs: query latest price in selected currencies, by coin id
• Coin Price by Token Addresses: query latest price in selected currencies, by token address
• BTC-to-Currency Exchange Rates: query BTC exchange rates with other 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

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

​

CG Exchange Info: Included Number of Coins and Pairs

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

​

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

​

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

• 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

• 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

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

​

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

​

Global Market Chart - Improved Daily Data Update

​

Asset Platforms - Included Images of Blockchain Network Logos

    "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

"top_3_coins_id": [
  "bitcoin",
  "ethereum",
  "binancecoin"
],

​

Circulating Supply Chart and Total Supply Chart - Fixed ‘0’ data issue

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

• /coins//ohlc
• /coins//ohlc/range

​

Included new fields - NFT data

• /nfts/
• /nfts//contract/

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

​

Introduced /coins//ohlc/range endpoint

​

Added interval hourly params to /coins//ohlc

​

Added support for inactive coins in /coins/list and historical data endpoints

• 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

• /coins//history
• /coins//market_chart
• /coins//market_chart/range
• /coins//contract//market_chart
• /coins//contract//market_chart/range

​

Introduced /key endpoint

{
  "plan": "Other",
  "rate_limit_request_per_minute": 1000,
  "monthly_call_credit": 1000000,
  "current_total_monthly_calls": 307,
  "current_remaining_monthly_calls": 999693
}

​

Multiple Improvements (Onchain/GT)

• image_url is now returned in the token response for pools and tokens endpoints: Example of responses:
  JSON

  Copy

   "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

  Copy

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

​

Introduced /search/pools endpoint (Onchain/GT)

​

Included new field for /coins/ endpoint

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

​

Deprecated response fields for /coins/

• 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

• /coins//total_supply_chart : get historical total supply of a coin, by number of days away from now.
• /coins//total_supply_chart/range : get historical total supply of a coin, within a range of timestamp.

​

Included more trending coins

​

Improvement on pool data (Onchain/GT)

​

Multiple Improvements

• /coins/
• /coins//contract/

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "web_slug": "bitcoin", 👈
  ......
  "tickers": [...]
}

{
  "id": "polygon-pos",
  "chain_identifier": 137,
  "name": "Polygon POS",
  "shortname": "MATIC", 
  "native_coin_id": "matic-network" 👈
},

​

Introduced /simple/networks//token_price/ endpoint (Onchain/GT)

​

Introduced /networks//pools//trades endpoint (Onchain/GT)

​

Introduced new endpoints (Onchain/GT)

• To fetch information of tokens inside a pool, use /networks//pools//info
• To fetch information of a specific token use /networks//tokens//info
• If you like to get token information of the most recently updated tokens, use /tokens/info_recently_updated

​

Included new fields (Onchain/GT)

​

Introduced new endpoints (Onchain/GT)

​

Included new fields (Onchain/GT)

• 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

• /coins/markets
• /coins/market_chart
• /coins/market_chart/range
• /coins//contract//market_chart
• /coins//contract//market_chart/range
• /coins//ohlc

​

Multiple Improvements

• 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

​

Multiple Improvements (Onchain/GT)

• 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

​

Included new fields

{
"id": "bitcoin",
......
"watchlist_portfolio_users": 1449601, 👈
"market_cap_rank": 1,
......
"tickers": []
}

​

Increased Rate Limit (Onchain/GT)

​

Multiple Improvements (Onchain/GT)

• 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

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

• /networks//new_pools endpoint added to query new pools discovered for a network
• /networks/new_pools endpoint added to query new pools discovered across all networks

​

Included new fields

• /nfts/markets
• /nfts/
• /nfts//contract/

{
	"id": "pudgy-penguins",
  "contract_address": "0xBd3531dA5CF5857e7CfAA92426877b022e612cf8",
  "asset_platform_id": "ethereum",
  "name": "Pudgy Penguins",
  "symbol": "PPG", 👈
  ....
},

​

Included new fields

• /nfts/
• /nfts//contract/

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

​

Improved OHLCV endpoint (Onchain/GT)

​

Multiple Improvements

• 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

​

Introduced /coins/list/new endpoint

​

Introduced new NFT endpoints

• /nfts//market_chart (for historical market data)
• /nfts//market_chart (for historical market data based on contract address)
• /nfts//tickers (to retrieve floor price and volume information on each marketplace)

​

Introduced new endpoints and improvements

​

Introduced NFTs and Token Lists Endpoints

• /nfts/list
• /nfts/
• /nfts//contract/
• /nfts/market (Exclusive for Enterprise Plan Subscribers)

• /token_lists//all.json

​

Included new fields to multiple endpoints

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

​

Introduced historical circulating supply endpoint

• /coins//circulating_supply_chart
• /coins//circulating_supply_chart/range

​

Deprecated event endpoint

​

Included new fields to /exchanges/

{
  "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": []
}

​

Introduced /search/trending endpoint

​

Introduced category filter params to /coins/markets

​

Introduced /coins//ohlc endpoint

​

Included new fields to /coins/markets

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

​

Improved /coins//tickers

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

}

​

Updated params for /derivatives endpoint

​

Introduced finance and derivatives endpoints

​

Introduced /exchanges//volume_chart

[
  [
    1707030000000,
    "141206.9308600928467152" 👈 value in BTC
  ],
  [
    1707030600000,
    "141639.1493761186305005" 👈 value in BTC
  ],
  ......
 ]

​

Set default params value for tickers endpoints

​

Included new trust score field to tickers

{
  "name": "Bitcoin",
  "tickers": [
    {
      "base": "BTC",
      "target": "USDT",
      ......
      "trust_score": "green", 👈
      ........
      "coin_id": "bitcoin",
      "target_coin_id": "tether"
    },
    ...
  ]
},

{
  "name": "Binance",
  "tickers": [
    {
      "base": "USDC",
      ......
      "trust_score": "green", 👈
      ......
      "coin_id": "usd-coin",
      "target_coin_id": "tether"
		},
    {...},
    {...},
  ]

},

​

Included new fields

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

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

},

​

Introduced optional params for multiple endpoints

​

Introduced /exchanges/list endpoint

​

Set default params value for /coins/markets

​

Reduced the usage of /coins (paginated) endpoint

​

Increased Requests Per Minute (RPM)

​

Introduced /simple endpoints

​

Improved /exchanges/ endpoint

{
  "name": "Binance",
  "year_established": 2017,
  ......
  "tickers": [...], //100 items 👈
  "status_updates": [...] //7 items
}

​

Improved /coins/ endpoint

{
"id": "bitcoin",
"symbol": "btc",
......
"last_updated": "2024-02-05T03:45:46.327Z",
"tickers": [...] //100 items 👈
}