Changelog - CoinGecko API

June 2026

New Token Info Fields: Developer Address & Holding Percentage

🗓️ June 16, 2026Token Info by Token Address and Pool Token Info by Token Address now include:

developer_address — developer wallet address
developer_holding_percentage — developer holding as a percentage of total supply

Example Payload

  ...
  "freeze_authority": "no",
  "is_honeypot": "unknown",
  "developer_address": "4t7dHZcUzNC96d79won5TRZsvwP1bumhPNf3awR5BHdu",
  "developer_holding_percentage": "0.0"
}

New Megafilter Parameters: Holder Count & Top Holders Percentage

🗓️ June 15, 2026Megafilter for Pools now supports filtering by holder count and top holder concentration:

holder_count_min / holder_count_max — filter pools by token holder count
top_10_holders_percentage_min / top_10_holders_percentage_max — filter by top 10 holders’ percentage of total supply

New Endpoint: Coin Supply Breakdown

🗓️ June 10, 2026New /coins/{id}/supply_breakdown endpoint — query the supply breakdown of a coin, including non-circulating wallet addresses and balances.

Returns supply_data with total, circulating, non-circulating, and outstanding supply
Includes non_circulating_wallets with wallet address, label, balance, percentage of total supply, and anomaly flag
Use the new has_supply_breakdown field in /coins/{id} and /coins/{id}/contract/{contract_address} to check if breakdown data is available for a coin

Example Payload

{
  "id": "uniswap",
  "symbol": "uni",
  "name": "Uniswap",
  "supply_data": {
    "total_supply": 894488420.0329479,
    "circulating_supply": 622353561.5538775,
    "outstanding_supply": 0.0,
    "non_circulating_supply": 272134858.4790704,
    "last_updated": "2026-06-11T09:16:07.477Z"
  },
  "non_circulating_wallets": [
    {
      "address": "0x1a9C8182C09F50C8318d769245beA52c32BE35BC",
      "label": "UNI Timelock",
      "balance": 272134858.4790704,
      "percentage_of_total_supply": 30.423383405422996,
      "anomaly": false,
      "last_updated": "2026-06-11T06:14:14.076Z"
    }
  ]
}

💼 Exclusive for paid plan subscribers (Analyst, Lite, Pro, and Enterprise). View pricing →

New Endpoint: Coin Insights

🗓️ June 10, 2026New /insights endpoint — query the latest AI-generated coin insights on CoinGecko.

Filter by coin_id, from, and to date parameters

Example Payload

[
  {
    "title": "BTC Prague 2026 Conference Goes Live",
    "description": "The BTC Prague 2026 conference is now live, featuring high-profile speakers and institutional attendance...",
    "related_coin_ids": ["bitcoin"],
    "posted_at": "2026-06-11T07:57:14.180091Z"
  }
]

👑 Exclusive for Enterprise plan subscribers. Contact sales →

May 2026

🗓️ May 20, 2026Effective June 4, 2026 — sparkline image URLs returned by Trending Search List are migrating from www.coingecko.com to data.coingecko.com.Affects the sparkline field across coins, NFTs, and categories:

Section	Before	After
Coins	`https://www.coingecko.com/coins/{id}/sparkline.svg`	`https://data.coingecko.com/coins/{id}/sparkline.svg`
NFTs	`https://www.coingecko.com/nft/{id}/sparkline.svg`	`https://data.coingecko.com/nft/{id}/sparkline.svg`
Categories	`https://www.coingecko.com/categories/{id}/sparkline.svg`	`https://data.coingecko.com/categories/{id}/sparkline.svg`

If your application references or validates the sparkline URL domain, update your code to use data.coingecko.com.

Introducing Webhooks — Real-Time Push Notifications for Coin Data Changes

🗓️ May 19, 2026CoinGecko now supports Webhooks — real-time push notifications to your server when data changes occur, eliminating constant API polling.

Supports the cg.coin.info.updated event — triggers on updates to coin info (name, symbol, categories, platforms, links, image, public_notices, and more)
Set up via the Developer Dashboard — payloads are signed with HMAC SHA256
10 credits per event delivery — retries are free
Up to 5 webhook endpoints per account

💼 Exclusive for paid plan subscribers (Analyst, Lite, Pro, and Enterprise). Learn more →

Higher Minute Rate Limits for Demo & Basic Plans

🗓️ May 17, 2026Requests-per-minute (RPM) rate limits have been increased:

Plan	Previous	New
Demo (Free)	30	100
Basic	250	300

No action required — new limits are already in effect.

Track Per-Key Monthly API Usage with `/key` Endpoint

🗓️ May 17, 2026/key now returns api_key_current_total_monthly_calls — the total API calls made this month by the specific API key used to authenticate the request.

Example Payload

{
  "plan": "Other",
  "rate_limit_request_per_minute": 1000,
  "monthly_call_credit": 1000000,
  "current_total_monthly_calls": 104,
  "current_remaining_monthly_calls": 999896,
  ...
  "api_key_current_total_monthly_calls": 8
}

Available for accounts with custom per-key rate limits. Contact sales to set up per-key limits.

March 2026

Stay Ahead with the New Crypto News Endpoint

🗓️ March 27, 2026New /news endpoint — query crypto news and guides as seen on CoinGecko News.

Filter by coin_id, language, and type (news, guides, or both)
Pagination with page and per_page

Example Payload

[
  {
    "title": "Bitcoin stalls: Why BTC risks $65K fall despite $23M whale buy",
    "url": "https://ambcrypto.com/bitcoin-stalls-why-btc-risks-65k-fall-despite-23m-whale-buy/",
    "image": "https://assets.coingecko.com/articles/images/106731445/large/open-uri20260327-7-fuq6r9.?1774609423",
    "author": "Gladys Makena",
    "posted_at": "2026-03-27T11:00:42Z",
    "type": "news",
    "source_name": "AMBCrypto",
    "related_coin_ids": [
      "1-token-2",
      "1-token",
      "bitcoin"
    ]
  }
]

💼 Exclusive for paid plan subscribers (Analyst, Lite, Pro, and Enterprise).

CGSimplePrice WebSocket Now Supports `vs_currencies`

🗓️ March 25, 2026CGSimplePrice now supports vs_currencies to specify preferred exchange rates. Choose from any currency supported by /simple/supported_vs_currencies. Defaults to USD if not specified.A new vs field in every response indicates the target currency.Input:

