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

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

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:

• 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

Now support locked_liquidity_percentage data.

Improved endpoints:

• 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

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:

• 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

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

Onchain Token Info endpoints - Holders data

Now support the following holder data (Beta):

• holders count
• top holders distribution percentage

Improved endpoints:

• 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

Now support the following data:

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

Improved endpoints:

• 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

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:

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

Powered 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

[Changes below are applicable to Analyst/Lite/Pro/Enterprise plan subscribers only.]

Dear CoinGecko API paid plan subscribers,

We’re excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting 02:00 UTC, February 24, 2025, the edge cache duration for the following endpoints will be reduced to 30s, allowing you to retrieve updated data more frequently.

What This Means for You:

• Fresher Data, Quicker: With a reduced cache time, you’ll now have the option to access more up-to-date data, closer to real-time!
• No Extra Credits for Cached Data: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits charged—just like before.

Things to Keep in Mind:

• If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used.
• To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer 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

Onchain Metadata: Improved Coverage

Previously: Payload may return 'missing.png' for image_url for tokens that do not have image data.

Now: Coverage of metadata (images, websites, description, socials) is now improved for tokens on Solana, Ton, Base, and Sui networks. For tokens that do not contain image data, 'null' value will be returned for image_url.

Improved endpoints with image data:

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

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

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

Note: Metadata may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by CoinGecko team, you may use the following endpoints:

• Coin Data by ID
• Coin Data by Token Address

Improved Max Address Limit for onchain /multi endpoints

Previously: Onchain /multi endpoints support up to 30 token or pool contract addresses per request.

Now: Onchain /multi endpoints support up to 50 token or pool contract addresses per request.

Improved endpoints:

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

Note: this new max address input limit is exclusive for paid plan subscribers (Analyst plan & above) only.

Improved Data Consistency for Exchange Tickers by ID

For Exchange Tickers by ID endpoint, the order is sorted by trust_score_desc by default.

• Sometimes duplicate or missing data may occur due to paginated cached response, especially when a ticker's rank changes between 2 paginated requests, e.g. it might shift from Page 2 to Page 1, vice versa.
• We've added a new order option: base_target, which will sort the tickers by base symbol, then target symbol, in lexicographical order, i.e. 0->9, then a->Z.

Example: flagging ?order=base_target

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

This sorting method ensures stable pagination, reducing issues where cached responses may cause duplicate or missing tickers across pages.

Onchain Pools Data: 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 Address

Previously: There was no way to filter trades data by base or quote token.

Now: A new optional parameter has been added to allow filtering by base or quote token of a pool.

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

Example:

?token=base // get the trades data of base token
?token=quote // get the trades data of quote token
?token=8FqXr6dw5NHA2TtwFeDz6q9p7y9uWyoEdZmpXqqUpump // get the trades data of specific token based on address

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

Endpoint: Token Price by Token Addresses

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

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

NFT Data: Added 'Market Cap Rank'

You can now obtain the market_cap_rank data of NFT collections via the following endpoints:

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

  "market_cap_rank": 75,

Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API

Summary

We are announcing the removal of certain categories from CoinGecko and CoinGecko API. These categories will no longer be supported across all API endpoints starting February 12, 2025.

Reason for Removal

Many of these categories no longer have associated coins. Some categories are outdated and no longer relevant in the crypto space. The changes align with updated category topology standards to maintain data accuracy and relevance.

Impact

API responses for the /coins/markets endpoint will no longer support data of the categories above. Any requests specifying these categories will return an error.

Action Required

Ensure applications using the /coins/markets endpoint are not querying these removed categories. Please update any code or documentation referencing these categories to prevent errors.

What’s New?

We’ve improved the Pool OHLCV Chart by Pool Address endpoint to provide access to a much broader range of historical data.

Key Updates

• Previous Behavior: Users could only query data for the past 6 months from today.
• New Behavior: Users can now access data from September 2021 to the present, depending on the pool’s tracking start date on GeckoTerminal.
• Each API request is limited to a 6-month date range, but users can query older data by using the before_timestamp parameter.

Note: access to data beyond the past 6 months is only available to Paid Plan subscribers (Analyst plan & above).

Action Required

No changes are required for existing integrations. However, users who need data beyond the past 6 months should adjust their queries to use the before_timestamp parameter to fetch additional data.