{
  "command": "message",
  "identifier": "{\"channel\":\"CGSimplePrice\"}",
  "data": "{\"coin_id\":[\"ethereum\",\"bitcoin\"],\"vs_currencies\":[\"usd\",\"eur\"],\"action\":\"set_tokens\"}"
}

Response:

{
  "c": "C1",
  "i": "ethereum",
  "vs": "usd",
  "m": 312938652962.8005,
  "p": 2591.080889351465,
  "pp": 1.3763793110454519,
  "t": 1747808150.269067,
  "v": 20460612214.801384
}

`interval=hourly` Now Available for All Plans on Coin Market Chart Endpoints

🗓️ March 24, 2026interval=hourly is now accessible to all API users (Demo, Basic, Analyst & above) on:

/coins/{id}/market_chart — hourly data up to the past 100 days
/coins/{id}/market_chart/range — hourly data up to any 100-day range per request

Previously restricted to Enterprise subscribers. The interval=5m parameter remains Enterprise-only.

GT Verified Badge & Outstanding Token Value for Coin Endpoints

🗓️ March 23, 2026

New `gt_verified` Field

New gt_verified boolean field on Token Info by Token Address and Pool Tokens Info by Pool Address. Learn more about GT Verified →

Example Payload

{
  ...
  "gt_score": 92.6605504587156,
  "gt_verified": true,
  "discord_url": null,
  ...
}

New `outstanding_token_value_usd` & `outstanding_supply` Fields

Two new fields in market_data for Coin Data by ID and Coin Data by Token Address:

outstanding_token_value_usd — outstanding token value in USD (nullable)
outstanding_supply — tokens outstanding in the market, including circulated/tradable or planned-for-circulation tokens (nullable)

Example Payload

"market_data": {
  "market_cap_rank": 1,
  "outstanding_token_value_usd": null,
  ...
  "circulating_supply": 19675962,
  "total_supply": 21000000,
  "outstanding_supply": 20003043.0,
  ...
}

February 2026

Comprehensive Token Holder Analytics with PnL Details

🗓️ February 25, 2026Top Token Holders by Token Address now supports include_pnl_details=true to return PnL metrics and trading analytics for each holder:

average_buy_price_usd — average purchase price per token
total_buy_count / total_sell_count — transaction counts
unrealized_pnl_usd / unrealized_pnl_percentage — unrealized P&L
realized_pnl_usd / realized_pnl_percentage — realized P&L
explorer_url — link to the holder’s address on the blockchain explorer

Example Payload

{
  "data": {
    "id": "base_0x6921b130d297cc43754afba22e5eac0fbf8db75b",
    "type": "top_holder",
    "attributes": {
      "last_updated_at": "2026-02-16T09:56:34.328Z",
      "holders": [
        {
          "rank": 1,
          "address": "0x56bbe4200fdd412854bcf05f2c992827b64ee5c1",
          "label": null,
          "amount": "9703812154.0",
          "percentage": "14.3507",
          "value": "966572.07",
          "average_buy_price_usd": null,
          "total_buy_count": null,
          "total_sell_count": null,
          "unrealized_pnl_usd": null,
          "unrealized_pnl_percentage": null,
          "realized_pnl_usd": null,
          "realized_pnl_percentage": null,
          "explorer_url": "https://basescan.org/address/0x56bbe4200fdd412854bcf05f2c992827b64ee5c1"
        },

Enhanced Pool Discovery and Treasury Analytics with New Sorting and Holdings Metrics

🗓️ February 12, 2026

New Sort Options for Megafilter

Megafilter for Pools now supports four new sort options: price_asc, price_desc, h24_tx_count_asc, h24_volume_usd_asc

Enriched Treasury Holdings Data

Crypto Treasury Holdings by Entity ID now returns additional financial metrics by default:

total_treasury_value_usd, unrealized_pnl, m_nav, total_asset_value_per_share_usd
Per-holding: amount_per_share, entity_value_usd_percentage, current_value_usd, total_entry_value_usd, average_entry_value_usd, unrealized_pnl

Example Payload

{
  "name": "Strategy",
  "id": "strategy",
  "type": "company",
  "symbol": "MSTR.US",
  "country": "US",
  "website_url": "https://www.strategy.com/",
  "twitter_screen_name": "Strategy",
  "total_treasury_value_usd": 48119580010.663155,
  "unrealized_pnl": -6554973853.336845,
  "m_nav": 0.99,
  "total_asset_value_per_share_usd": 150.46302495438903,
  "holdings": [
    {
      "coin_id": "bitcoin",
      "amount": 714644.0,
      "percentage_of_total_supply": 3.403,
      "amount_per_share": 0.0022345892873893874,
      "entity_value_usd_percentage": 100.0,
      "current_value_usd": 48119580010.663155,
      "total_entry_value_usd": 54674553864.0,
      "average_entry_value_usd": 76506.0,
      "unrealized_pnl": -6554973853.336845
    }
  ]
}

New optional parameters for historical tracking:

holding_amount_change — absolute holding changes over time
holding_change_percentage — percentage changes in holdings
Supported timeframes: 7d, 14d, 30d, 90d, 1y, ytd (comma-separated)

Example Payload

  ...
  "total_asset_value_per_share_usd": 150.46302495438903,
  "holdings": [
    {
      "coin_id": "bitcoin",
      "amount": 714644.0,
      "percentage_of_total_supply": 3.403,
      "amount_per_share": 0.0022345892873893874,
      "entity_value_usd_percentage": 100.0,
      "current_value_usd": 48119580010.663155,
      "total_entry_value_usd": 54674553864.0,
      "average_entry_value_usd": 76506.0,
      "unrealized_pnl": -6554973853.336845,
      "holding_amount_change": {
        "7d": 1142.0,
        "14d": 1997.0,
        "30d": 27234.0,
        "90d": 72952.0,
        "1y": 235904.0,
        "ytd": 42144.0
      },
      "holding_change_percentage": {
        "7d": 0.16,
        "14d": 0.28,
        "30d": 3.962,
        "90d": 11.369,
        "1y": 49.276,
        "ytd": 6.267
      }
    }
  ]
}

January 2026

[Upcoming Change] Starknet Address Format Update

🗓️ January 30, 2026Effective February 10, 2026, 02:00 UTC — Starknet addresses (tokens and pools) are being standardized to the padded format (66 characters). This only affects onchain API endpoints and onchain WebSocket channels.

Feature	Change
API Responses	All address fields return in padded format (`0x0...`)
API Requests	Both padded and unpadded formats accepted
WebSockets	Broadcasted messages use padded format
WS Subscriptions	Both padded and unpadded formats accepted

Padded vs. Unpadded

Unpadded: 0x4718... (65 characters)
Padded: 0x04718... (66 characters)

Impact

API requests continue to work with unpadded addresses — the system normalizes inputs automatically
String matching — if your app performs strict comparisons, normalize addresses to a consistent length before comparing
Data storage — future records will include the padding

This change is specific to Starknet. Address formats for other chains remain unaffected.

Streamlined Notification Management with Multi-Recipient Email Alerts

🗓️ January 27, 2026Account owners can now add multiple email recipients for billing alerts and usage threshold notifications from the Notifications dashboard tab. Recipients don’t need CoinGecko accounts.Available on: Analyst plans and above (expanded recipient limits for Enterprise). Learn more →

Enhanced Team Collaboration with Role-Based Dashboard Access

🗓️ January 26, 2026Invite team members to collaborate on your API subscription via the Access dashboard tab — no shared login credentials needed. Collaborators can:

Manage API keys
Monitor credit usage across API and WebSocket
Access billing details from the Stripe portal

A dashboard switcher lets users toggle between multiple team views.Available on: All plans (increased seat limits for higher tiers).Learn more:

Advanced Filtering with Pagination for Treasury Data and Price Change Filters for Megafilter

🗓️ January 22, 2026

Pagination and Sorting for Public Treasury

Crypto Treasury Holdings by Coin ID now supports:

per_page — results per page (1–250, default: 250)
page — paginate through results (default: 1)
order — total_holdings_usd_desc (default) or total_holdings_usd_asc

Price Change Filters for Megafilter

Megafilter for Pools now supports filtering by price change percentage:

price_change_percentage_min — minimum threshold
price_change_percentage_max — maximum threshold
price_change_percentage_duration — time window: 5m, 1h, 6h, 24h

Enhanced Market Analytics with Volume Change Tracking and Historical OHLC for Inactive Coins

🗓️ January 21, 2026

Volume Change Percentage for Global Market Data

New volume_change_percentage_24h_usd field in Crypto Global Market Data:

Example Payload

{
  "market_cap_change_percentage_24h_usd": 0.7227196786856437,
  "volume_change_percentage_24h_usd": -0.2692391926571914,
  "updated_at": 1769062741
}

Historical OHLC for Inactive Coins

Historical candlestick data is now available for inactive and delisted coins:

Expanded WebSocket Streaming with New Intervals and Quote Token Data

🗓️ January 20, 2026

New Intervals for OnchainOHLCV

OnchainOHLCV now supports three new intervals: 15m, 12h, 1dComplete interval options: 1s, 1m, 5m, 15m, 1h, 2h, 4h, 8h, 12h, 1d

Quote Token Amount for OnchainTrade

New toq (quote_token_amount) field in OnchainTrade — the amount of quote token transacted in each swap:

Example Payload

{
  "c": "G2",
  "n": "bsc",
  "pa": "0x172fcd41e0913e95784454622d1c3724f546f849",
  "ty": "b",
  "to": 11.0818733869477,
  "toq": 0.0124384489204242,
  "vo": 11.0724584599832,
  "tx": "0xbc6afc1584fcbef90efe69b96602ef3ba4778727bacfdfece46bbbb075721bb4"
}

Breaking Change: Ticker Trust Score Deprecation

🗓️ January 19, 2026Effective March 3, 2026 — the trust_score field (previously green, yellow, or red) now returns null across all affected endpoints:

Example Payload

    "trust_score": null,
    "bid_ask_spread_percentage": 0.010014,
    "timestamp": "2024-04-08T04:02:01+00:00",

If your application relies on trust_score, update your code to handle null values.

December 2025

Access Inactive Token Data with New `include_inactive_source` Parameter

🗓️ December 16, 2025New include_inactive_source query parameter for retrieving data on tokens with no active pools (no valid swaps in the past 7 days). When set to true, the API sources data from the pool with the most recent swap, regardless of age.Updated endpoints:

Token Data by Token Address and Tokens Data by Token Addresses — new last_trade_timestamp field:
Example Payload
```
    "market_cap_usd": "1544052409.96629",
    "last_trade_timestamp": 1712534400
```

Top Pools by Token Address — new last_trade_timestamp field:

Example Payload

    "reserve_in_usd": "163988541.3812",
    "last_trade_timestamp": 1712534400

Token Price by Token Addresses — new last_trade_timestamp object:

Example Payload

  "total_reserve_in_usd": {
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.946697"
  },
  "last_trade_timestamp": {
    "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400
  }

Token OHLCV Chart by Token Address — no payload changes

Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens

🗓️ December 15, 2025Changes to how rehypothecated tokens (wrapped assets, liquid staking tokens) are ranked in market cap data. Read the full announcement →Effective February 4, 2026. If your application does not handle rehypothecated tokens specifically, no action is required.

Coin Data by ID and Coin Data by Token Address

/coins/{id} and /coins/{id}/contract/{contract_address}:

Breaking: market_cap_rank returns null for rehypothecated tokens
New field: market_cap_rank_with_rehypothecated — available in both the parent object and market_data

Example Payload

{
  "market_cap_rank": 1,
  "market_cap_rank_with_rehypothecated": 1,
  "market_data": {
    ...
    "market_cap_rank": 1,
    "market_cap_rank_with_rehypothecated": 1,
    "fully_diluted_valuation": { ... }
  }
}

Coins List with Market Data

/coins/markets:

Breaking: Rehypothecated tokens are excluded by default (when using category, they’re included but market_cap_rank returns null)
New parameter: include_rehypothecated (boolean, default: false)
New field (conditional): market_cap_rank_with_rehypothecated — only present when include_rehypothecated=true

Example Payload

{
  "market_cap_rank": 1,
  "last_updated": "2026-02-05T08:44:05.527Z",
  "market_cap_rank_with_rehypothecated": 1
}

New Top Traders by Token Address Endpoint

🗓️ December 4, 2025Top Traders by Token Address — monitor whale activity, track significant holders, and analyze trading patterns for any token.

Example Payload

{
  "data": {
    "id": "base_0x6921b130d297cc43754afba22e5eac0fbf8db75b",
    "type": "top_trader",
    "attributes": {
      "traders": [
        {
          "address": "0xf748879edbe8cca140940788163d7be4d2a2e46a",
          "name": "@zimagetsfox",
          "label": "zimagetsfox.eth",
          "type": "other",
          "realized_pnl_usd": "1157358.77",
          "unrealized_pnl_usd": "255071.37",
          "token_balance": "1454984.43",
          "average_buy_price_usd": "0.01144",
          "average_sell_price_usd": "0.03460",
          "total_buy_count": 48,
          "total_sell_count": 109,
          "total_buy_token_amount": "51422264.86",
          "total_sell_token_amount": "49967280.42",
          "total_buy_usd": "588308.47",
          "total_sell_usd": "1729021.16",
          "explorer_url": "https://etherscan.io/address/0xf748879edbe8cca140940788163d7be4d2a2e46a"
        }
      ]
    }
  }
}

November 2025

New Public Treasury Endpoints: Historical Holdings and Transactions History

🗓️ November 27, 2025Two new treasury endpoints — both support ID lookup via entity or coin IDs. See live data at coingecko.com/en/treasuries/companies/strategy.

Historical Holdings Chart

Crypto Treasury Holdings Historical Chart Data by ID — query historical holdings for public companies and governments.

Example Payload

{
  "holdings": [
    [1763683200000, 649870.0],
    ...
  ],
  "holding_value_in_usd": [
    [1763683200000, 56311217680.033195],
    ...
  ]
}

Transaction History

Crypto Treasury Transaction History by Entity ID — retrieve detailed transaction history.

Example Payload

{
  "transactions": [
    {
      "date": 1763337600000,
      "source_url": "https://assets.contentstack.io/v3/assets/.../form-8-k_11-17-2025.pdf",
      "coin_id": "bitcoin",
      "type": "buy",
      "holding_net_change": 8178.0,
      "transaction_value_usd": 835554438.0,
      "holding_balance": 649870.0,
      "average_entry_value_usd": 102171.0
    }
  ]
}

🗓️ November 15, 2025

GT Community Data for More Pool Endpoints

Flag include_gt_community_data=true to receive sentiment voting and community reporting data:

Example Payload

        "reserve_in_usd": "163988541.3812",
        "sentiment_vote_positive_percentage": 60,
        "sentiment_vote_negative_percentage": 40,
        "community_sus_report": 18

Improved endpoints:

farcaster_url and zora_url fields are now included by default in token info endpoints:

Example Payload

      "discord_url": null,
      "farcaster_url": null,
      "zora_url": null,
      "telegram_handle": null,

True Real-Time Data Update: Cache Removed for Key On-chain Endpoints

🗓️ November 14, 2025

Applicable to all paid plan subscribers.

The 10-second edge cache has been completely removed for the following endpoints — requests now return data directly from origin with zero cache delay:

Effective From	Endpoints
December 1, 2025	Token Price by Token Addresses
December 2, 2025	Past 24 Hour Trades by Pool Address
December 3, 2025	Past 24 Hour Trades by Token Address

Requests that hit the origin server may use additional credits. To avoid extra credit usage, maintain a polling interval of 10 seconds or more.

Onchain OHLCV Support Extended to Pools with 3+ Tokens

🗓️ November 8, 2025Onchain OHLCV endpoints now support pools with more than 2 tokens — e.g. crvUSD/WETH/CRV.

October 2025

WebSocket is now supported for Self-serve API subscribers

🗓️ October 23, 2025

WebSocket (Beta) for Paid Plan Subscribers

Self-serve customers (Analyst, Lite, Pro, Pro+) can now stream real-time data via WebSocket using monthly API plan credits:

Max connections: 10 concurrent sockets
Max subscriptions: 100 token or pool subscriptions per channel, per socket
Channel access: all 4 channels
Credit charge: 0.1 credit per response

Notice: Temporary MagicEden NFT Data Disruption

Due to MagicEden API updates, NFT data endpoints may temporarily return incomplete data while the integration is updated.

More Bonding Curve Support and New Ascending Sort for Megafilter

🗓️ October 4, 2025

Bonding Curve Data for More Endpoints

Bonding curve (launchpad graduation) data is now available on token endpoints:

Example Payload

"launchpad_details": {
  "graduation_percentage": 2.16,
  "completed": false,
  "completed_at": null,
  "migrated_destination_pool_address": null
}

Megafilter: Ascending Sort for Price Change %

Megafilter for Pools now supports ascending sort options: m5_price_change_percentage_asc, h1_price_change_percentage_asc, h6_price_change_percentage_asc, h24_price_change_percentage_asc

Token OHLCV: Bug Fix

Fixed an issue where Token OHLCV Chart by Token Address returned data for the base token of the top pool instead of the requested token.

September 2025

SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support

🗓️ September 25, 2025

Expanded SDK Coverage for Public Treasuries

New functions in the TypeScript SDK:

publicTreasury.getCoinID(coinID, { ...params }) — query holdings by Coin ID
publicTreasury.getEntityID(entityID) — query holdings by Entity ID
entities.getList({ ...params }) — list all supported entities with ID, name, symbol, and country

New MCP Tools: Exchanges, NFTs & Multi-Address Queries

New tools:

Exchange coverage: /exchanges/list, /exchanges/{id}, /exchanges/{id}/tickers, /exchanges/{id}/volume_chart/range
NFT markets: /nfts/markets
Multi-address queries: /onchain/networks/{network}/pools/multi/{addresses}, /onchain/networks/{network}/tokens/multi/{addresses}

Retired tools:

Removed /coins/list, /onchain/networks/trending_pools, and single-address pool/token queries in favor of multi-address endpoints

MCP: ISO Date String Support

MCP tools now accept ISO date strings (YYYY-MM-DD or YYYY-MM-DDTHH:MM) alongside UNIX timestamps — no more manual conversion for time-based queries like Coin Historical Chart Data within Time Range.

New Crypto Treasury Endpoints and Improvements

🗓️ September 19, 2025

Crypto Treasury Holdings by Coin ID now supports governments and more coins — see coingecko.com/en/treasuries/bitcoin
New endpoints:
- Crypto Treasury Holdings by Entity ID
- Entities List (ID Map)
Derivatives Exchange Data by ID now supports coin_id and target_coin_id to identify coins of ticker pairs:

Example Payload

"tickers": [
  {
    "symbol": "ASTERUSDT",
    "base": "ASTER",
    "target": "USDT",
    "coin_id": "aster-2",
    "target_coin_id": "tether"
  }
]

Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More

🗓️ September 12, 2025

Bonding Curve Data

Launchpad graduation data is now available on Specific Pool Data by Pool Address and Multiple Pools Data by Pool Addresses:

Example Payload

"launchpad_details": {
  "graduation_percentage": 100,
  "completed": true,
  "completed_at": "2024-04-08T16:52:35Z",
  "migrated_destination_pool_address": "5wNu5QhdpRGrL37ffcd6TMMqZugQgxwafgz477rShtHy"
}

Pooled Token Balance Data

Flag include_composition=true to get pool token balance breakdowns:

Specific Pool Data by Pool Address
Multiple Pools Data by Pool Addresses
Token Data by Token Address (also requires include=top_pools)
Tokens Data by Token Addresses (also requires include=top_pools)

Example Payload

"base_token_balance": "11700.98",
"base_token_liquidity_usd": "29630000",
"quote_token_balance": "66384614.21",
"quote_token_liquidity_usd": "66330000",

Other Improvements

Megafilter for Pools — new sort options: m5_price_change_percentage_desc, h1_price_change_percentage_desc, h6_price_change_percentage_desc, fdv_usd_asc, fdv_usd_desc, reserve_in_usd_asc, reserve_in_usd_desc

Top Gainers & Losers — new price_change_percentage parameter with options: 1h, 24h, 7d, 14d, 30d, 60d, 200d, 1y

Example Payload

"usd_1y_change": 21740.8866287307,
"usd_1h_change": -0.279590756868549,
"usd_24h_change": 3.13876587906131,
"usd_7d_change": -9.67782096261206,
"usd_14d_change": -3.39755498745517,
"usd_30d_change": -13.7768698159765,
"usd_60d_change": 29.9096824213076,
"usd_200d_change": 2282.33681679488

Exchange Tickers by ID — new order options: market_cap_desc, market_cap_asc

August 2025

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

🗓️ August 18, 2025

Applicable to all paid plan subscribers.

Edge cache durations for the following onchain endpoints have been reduced from 30s to 10s:

Effective From	Endpoints
September 2, 2025	Token Price by Token Addresses Token Data by Token Address Tokens Data by Token Addresses
September 3, 2025	Specific Pool Data by Pool Address Multiple Pools Data by Pool Addresses
September 4, 2025	Pool OHLCV Chart by Pool Address Token OHLCV Chart by Token Address Past 24 Hour Trades by Pool Address Past 24 Hour Trades by Token Address

Cached responses incur no extra credits. Requests that bypass the cache and hit the origin server may use additional credits — adjust your polling interval accordingly.

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

🗓️ August 5, 2025

Launchpad Data (Pump.fun & More)

Token data from popular launchpad platforms is now available through the API:

Launchpad	Network	DEX ID
Meteora DBC	solana	`meteora-dbc`
Pump.fun	solana	`pump-fun`
Raydium Launchpad (LetsBonkFun)	solana	`raydium-launchlab`
Boop.fun	solana	`boop-fun`
Virtuals (Base)	base	`virtuals-base`

Improved endpoints:

Tip: Use Megafilter for Pools with sort=pool_created_at_desc to retrieve the latest launchpad pools.

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

Granular OHLCV Data

Onchain OHLCV endpoints now support sub-minute intervals down to 1-second granularity:

Timeframe	Aggregates
day	1
hour	1, 4, 12
minute	1, 5, 15
second	1, 15, 30 (new)

Improved endpoints:

Paid plan subscribers (Analyst & above) only.

https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/second?aggregate=1&limit=100&x_cg_pro_api_key=YOUR_KEY

Honeypot Detection

Token Info by Token Address and Pool Tokens Info by Pool Address now include is_honeypot (values: true, false, or unknown):

Example Payload

{
  "mint_authority": null,
  "freeze_authority": null,
  "is_honeypot": true
}

Megafilter: Include Unknown Honeypot Tokens

Megafilter for Pools now supports include_unknown_honeypot_tokens=true to include tokens with unknown honeypot status. Only takes effect when checks=no_honeypot is also specified.

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

Pool Tokens Info: Expanded Pool Data

Pool Tokens Info by Pool Address now supports include=pool to retrieve pool context:

Base and quote token addresses
Sentiment vote percentages (positive/negative)
Community suspicious reports count

Example Payload

"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, 2025Real-time and historical price and market data can now be returned in SOL (Solana) currency across the following endpoints:

For dates prior to May 2025, SOL historical data is limited to hourly and daily granularity.

Example — price of Bitcoin in SOL:

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

Example — historical daily data of Trump in SOL:

{
  "prices": [
    [1750118400000, 0.0640701365814472],
    [1750204800000, 0.0644263929356261],
    [1750291200000, 0.0639713357587322]
  ],
  "market_caps": [
    [1750118400000, 12843589.584485611],
    [1750204800000, 12882547.839086628],
    [1750291200000, 12793790.726102708]
  ],
  "total_volumes": [
    [1750118400000, 2425793.780846796],
    [1750204800000, 2055697.9106767387],
    [1750291200000, 1871087.4334618242]
  ]
}

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

🗓️ June 9, 2025

New Endpoint: Historical Token Holders Chart

Historical Token Holders Chart by Token Address — get the historical token holders chart for a token on a network.Supported chains: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, Ronin

Paid plan subscribers (Analyst & above) only.

New Endpoint: Token OHLCV by Token Address

Token OHLCV Chart by Token Address — get OHLCV data for a token based on its most liquid pool. Use Top Pools by Token Address to check which pool is used.

Paid plan subscribers (Analyst & above) only.

Multi-pool Token Data Support

For pools with 3+ tokens, extra quote tokens are now listed under relationships.quote_tokens. If include=quote_token is flagged, the extra tokens also appear under included.

Example Payload

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

Applies to all onchain pool endpoints with relationships.quote_token, including:

May 2025

Upcoming Change Notice: Removal of normalized_volume_btc Data

🗓️ May 30, 2025Effective June 16, 2025 — the trade_volume_24h_btc_normalized field has been removed from the following endpoints, due to changes in a third-party data source:

{
  "trade_volume_24h_btc_normalized": 47765.5886637453
}

If your application relies on trade_volume_24h_btc_normalized, update your code to handle its absence.

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

🗓️ May 29, 2025

New Endpoint: Onchain Trades by Token Address

Past 24 Hour Trades by Token Address retrieves the last 300 trades across different pools for a token, unlike Past 24 Hour Trades by Pool Address which is limited to a single pool.

Paid plan subscribers (Analyst & above) only.

Net Buy Volume Data

Specific Pool Data by Pool Address and Multiple Pools Data by Pool Addresses now support include_volume_breakdown=true, returning:

net_buy_volume_usd
buy_volume_usd
sell_volume_usd

Example Payload

{
  "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",
        "h24": "52666266.729011402"
      },
      "sell_volume_usd": {
        "m5":  "71394.010719438",
        "h24": "35110844.486007601"
      }
    }
  }
}

OHLCV: Empty Interval Padding

Pool OHLCV Chart by Pool Address now supports include_empty_intervals=true. Intervals with no recorded swaps are padded — OHLC values follow the previous close, and volume is set to zero.

Example Payload

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

Token Info: Large Image Sizes

Token Info by Token Address and Pool Tokens Info by Pool Address now include an image object with thumb, small, and large URLs:

Example Payload

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

Token Data: Normalized Total Supply

Token Data by Token Address and Tokens Data by Token Addresses now include normalized_total_supply:

Example Payload

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

Pool Data: Pool Name and Fee

Specific Pool Data by Pool Address and Multiple Pools Data by Pool Addresses now include pool_name and pool_fee_percentage:

Example Payload

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

DEX Pair Symbols

Flag dex_pair_format=symbol to return DEX pair symbols instead of contract addresses on:

Before:

{
  "base": "0X8FC8F8269EBCA376D046CE292DC7EAC40C8D358A",
  "target": "0XA0B86991C6218B36C1D19D4A2E9EB0CE3606EB48"
}

After (dex_pair_format=symbol):

{
  "base": "DFI",
  "target": "USDC"
}

April 2025

🗓️ April 25, 2025Trending Search Pools returns onchain trending pools and tokens as seen on GeckoTerminal.com. Returns top 4 pools by default — set pools to retrieve up to 10.Tip: Flag include=base_token to also retrieve trending token data.

Paid plan subscribers (Analyst & above) only.

Trending Search List now supports show_max to retrieve more trending results for paid plan subscribers:

Trending Data	Demo	Analyst & Above
Coins	15	30
NFTs	7	10
Coin Categories	6	10

Token Lookup by Symbol and Name

Coin Price by IDs and Coins List with Market Data now support token lookup by symbol and name, in addition to API ID.

API ID	Symbol	Name
bitcoin	btc	Bitcoin
tether	usdt	Tether
usd-coin	usdc	USDC

Lookup priority: id (highest) > name > symbol (lowest).Filtering by symbol with include_tokens:

include_tokens=top — returns only the top market cap token for the symbol
include_tokens=all — returns all tokens sharing the symbol

/coins/markets: Pagination Response Headers

Coins List with Market Data now includes total and per-page values in the response headers, enabling accurate pagination across all active coins.

Response Header (Example)

per-page: 250
total: 16989

Upcoming Change Notice: Removal of twitter_followers Data

🗓️ April 25, 2025Effective May 15, 2025 — the twitter_followers field within community_data has been removed from the following endpoints, due to changes in the X (formerly Twitter) API:

"community_data": {
  "twitter_followers": 7694251
}

If your application relies on twitter_followers, update your code to handle its absence.

March 2025

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

🗓️ March 28, 2025

New Endpoint: Top Token Holder Address Data

Access the top 50 token holder addresses, as seen on GeckoTerminal.com. Returns top 10 by default — set holders to retrieve up to 50.Top Token Holders by Token Address →Supported networks: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base, Solana, Sui, TON, Ronin

Paid plan subscribers (Analyst & above) only. Holders data is in Beta — data quality, coverage, and update frequency are being improved. Solana tokens support a maximum of 40 holders.

Tip: Use Token Info by Token Address or Pool Tokens Info by Pool Address for holders count and top holders distribution percentage.

Historical Supply: Support for Inactive Coins

Historical total and circulating supply data is now available for inactive coins. Use Coin List (ID Map) with status=inactive to find inactive coin IDs.

Enterprise plan only.

Onchain Pool Data: Locked Liquidity

New locked_liquidity_percentage field available on:

Example Payload

{
  "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: GT Score, Mint Authority, Freeze Authority

Token Info endpoints now include security-related fields:

GT Score Details — breakdown by pool, transaction, creation, info, and holders. Learn more.
Mint Authority and Freeze Authority

Improved endpoints:

Example Payload

        "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: Market Cap to FDV Fallback

Token Price by Token Addresses now supports mcap_fdv_fallback=true — when a token’s market cap is unverified, the market_cap_usd field returns the FDV value instead (matching GeckoTerminal.com behavior).

Unverified tokens return null for market cap by default, even if GeckoTerminal shows a value (which may equal FDV)
Verified market cap is sourced from CoinGecko and may exceed FDV when it includes tokens on other chains

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

🗓️ March 14, 2025

Applicable to paid plan subscribers (Analyst & above) only.

Edge cache durations for the following onchain endpoints have been reduced from 60s to 30s:

Effective From	Endpoints
March 25, 2025	Trending Pools List Trending Pools by Network Top Pools by Network Top Pools by DEX
March 26, 2025	New Pools by Network New Pools List Megafilter for Pools Search Pools
March 27, 2025	Top Pools by Token Address Most Recently Updated Tokens List Pools by Category ID

Cached responses incur no extra credits. Requests that bypass the cache and hit the origin server may use additional credits — adjust your polling interval accordingly.

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

🗓️ March 14, 2025

Onchain Token Info: Holders Data (Beta)

New holder fields available:

holders.count — total holder count
holders.distribution_percentage — top 10, 11–20, 21–40, and rest breakdown

Improved endpoints:

Example Payload

    "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: New Intervals

New time intervals for price_change_percentage, volume_usd, and transactions:

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

Improved endpoints:

Example Payload

        "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: Liquidity & Price Change

Token Price by Token Addresses now supports two new optional parameters:

include_24hr_price_change — 24h price change percentage
include_total_reserve_in_usd — total liquidity attributable to a token across all pools

Example Payload

{
  "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, 2025The CoinGecko API now supports onchain data across 200+ blockchain networks, including Hyperliquid, HyperEVM, Abstract, Berachain, Story, Monad, Unichain, and Soneium.A new endpoint for slicing and dicing onchain pool data with full flexibility. Megafilter for Pools →

Filter across 200+ networks, 1,400+ DEXes, 6M+ pools, and 5M+ tokens
Advanced filters by liquidity, FDV, volume, transactions, buy/sell trends, and time range
Custom sorting — trending pools (5m), newest pools, liquidity growth, and more
Fraud detection — exclude honeypots, check GT Score, verify CG listings, track social metrics

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 and fraud checks

Paid plan subscribers (Analyst & above) only.

Update Frequency Improvements for selected Pro-API endpoints

🗓️ February 14, 2025

Applicable to paid plan subscribers (Analyst & above) only.

Edge cache durations for the following onchain endpoints have been reduced from 60s to 30s:

Effective From	Endpoints
February 24, 2025	/networks/../tokens/ /networks/../tokens/multi/
February 25–26, 2025	/networks/../pools/../ohlcv

Cached responses incur no extra credits. Requests that bypass the cache and hit the origin server may use additional credits — adjust your polling interval accordingly.

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

🗓️ February 9, 2025

Onchain Metadata: Improved Coverage

Metadata coverage (images, websites, description, socials) is now improved for tokens on Solana, TON, Base, and Sui. Tokens without image data now return null for image_url instead of missing.png.Endpoints with improved image data:

Endpoints with improved full metadata (images, websites, description, socials):

Onchain metadata may be sourced on-chain and is not vetted by CoinGecko. For reviewed metadata, use Coin Data by ID or Coin Data by Token Address.

Max Address Limit Increased for /multi Endpoints

Onchain /multi endpoints now support up to 50 token or pool addresses per request (previously 30):

Paid plan subscribers (Analyst & above) only.

Exchange Tickers: New `base_target` Sort Order

Exchange Tickers by ID now supports order=base_target, which sorts tickers by base symbol then target symbol in lexicographical order. This ensures stable pagination — the default trust_score_desc sort can cause duplicates or missing tickers when ranks shift between paginated requests.

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

January 2025

Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter

🗓️ January 27, 2025

Onchain Pools: Pagination Beyond 10 Pages

Paid plan subscribers (Analyst & above) can now access more than 10 pages of pools data on the following endpoints:

Onchain Trades: Token Filter

Past 24 Hour Trades by Pool Address now supports a token parameter to filter trades by base or quote token:

?token=base — base token trades only
?token=quote — quote token trades only
?token={token_address} — trades for a specific token address

Multiple Improvements: Onchain Token Price, NFT Market Cap

🗓️ January 24, 2025

Onchain Simple Token Price: Market Cap and 24h Volume

Token Price by Token Addresses now supports include_market_cap=true and include_24hr_vol=true:

Example Payload

{
  "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: Market Cap Rank

market_cap_rank is now available for NFT collections via:

Example Payload

  "market_cap_rank": 75,

Removal of Unsupported Categories

🗓️ January 23, 2025The following categories have been removed from CoinGecko and the API, effective February 12, 2025:

Category Name	Category ID
US Election 2020	`us-election-2020`
Governance	`governance`
Cryptocurrency	`cryptocurrency`
Technology and Science	`technology-science`
Presale Meme	`presale-meme-coins`
Business Platform	`business-platform`
Number	`number`
Structured Product	`structured-products`
Investment	`investment`
Niftex Shards	`niftex-shards`
Ethereum POW IOU	`ethereum-pow-iou`
Mirrored Assets	`mirrored-assets`
Remittance	`remittance`
Protocol	`protocol`
Unicly Ecosystem	`utokens`
Finance and Banking	`finance-banking`
Eth 2.0 Staking	`eth-2-0-staking`

These categories were either empty (no associated coins) or outdated. Requests to /coins/markets specifying any of these categories will return an error.

Extended Historical Data for Onchain OHLCV Endpoint

🗓️ January 15, 2025The Pool OHLCV Chart by Pool Address endpoint now supports historical data going back to September 2021, depending on when the pool was first tracked on GeckoTerminal.

Before: Limited to the past 6 months from today
After: Data available from September 2021 to present
Each request is still limited to a 6-month date range — use the before_timestamp parameter to page through older data

Access to data beyond the past 6 months requires a paid plan (Analyst & above).

No changes required for existing integrations.

Update to Total Supply of POW Coins

🗓️ January 15, 2025Total Supply for PoW (Proof-of-Work) coins now reflects the actual number of mined coins, rather than the maximum supply. This also applies to historical Total Supply data.

Before: Maximum possible supply (e.g., Bitcoin: 21,000,000)
After: Actual mined coins (e.g., Bitcoin: ~19,500,000 as of January 2025)

Affected endpoints with total_supply data:

Timeline:

Bitcoin: Updated January 14, 2025
Other PoW coins: Updated January 22, 2025 — including Bitcoin Cash, Litecoin, Ethereum Classic, Bitcoin SV, Zcash, eCash, Dash, Kadena, Decred, Flux, DigiByte, Ravencoin, Groestlcoin, Firo, Vertcoin, Handshake, and more

Improved Update Frequency for selected Pro-API endpoints

🗓️ January 13, 2025

Applicable to paid plan subscribers (Analyst & above) only.

Edge cache durations for the following endpoints have been reduced to 20–30s:

Endpoint	Previous	New
/simple/price	30s	20s
/simple/token_price	30s	20s
/simple/networks/../token_price	60s	30s
/networks/../pools/../trades	60s	30s
/networks/../pools/..	60s	30s
/networks/../pools/multi/..	60s	30s

Cached responses incur no extra credits. Requests that bypass the cache and hit the origin server may use additional credits — adjust your polling interval accordingly.

Improved 5-minutely data for Historical Chart Data endpoints

🗓️ January 9, 2025The last 48 hours of data is no longer excluded from the following historical chart endpoints:

Note: The interval=5m and interval=hourly params are exclusive to Enterprise plan subscribers, bypassing auto-granularity:

interval=5m — 5-minutely data, up to any 10-day range per request. Available from 9 February 2018 onwards.
interval=hourly — hourly data, up to any 100-day range per request. Available from 30 January 2018 onwards.

For non-Enterprise subscribers, leave interval 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)

​New Token Info Fields: Developer Address & Holding Percentage

​New Megafilter Parameters: Holder Count & Top Holders Percentage

​New Endpoint: Coin Supply Breakdown

​New Endpoint: Coin Insights

​Breaking Change: Sparkline Image URL Domain Migration for Trending Search

​Introducing Webhooks — Real-Time Push Notifications for Coin Data Changes

​Higher Minute Rate Limits for Demo & Basic Plans

​Track Per-Key Monthly API Usage with /key Endpoint

​Stay Ahead with the New Crypto News Endpoint

​CGSimplePrice WebSocket Now Supports vs_currencies

​interval=hourly Now Available for All Plans on Coin Market Chart Endpoints

​GT Verified Badge & Outstanding Token Value for Coin Endpoints

​New gt_verified Field

​New outstanding_token_value_usd & outstanding_supply Fields

​Comprehensive Token Holder Analytics with PnL Details

​Enhanced Pool Discovery and Treasury Analytics with New Sorting and Holdings Metrics

​New Sort Options for Megafilter

​Enriched Treasury Holdings Data

​[Upcoming Change] Starknet Address Format Update

​Padded vs. Unpadded

​Impact

​Streamlined Notification Management with Multi-Recipient Email Alerts

​Enhanced Team Collaboration with Role-Based Dashboard Access

​Advanced Filtering with Pagination for Treasury Data and Price Change Filters for Megafilter

​Pagination and Sorting for Public Treasury

​Price Change Filters for Megafilter

​Enhanced Market Analytics with Volume Change Tracking and Historical OHLC for Inactive Coins

​Volume Change Percentage for Global Market Data

​Historical OHLC for Inactive Coins

​Expanded WebSocket Streaming with New Intervals and Quote Token Data

​New Intervals for OnchainOHLCV

​Quote Token Amount for OnchainTrade

​Breaking Change: Ticker Trust Score Deprecation

​Access Inactive Token Data with New include_inactive_source Parameter

​Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens

​Coin Data by ID and Coin Data by Token Address

​Coins List with Market Data

​New Top Traders by Token Address Endpoint

​New Public Treasury Endpoints: Historical Holdings and Transactions History

​Historical Holdings Chart

​Transaction History

​GT Community Data for More Pool Endpoints, plus Farcaster and Zora Social URL Support

​GT Community Data for More Pool Endpoints

​Farcaster and Zora Social URLs

​True Real-Time Data Update: Cache Removed for Key On-chain Endpoints

​Onchain OHLCV Support Extended to Pools with 3+ Tokens

​WebSocket is now supported for Self-serve API subscribers

​WebSocket (Beta) for Paid Plan Subscribers

​Notice: Temporary MagicEden NFT Data Disruption

​More Bonding Curve Support and New Ascending Sort for Megafilter

​Bonding Curve Data for More Endpoints

​Megafilter: Ascending Sort for Price Change %

​Token OHLCV: Bug Fix

​SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support

​Expanded SDK Coverage for Public Treasuries

​New MCP Tools: Exchanges, NFTs & Multi-Address Queries

​MCP: ISO Date String Support

​New Crypto Treasury Endpoints and Improvements

​Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More

​Bonding Curve Data

​Pooled Token Balance Data

​Other Improvements

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

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

​Launchpad Data (Pump.fun & More)

​Granular OHLCV Data

​Honeypot Detection

​Megafilter: Include Unknown Honeypot Tokens

​Pool Tokens Info: Expanded Pool Data

​SOL Currency Is Now Supported for CoinGecko Endpoints

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

​New Endpoint: Historical Token Holders Chart

​New Endpoint: Token OHLCV by Token Address

​Multi-pool Token Data Support

​Upcoming Change Notice: Removal of normalized_volume_btc Data

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

​New Endpoint: Onchain Trades by Token Address

​Net Buy Volume Data

​OHLCV: Empty Interval Padding

​Token Info: Large Image Sizes

New Token Info Fields: Developer Address & Holding Percentage

New Megafilter Parameters: Holder Count & Top Holders Percentage

New Endpoint: Coin Supply Breakdown

New Endpoint: Coin Insights

Breaking Change: Sparkline Image URL Domain Migration for Trending Search

Introducing Webhooks — Real-Time Push Notifications for Coin Data Changes

Higher Minute Rate Limits for Demo & Basic Plans

Track Per-Key Monthly API Usage with `/key` Endpoint

Stay Ahead with the New Crypto News Endpoint

CGSimplePrice WebSocket Now Supports `vs_currencies`

`interval=hourly` Now Available for All Plans on Coin Market Chart Endpoints

GT Verified Badge & Outstanding Token Value for Coin Endpoints

New `gt_verified` Field

New `outstanding_token_value_usd` & `outstanding_supply` Fields

Comprehensive Token Holder Analytics with PnL Details

Enhanced Pool Discovery and Treasury Analytics with New Sorting and Holdings Metrics

New Sort Options for Megafilter

Enriched Treasury Holdings Data

[Upcoming Change] Starknet Address Format Update

Padded vs. Unpadded

Impact

Streamlined Notification Management with Multi-Recipient Email Alerts

Enhanced Team Collaboration with Role-Based Dashboard Access

Advanced Filtering with Pagination for Treasury Data and Price Change Filters for Megafilter

Pagination and Sorting for Public Treasury

Price Change Filters for Megafilter

Enhanced Market Analytics with Volume Change Tracking and Historical OHLC for Inactive Coins

Volume Change Percentage for Global Market Data

Historical OHLC for Inactive Coins

Expanded WebSocket Streaming with New Intervals and Quote Token Data

New Intervals for OnchainOHLCV

Quote Token Amount for OnchainTrade

Breaking Change: Ticker Trust Score Deprecation

Access Inactive Token Data with New `include_inactive_source` Parameter

Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens

Coin Data by ID and Coin Data by Token Address

Coins List with Market Data

New Top Traders by Token Address Endpoint

New Public Treasury Endpoints: Historical Holdings and Transactions History

Historical Holdings Chart

Transaction History

GT Community Data for More Pool Endpoints, plus Farcaster and Zora Social URL Support

GT Community Data for More Pool Endpoints

Farcaster and Zora Social URLs

True Real-Time Data Update: Cache Removed for Key On-chain Endpoints

Onchain OHLCV Support Extended to Pools with 3+ Tokens

WebSocket is now supported for Self-serve API subscribers

WebSocket (Beta) for Paid Plan Subscribers

Notice: Temporary MagicEden NFT Data Disruption

More Bonding Curve Support and New Ascending Sort for Megafilter

Bonding Curve Data for More Endpoints

Megafilter: Ascending Sort for Price Change %

Token OHLCV: Bug Fix

SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support

Expanded SDK Coverage for Public Treasuries

New MCP Tools: Exchanges, NFTs & Multi-Address Queries

MCP: ISO Date String Support

New Crypto Treasury Endpoints and Improvements

Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More

Bonding Curve Data

Pooled Token Balance Data

Other Improvements

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

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

Launchpad Data (Pump.fun & More)

Granular OHLCV Data

Honeypot Detection

Megafilter: Include Unknown Honeypot Tokens

Pool Tokens Info: Expanded Pool Data

SOL Currency Is Now Supported for CoinGecko Endpoints

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

New Endpoint: Historical Token Holders Chart

New Endpoint: Token OHLCV by Token Address

Multi-pool Token Data Support

Upcoming Change Notice: Removal of normalized_volume_btc Data

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

New Endpoint: Onchain Trades by Token Address

Net Buy Volume Data

OHLCV: Empty Interval Padding

Token Info: Large Image Sizes