> ## Documentation Index > Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > Product updates and announcements export const GreenSeparator = () => (
); ## Breaking Change: Sparkline Image URL Domain Migration for Trending Search πŸ—“οΈ **May 20, 2026** Starting **June 4, 2026**, the `sparkline` image URLs returned by the [Trending Search List](/reference/trending-search) (`/search/trending`) endpoint will be migrated from `www.coingecko.com` to `data.coingecko.com` This affects the `sparkline` field across all three sections of the response: **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` | **Action required:** If your application references or validates the sparkline URL domain, update your code to use the new `data.coingecko.com` domain before June 4, 2026. ## Introducing Webhooks β€” Real-Time Push Notifications for Coin Data Changes πŸ—“οΈ **May 19, 2026** CoinGecko now supports [Webhooks](/webhooks) β€” receive real-time push notifications to your server whenever specific data changes occur, eliminating the need for constant API polling or cron jobs. * Currently supports the [`cg.coin.info.updated`](/webhooks/cg-coin-info-updated) event β€” triggers whenever there is an update to the core information of a coin (e.g. `name`, `symbol`, `categories`, `platforms`, `links`, `image`, `public_notices`, and more) * Set up your webhook endpoint via the [Developer Dashboard](https://www.coingecko.com/en/developers/dashboard#webhook), each payload is signed with HMAC SHA256 for security verification * 10 credits per event delivery β€” retry attempts are free * Up to 5 webhook endpoints per account > πŸ’Ό Exclusive for Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise). [Learn more β†’](/webhooks) ## Higher Minute Rate Limits for Demo & Basic Plans πŸ—“οΈ **May 17, 2026** We've increased the requests-per-minute (RPM) rate limits for Demo and Basic plan subscribers: | Plan | Previous RPM | New RPM | | --------------- | :----------: | :-----: | | **Demo (Free)** | 30 | **100** | | **Basic** | 250 | **300** | No action is needed on your end β€” the new limits are already in effect. ## Track Per-Key Monthly API Usage with `/key` Endpoint πŸ—“οΈ **May 17, 2026** The [/key](/reference/check-api-server-status) endpoint 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. ```json Example Payload {8} theme={null} { "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 } ``` This field is available for accounts with custom per-key rate limits enabled. Interested in setting up per-key limits? [Contact sales](https://www.coingecko.com/en/api/enterprise) to get started. ## Stay Ahead with the New Crypto News Endpoint πŸ—“οΈ **March 27, 2026** Get real-time crypto news and in-depth guides delivered straight from CoinGecko with the new [/news](/reference/news) endpoint! * Query all the latest crypto news, as seen on [CoinGecko News](https://www.coingecko.com/en/news) * Filter news by a specific coin using `coin_id` * Filter by `language` and `type` (news, guides, or both) * Supports pagination with `page` and `per_page` parameters ```json Example Payload expandable theme={null} [ { "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, 2026** The [CGSimplePrice](/websocket/cgsimpleprice) WebSocket channel now supports specifying preferred exchange rates via `vs_currencies`! * Specify one or more target currencies using `vs_currencies` in the subscription data (e.g. `["usd","eur"]`) * Choose from any currency supported by [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies) * If `vs_currencies` is not specified, data is returned in USD by default * A new `vs` field is included in every response payload indicating the target currency **Input Example:** ```json theme={null} { "command": "message", "identifier": "{\"channel\":\"CGSimplePrice\"}", "data": "{\"coin_id\":[\"ethereum\",\"bitcoin\"],\"vs_currencies\":[\"usd\",\"eur\"],\"action\":\"set_tokens\"}" } ``` **Response now includes `vs` field:** ```json {4} theme={null} { "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, 2026** The `interval=hourly` parameter is now accessible to all API users (Demo, Basic, Analyst & above) for the coin market chart endpoints: * [/coins/\{id}/market\_chart](/reference/coins-id-market-chart) β€” hourly data up to the **past 100 days** * [/coins/\{id}/market\_chart/range](/reference/coins-id-market-chart-range) β€” hourly data up to **any 100 days** date range per request Previously restricted to Enterprise plan subscribers, you can now bypass auto-granularity by specifying `interval=hourly` on any plan. The `interval=5m` parameter remains exclusive to Enterprise subscribers. ## GT Verified Badge & Outstanding Token Value for Coin Endpoints πŸ—“οΈ **March 23, 2026** ### New `gt_verified` Field for Onchain Token & Pool Info A new `gt_verified` boolean field is now available in the response payload for: * [/onchain/networks/\{network}/tokens/\{address}/info](/reference/token-info-contract-address) * [/onchain/networks/\{network}/pools/\{pool\_address}/info](/reference/pool-token-info-contract-address) Learn more about [GT Verified](https://support.coingecko.com/hc/en-us/articles/54413671274649-What-is-GT-Verified-Badge). ```json Example Payload {4} theme={null} { ... "gt_score": 92.6605504587156, "gt_verified": true, "discord_url": null, ... } ``` ### New `outstanding_token_value_usd` & `outstanding_supply` Fields Two new fields are now included in `market_data` for the following endpoints: * [/coins/\{id}](/reference/coins-id) * [/coins/\{id}/contract/\{contract\_address}](/reference/coins-contract-address) **New fields:** * `market_data.outstanding_token_value_usd` β€” Outstanding token value in USD (nullable) * `market_data.outstanding_supply` β€” The amount of tokens outstanding in the market, including tokens that are circulated/tradable or planned for circulation. Excludes token supplies not planned for circulation or usage. Used to better understand the current theoretical maximum valuation of a token. (nullable) ```json Example Payload {3, 7} expandable theme={null} "market_data": { "market_cap_rank": 1, "outstanding_token_value_usd": null, ... "circulating_supply": 19675962, "total_supply": 21000000, "outstanding_supply": 20003043.0, ... } ``` ## Comprehensive Token Holder Analytics with PnL Details πŸ—“οΈ **February 25, 2026** Track the financial performance of top token holders with detailed profit and loss metrics in the [Top Token Holders by Token Address](/reference/top-token-holders-token-address) endpoint! **New optional parameter:** * **`include_pnl_details`** (boolean, default: `false`):
Include comprehensive PnL metrics and trading analytics for each token holder **New conditional fields returned when `include_pnl_details=true`:** * `average_buy_price_usd` β€” Average purchase price per token in USD * `total_buy_count` β€” Total number of buy transactions * `total_sell_count` β€” Total number of sell transactions * `unrealized_pnl_usd` β€” Unrealized profit/loss in USD based on current token price * `unrealized_pnl_percentage` β€” Unrealized profit/loss as a percentage of total entry value * `realized_pnl_usd` β€” Realized profit/loss in USD from completed sell transactions * `realized_pnl_percentage` β€” Realized profit/loss as a percentage of total sell value * `explorer_url` β€” Direct link to the holder's address on the blockchain explorer ```json Example Payload {15-22} expandable theme={null} { "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** Discover pools and analyze institutional crypto holdings with powerful new sorting options and comprehensive financial metrics! ### Introduced New Sort Options for Pool Megafilter Find the perfect pools for your trading strategy with four new sorting options in the [Megafilter for Pools](/reference/pools-megafilter) endpoint: * **`price_asc`** β€” Sort by token price (lowest to highest) * **`price_desc`** β€” Sort by token price (highest to lowest) * **`h24_tx_count_asc`** β€” Sort by 24-hour transaction count (lowest to highest) * **`h24_volume_usd_asc`** β€” Sort by 24-hour volume in USD (lowest to highest) Identify undervalued gems by sorting ascending on price, discover high-activity pools with transaction count sorting, or find emerging opportunities with low-volume pools that show potential. ### Enriched Treasury Holdings Data with Holdings Metrics and Historical Tracking Gain deeper insights into institutional crypto adoption with comprehensive financial data in the [Crypto Treasury Holdings by Entity ID](/reference/public-treasury-entity) endpoint: **New default fields returned for all requests:** * `total_treasury_value_usd` β€” Total current holdings value * `unrealized_pnl` β€” Profit/loss vs entry cost * `m_nav` β€” Market to net asset value ratio * `total_asset_value_per_share_usd` β€” Per-share asset value * Per-holding metrics: * `amount_per_share`, `entity_value_usd_percentage`, `current_value_usd`, `total_entry_value_usd`, `average_entry_value_usd`, `unrealized_pnl` ```json Example Payload {9-12, 18-23} expandable theme={null} { "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 analysis:** * **`holding_amount_change`** β€” Track absolute holding changes over time * **`holding_change_percentage`** β€” Track percentage changes in holdings * **Supported timeframes:** `7d`, `14d`, `30d`, `90d`, `1y`, `ytd` (comma-separated for multiple) ```json Example Payload {14-29} expandable theme={null} ... "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 } } ] } ``` ## \[Upcoming Change] Starknet Address Format Update πŸ—“οΈ **January 30, 2026** **Effective Date**: 10 February 2026, 02:00 UTC To ensure consistent data matching, we are updating the Starknet address format across the CoinGecko API. **Summary of Changes**: Starting 10 February at 02:00 UTC, Starknet addresses (tokens and pools) will be standardized to the Padded Format (66 characters). **Scope of Change:** This update **only** affects: * **Onchain API endpoints** (e.g., `/onchain/networks/starknet-alpha/pools..`) * **Onchain WebSocket channels** (broadcasted messages) | Feature | Change Description | | ---------------- | ---------------------------------------------------------------- | | API Responses | All address fields will return in **padded format** (`0x0...`). | | API Requests | We will continue to accept **both** padded and unpadded formats. | | WebSockets | All broadcasted messages will use the **padded format**. | | WS Subscriptions | Both padded and unpadded formats will be accepted for sub/unsub. | ### Technical Details: Padded vs. Unpadded The primary difference is the addition of a leading zero following the `0x` prefix to reach a consistent 66-character length. * **Old Format (Unpadded):** `0x4718...` (65 characters) * **New Format (Padded):** `0x04718...` (66 characters) ### What this means for you * **No Breaking Request Changes:** Your existing API calls using unpadded addresses will continue to work; our system will normalize these inputs automatically. * **String Matching:** If your application performs strict string comparisons (e.g., `if (api_address === local_db_address)`), you should update your logic to handle padded formats or normalize addresses to a consistent length before comparing. * **Data Storage:** If you store Starknet addresses from our API, be aware that future records will include the padding. > **Note:** This change is specific to the **Starknet** network. Address formats for other chains (Ethereum, BSC, Solana, etc.) remain unaffected. ## Streamlined Notification Management with Multi-Recipient Email Alerts πŸ—“οΈ **January 27, 2026** Ensure critical billing and usage alerts reach the right teams with our new email recipient management system! Introducing the ability to add multiple email recipients for your API notifications directly from your dashboard. Account owners can now configure billing alerts and usage threshold notifications to reach multiple stakeholders without manual forwarding. Add recipients who don't need CoinGecko accounts, customize notification preferences per recipient, and manage your distribution list anytime β€” all from the new Notifications ([developers/dashboard#notifications](https://www.coingecko.com/en/developers/dashboard#notifications)) tab. **Available on:** Analyst plans and above, with expanded recipient limits for Enterprise plans. [Learn more about our API offerings](https://www.coingecko.com/en/api/pricing). Perfect for larger teams where finance, operations, and engineering need independent access to critical alerts, eliminating single points of failure and enabling faster incident response when usage spikes or payments require attention. **Learn more:** [How to Manage API Email Recipients](https://support.coingecko.com/hc/en-us/articles/54516497903129-How-to-Manage-API-Email-Recipients) ## Enhanced Team Collaboration with Role-Based Dashboard Access πŸ—“οΈ **January 26, 2026** Securely share your API dashboard with team members using our new role-based access control system! Introducing Team Invites & Shared Access β€” invite team members to collaborate on your API subscription without sharing login credentials (see [developers/dashboard#access](https://www.coingecko.com/en/developers/dashboard#access) tab). Account owners can now add "Collaborator" users who can: * Manage API keys * Monitor credit usage across API and WebSocket channels * Access billing details from the Stripe portal. The new dashboard switcher lets users seamlessly toggle between multiple team views when they're members of different organizations. **Available on:** All plans, with increased seat limits for higher-tier subscriptions. [Learn more about our API offerings](https://www.coingecko.com/en/api/pricing). Designed for larger teams, this feature enables secure credential management, faster incident response (any collaborator can rotate compromised keys immediately), and independent access for finance teams to retrieve invoices β€” eliminating operational bottlenecks and security risks from shared login credentials. **Learn more:** * [How to Manage Team Access on Your API Dashboard](https://support.coingecko.com/hc/en-us/articles/54503844273945-How-to-Manage-Team-Access-on-Your-API-Dashboard) * [Team Access for API Plans FAQ](https://support.coingecko.com/hc/en-us/articles/54503941840025-Team-Access-for-API-Plans-FAQ) ## Advanced Filtering with Pagination for Treasury Data and Price Change Filters for Megafilter πŸ—“οΈ **January 22, 2026** Empower your data analysis with enhanced filtering and pagination capabilities across key endpoints! ### Introduced Pagination and Sorting to Public Treasury Endpoint Take control of large treasury datasets with new pagination and sorting parameters in the [Crypto Treasury Holdings by Coin ID](/reference/companies-public-treasury) endpoint: * **`per_page`**: Control results per page (1-250, default: 250) * **`page`**: Navigate through paginated results (default: 1) * **`order`**: Sort by total holdings in USD * `total_holdings_usd_desc` (default) β€” Highest holdings first * `total_holdings_usd_asc` β€” Lowest holdings first Efficiently analyze public companies and governments holding cryptocurrencies by breaking down large datasets into manageable pages and sorting by holdings to identify major institutional players or discover emerging adopters. ### Introduced Price Change Filters to Pool Megafilter Discover trending pools with precision using new price change percentage filters in the [Megafilter for Pools](/reference/pools-megafilter) endpoint: * **`price_change_percentage_min`**: Minimum price change percentage threshold * **`price_change_percentage_max`**: Maximum price change percentage threshold * **`price_change_percentage_duration`**: Time window for price change * Available durations: `5m`, `1h`, `6h`, `24h` Filter pools by price performance over your preferred timeframe to identify explosive short-term movers (5-minute surges), hourly momentum plays, or sustained 24-hour trends β€” perfect for building custom screeners and automated trading strategies. ## Enhanced Market Analytics with Volume Change Tracking and Historical OHLC for Inactive Coins πŸ—“οΈ **January 21, 2026** Gain deeper market insights with new volume metrics and expanded historical data access! ### Introduced Volume Change Percentage to Global Market Data Track global market momentum with the new `volume_change_percentage_24h_usd` field in the [Crypto Global Market Data](/reference/crypto-global) endpoint: ```json JSON {3} theme={null} { "market_cap_change_percentage_24h_usd": 0.7227196786856437, "volume_change_percentage_24h_usd": -0.2692391926571914, "updated_at": 1769062741 } ``` Monitor how global trading volume shifts over 24 hours to identify market sentiment changes, spot emerging trends, and make more informed trading decisions alongside market cap changes. ### Expanded Historical OHLC Data Access for Inactive Coins Access historical candlestick data for inactive and delisted coins to complete your historical analysis: * [Coin OHLC by ID](/reference/coins-id-ohlc) β€” `/coins/{id}/ohlc` * [Coin OHLC Range by ID](/reference/coins-id-ohlc-range) β€” `/coins/{id}/ohlc/range` Retrieve complete historical OHLC (Open, High, Low, Close) data even for coins that are no longer actively traded, enabling comprehensive backtesting, historical research, and portfolio performance analysis across your entire trading history. ## Expanded WebSocket Streaming with New Intervals and Quote Token Data πŸ—“οΈ **January 20, 2026** We've supercharged our WebSocket API with powerful new capabilities to help you build more sophisticated trading and analytics applications! ### Introduced 15-Minute, 12-Hour, and Daily Intervals for OnchainOHLCV Unlock more flexible timeframe analysis with three new interval options for the [OnchainOHLCV](/websocket/wssonchainohlcv) WebSocket channel: * **New intervals added:** `15m`, `12h`, `1d` * **Complete interval options:** `1s`, `1m`, `5m`, `15m`, `1h`, `2h`, `4h`, `8h`, `12h`, `1d` Stream candlestick data at granular 15-minute intervals for short-term trading strategies, or capture broader market trends with 12-hour and daily candles perfectly suited for swing trading and long-term analysis. ### Introduced Quote Token Amount Field to OnchainTrade for Complete Swap Visibility Get complete transparency into both sides of every trade with the new `toq` field in [OnchainTrade](/websocket/wss-onchain-trade) updates: * **Field:** `toq` (quote\_token\_amount) * **Type:** float * **Description:** Amount of quote token transacted ```json JSON {7} theme={null} { "c": "G2", "n": "bsc", "pa": "0x172fcd41e0913e95784454622d1c3724f546f849", "ty": "b", "to": 11.0818733869477, "toq": 0.0124384489204242, "vo": 11.0724584599832, "tx": "0xbc6afc1584fcbef90efe69b96602ef3ba4778727bacfdfece46bbbb075721bb4" } ``` Track the exact quote token amount alongside the base token amount (`to`) to calculate precise exchange rates, monitor liquidity depth, and build accurate portfolio tracking systems. ## Breaking Change: Ticker Trust Score Deprecation πŸ—“οΈ **January 19, 2026** ⚠️ **Takes effect: 3rd March 2026** We are deprecating the `trust_score` field that previously returned `green`, `yellow`, or `red` values for ticker data. The field will now return `null` across all affected endpoints. **Change Details:** The `trust_score` field will no longer provide color-coded trust ratings: ```json JSON {4} theme={null} ... "usd": 1406996874 }, "trust_score": null, "bid_ask_spread_percentage": 0.010014, "timestamp": "2024-04-08T04:02:01+00:00", ... ``` **Affected Endpoints:** 1. [Coin Tickers by ID](/reference/coins-id-tickers) β€” `/coins/{id}/tickers` 2. [Exchange Tickers by ID](/reference/exchanges-id-tickers) β€” `/exchanges/{id}/tickers` 3. [Exchange Data by ID](/reference/exchanges-id) β€” `/exchanges/{id}` 4. [Coin Data by ID](/reference/coins-id) β€” `/coins/{id}` 5. [Coin Data by Token Address](/reference/coins-contract-address) β€” `/coins/{id}/contract/{contract_address}` **Action Required:** If your application relies on the `trust_score` field for ticker data, please update your code to handle `null` values or remove this dependency. ## Access Inactive Token Data with New `include_inactive_source` Parameter πŸ—“οΈ **December 16, 2025** We've introduced a new `include_inactive_source` query parameter across multiple onchain endpoints, enabling you to retrieve data for tokens even when they have no active pools (no valid swaps in the past 7 days). When `include_inactive_source=true`, the API will source data from the pool with the most recent swap, regardless of how long ago it occurred. This ensures you can still access pricing and volume data for less active and dormant tokens. **Updated endpoints:** * [Token Data by Token Address](/reference/token-data-contract-address) β€” `/onchain/networks/../tokens/..` * [Tokens Data by Token Addresses](/reference/tokens-data-contract-addresses) β€” `/onchain/networks/../tokens/multi/..` ```json JSON {6} theme={null} ... "volume_usd": { "h24": "40075650.4943209" }, "market_cap_usd": "1544052409.96629", "last_trade_timestamp": 1712534400 }, "relationships": { ... ``` * [Top Pools by Token Address](/reference/top-pools-contract-address) β€” `/onchain/networks/../tokens/../pools` ```json JSON {5} theme={null} ... "h24": "536545444.904535" }, "reserve_in_usd": "163988541.3812", "last_trade_timestamp": 1712534400 }, "relationships": { ... ``` * [Token Price by Token Addresses](/reference/onchain-simple-price) β€” `/onchain/simple/networks/../token_price/..` ```json JSON {6,7,8} theme={null} ... }, "total_reserve_in_usd": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1576179559.94669772339136684208" }, "last_trade_timestamp": { "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": 1712534400 } } ... ``` * [Token OHLCV chart by Token Address](/reference/token-ohlcv-token-address) β€” `/onchain/networks/../tokens/../ohlcv/..` (no changes in payload) ## Upcoming Changes to Market Cap Rankings and API for Rehypothecated Tokens πŸ—“οΈ **December 15, 2025** At CoinGecko, we are committed to providing the most accurate and independent cryptocurrency data in the industry. As the DeFi landscape evolves, so too must our methodologies for tracking and ranking assets. Today, we are announcing an important update regarding how we categorize and rank **rehypothecated tokens** such as wrapped assets and liquid staking tokens to ensure our market capitalization data remains a true reflection of the market's value. Read [here](https://www.coingecko.com/learn/upcoming-changes-to-market-cap-rankings-and-api-for-rehypothecated-tokens) for full details. #### **Important: CoinGecko API Breaking Changes** **Effective Date:** These changes are scheduled to go live on **February 4th, 2026.** **Note:** If your application does not specifically handle rehypothecated tokens, this breaking change is unlikely to affect you, and no action is required. If you are a developer or use our API for data fetching, please pay close attention to the following breaking changes: **1. Endpoints:** [Coin Data by ID](/reference/coins-id) β€” `/coins/{id}` and [Coin Data by Token Address](/reference/coins-contract-address) β€” `/coins/{id}/contract/{contract_address}` * **Breaking change:** The `market_cap_rank` field will return `null` for rehypothecated tokens * **New field added:** `market_cap_rank_with_rehypothecated` * Available in both the parent object and the `market_data` object * Shows ranking that includes rehypothecated tokens in the calculation * **Action:** Use the new `market_cap_rank_with_rehypothecated` field to maintain ranking visibility for all tokens ```json JSON {3,7} theme={null} { "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": { ... } } } ``` **2. Endpoint:** [Coins List with Market Data](/reference/coins-markets) β€” `/coins/markets` * **Breaking change:** Rehypothecated tokens will be **excluded** from the response list by default * **Special behavior:** When a `category` parameter is in use, all coins (including rehypothecated tokens) will be returned, but the `market_cap_rank` field will be `null` for rehypothecated tokens * **New parameter added:** `include_rehypothecated` (boolean, default: `false`) * **New field (conditional):** `market_cap_rank_with_rehypothecated` * Only appears in response when `include_rehypothecated=true` * Shows ranking that includes rehypothecated tokens * **Action:** Set `include_rehypothecated=true` to include rehypothecated tokens in results ```json JSON {4} theme={null} { "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, 2025** Discover the top traders for any token with the new [Top Traders by Token Address](/reference/top-token-traders-token-address) endpoint. This endpoint enables you to monitor whale activity, track significant holders, and analyze trading patterns: **Example payload:** ```json JSON theme={null} { "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" } ] } } } ``` ## New Public Treasury Endpoints: Historical Holdings and Transactions History πŸ—“οΈ **November 27, 2025** * Both endpoints support easy ID lookup via respective entity/coin IDs. * View live data examples on [https://www.coingecko.com/en/treasuries/companies/strategy](https://www.coingecko.com/en/treasuries/companies/strategy). ### Track Public Treasury Holdings Over Time with Historical Holdings Endpoint Query historical holdings data for public companies and governments with the new [Crypto Treasury Holdings Historical Chart Data by ID](/reference/public-treasury-entity-chart) endpoint. **Example payload:** ```json JSON theme={null} { "holdings": [ [ 1763683200000, 649870.0 ], ... ], "holding_value_in_usd": [ [ 1763683200000, 56311217680.033195 ], ... ] } ``` ### Access Transaction History with New Treasury Endpoint Retrieve detailed transaction history for public companies and governments using the new [Crypto Treasury Transaction History by Entity ID](/reference/public-treasury-transaction-history) endpoint. **Example payload:** ```json JSON theme={null} { "transactions": [ { "date": 1763337600000, "source_url": "https://assets.contentstack.io/v3/assets/bltf8d808d9b8cebd37/blt27517abcb8f459e3/691aaadfcd08266e2ec6fbe9/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 } ] } ``` ## GT Community Data for More Pool Endpoints, plus Farcaster and Zora Social URL Support πŸ—“οΈ **November 15, 2025** ### GT Community Data Now Available across More Pools Endpoints We've expanded GeckoTerminal community data support across multiple pool endpoints. When you set `include_gt_community_data=true`, you'll now receive sentiment voting and community reporting data in your API responses. **New fields surfaced:** ```json JSON {4,5,6} theme={null} ... }, "reserve_in_usd": "163988541.3812", "sentiment_vote_positive_percentage": 60, "sentiment_vote_negative_percentage": 40, "community_sus_report": 18 }, "relationships": { ... ``` **Improved endpoints:** * [Trending Pools List](/reference/trending-pools-list) β€” `/onchain/networks/trending_pools` * [New Pools by Network](/reference/latest-pools-network) β€” `/onchain/networks/{network}/new_pools` * [Trending Pools by Network](/reference/trending-pools-network) β€” `/onchain/networks/{network}/trending_pools` * [Top Pools by Network](/reference/top-pools-network) β€” `/onchain/networks/{network}/pools` * [Top Pools by DEX](/reference/top-pools-dex) β€” `/onchain/networks/{network}/dexes/{dex}/pools` * [New Pools List](/reference/latest-pools-list) β€” `/onchain/new_pools` ### Farcaster and Zora Social URLs Support for Token Info Endpoints Farcaster and Zora social URLs are now supported in our token info endpoints. These fields are now surfaced by default alongside existing social links: ```json JSON {3,4} theme={null} ... "discord_url": null, "farcaster_url": null, "zora_url": null, "telegram_handle": null, ... ``` **Supported endpoints:** * [Token Info by Token Address](/reference/token-info-contract-address) β€” `/onchain/networks/{network}/tokens/{address}/info` * [Pool Tokens Info by Pool Address](/reference/pool-token-info-contract-address) β€” `/onchain/networks/{network}/pools/{pool_address}/info` ## True Real-Time Data Update: Cache Removed for Key On-chain Endpoints πŸ—“οΈ **November 14, 2025** \[Changes below are applicable to all [paid plan subscribers](https://www.coingecko.com/en/api/pricing).] Dear CoinGecko API paid plan subscribers, We're excited to announce a major upgrade to our API, aimed at providing you with direct, instantaneous access to the best real-time data! Starting **02:00 UTC, December 1, 2025**, the 10-second edge cache will be completely removed for the following endpoints. This change means your requests will now pull the freshest data directly from our servers with no cache delay. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :----------------------------------------------------------------------------------------------------------- | :------------------------------------- | :----------------------- | :------------------- | | [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) | Monday, 02:00 UTC, December 1, 2025 | 10s | Real-time (No Cache) | | [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address) | Tuesday, 02:00 UTC, December 2, 2025 | 10s | Real-time (No Cache) | | [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Wednesday, 02:00 UTC, December 3, 2025 | 10s | Real-time (No Cache) | **What This Means for You:** * **True Real-Time Data:** You will now receive the absolute freshest, most up-to-date data with every single request. There is no longer any cache layer to cause a delay. **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 10 seconds or more to align with the new cache changes. We're committed to continuously improving your experience and providing the highest quality data. If you have any questions or need assistance, feel free to reach out to soonaik\@coingecko\[dot]com. **CoinGecko API Team** ## Onchain OHLCV Support Extended to Pools with 3+ Tokens πŸ—“οΈ **November 8, 2025** We've expanded our onchain OHLCV endpoints to support pools containing more than 2 tokens. Now you can access liquidity pools with additional token compositions beyond a simple pair, such as [crvUSD/WETH/CRV](https://www.geckoterminal.com/eth/pools/0x4ebdf703948ddcea3b11f675b4d1fba9d2414a14). **Improved endpoints:** * [Pool OHLCV chart by Pool Address](/reference/pool-ohlcv-contract-address) β€” `/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}` * [Token OHLCV chart by Token Address](/reference/token-ohlcv-token-address) β€” `/onchain/networks/{network}/tokens/{token_address}/ohlcv/{timeframe}` ## WebSocket is now supported for Self-serve API subscribers πŸ—“οΈ **October 23, 2025** ### CoinGecko WebSocket (Beta) is now available for [paid plan](https://www.coingecko.com/en/api/pricing) customers (Analyst plan & above)! For Analyst, Lite, Pro, and Pro+ self-serve customers, you are now eligible to access the following WebSocket features, and stream real-time data by utilizing your monthly API plan credits: * Max connections: 10 concurrent socket connections * Max subscriptions: 100 token or pool data subscriptions per channel, per socket * Channel Access: [all 4 channels](https://docs.coingecko.com/websocket#channel-%26-data-support) * Credit charge: **0.1** credit per response returned, deducting from monthly API plan credits Please visit [WebSocket](https://docs.coingecko.com/websocket) for full details, and test out WebSocket data streaming. We will gradually improve the WebSocket and expand the feature limits. Please share your feedback and suggestions via this [**survey form**](https://forms.gle/gNE1Txc9FCV55s7ZA), or email soonaik\@coingecko\[dot]com. ### Notice: Temporary Disruption on MagicEden data for NFT Endpoints Due to recent updates to MagicEden's API, we are updating our integration. During this period, endpoints for NFT data may be temporarily unavailable or return incomplete information. ## More Bonding Curve Support and New Ascending Sort for Megafilter πŸ—“οΈ **October 4, 2025** ### Now Supporting Bonding Curve (non-graduated) Data for More Endpoints We've added support for bonding curve (e.g. launchpad graduation from PumpFun) data across multiple token endpoints: * [Token Data by Token Address](/reference/token-data-contract-address) β€” `/onchain/networks/{network}/tokens/{address}` * [Tokens Data by Token Addresses](/reference/tokens-data-contract-addresses) β€” `/onchain/networks/{network}/tokens/multi/{addresses}` * [Token Info by Token Address](/reference/token-info-contract-address) β€” `/onchain/networks/{network}/tokens/{address}/info` * [Pool Tokens Info by Pool Address](/reference/pool-token-info-contract-address) β€” `/onchain/networks/{network}/pools/{pool_address}/info` ```json JSON theme={null} "launchpad_details": { "graduation_percentage": 2.16, "completed": false, "completed_at": null, "migrated_destination_pool_address": null } ``` ### Megafilter: Ascending Sort Order for Price Change % The [Megafilter for Pools](/reference/pools-megafilter) endpoint now supports ascending sorting for price change percentage: * `m5_price_change_percentage_asc` * `h1_price_change_percentage_asc` * `h6_price_change_percentage_asc` * `h24_price_change_percentage_asc` ### Token OHLCV Endpoint Fix to respect Specified Token Address We've fixed an issue where the [Token OHLCV chart by Token Address](/reference/token-ohlcv-token-address) endpoint returned data for the base token of the top pool instead of the requested token. It will now always return data for the specified token address. ## SDK Gains Public Treasury Coverage, MCP Adds Exchanges, NFTs, and ISO Support πŸ—“οΈ **September 25, 2025** ### Expanded SDK Coverage for Public Treasuries We're broadening our SDK coverage to make treasury-level insights more powerful and easier to access. Check out what's new below (with functions from [our TypeScript SDK](https://github.com/coingecko/coingecko-typescript)). * [`publicTreasury.getCoinID(coinID, { ...params })`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury) \ to query public companies & governments' cryptocurrency holdings by Coin ID * [`publicTreasury.getEntityID(entityID)`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#publictreasury) \ to query public companies & governments' cryptocurrency holdings by Entity ID * [`entities.getList({ ...params })`](https://github.com/coingecko/coingecko-typescript/blob/main/api.md#entities) \ to query all the supported entities on CoinGecko with entities ID, name, symbol, and country ### New MCP Tools: Exchanges, NFTs & Multi-Address Queries We're also surfacing new tools through the MCP to give developers a richer, faster way to query exchanges, NFTs, and onchain activity. * New tools: * Exchange coverage with [/exchanges/list](/reference/exchanges-list), [/exchanges/\{id}](/reference/exchanges-id), [/exchanges/\{id}/tickers](/reference/exchanges-id-tickers), and [/exchanges/\{id}/volume\_chart/range](/reference/exchanges-id-volume-chart-range) * NFT markets with [/nfts/markets](/reference/nfts-markets) * Multi-address queries with [/onchain/networks/\{network}/pools/multi/\{addresses}](/reference/pools-addresses) and [/onchain/networks/\{network}/tokens/multi/\{addresses}](/reference/tokens-data-contract-addresses) * Retired tools: * We've removed endpoints such as [/coins/list](/reference/coins-list), [/onchain/networks/trending\_pools](/reference/trending-pools-network), and single-address pool/token queries in favor of more scalable multi-address endpoints ### Friendlier Time-related MCP Queries with ISO Support Time-based queries just got easier. MCP tools now accept **ISO date strings** (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) alongside UNIX timestamps. For example, when using the [Coin Historical Chart Data within Time Range](/reference/coins-id-market-chart-range) tool, you can now pass ISO date strings directly instead of converting them into UNIX timestamps for your LLM tools. **CoinGecko API Team** ## New Crypto Treasury Endpoints and Improvements πŸ—“οΈ **September 19, 2025** 1. [Crypto Treasury Holdings by Coin ID](https://docs.coingecko.com/reference/companies-public-treasury) endpoint now supports governments and more coins data as seen on [https://www.coingecko.com/en/treasuries/bitcoin](https://www.coingecko.com/en/treasuries/bitcoin) 2. **New endpoints:** 1. [Crypto Treasury Holdings by Entity ID](https://docs.coingecko.com/reference/public-treasury-entity) 2. [Entities List (ID Map)](https://docs.coingecko.com/reference/entities-list) 3. [Derivatives Exchange Data by ID](https://docs.coingecko.com/reference/derivatives-exchanges-id) endpoint now supports `coin_id` and `target_coin_id` to identify coins of ticker pairs. ```json JSON theme={null} "tickers": [ { "symbol": "ASTERUSDT", "base": "ASTER", "target": "USDT", "coin_id": "aster-2", πŸ‘ˆ NEW "target_coin_id": "tether" πŸ‘ˆ NEW } ] ``` ## Multiple Improvements: Bonding Curve Data, Pooled Token Balance, and More πŸ—“οΈ **September 12, 2025** ### πŸš€ Now Supporting Bonding Curve Data Bonding curve data (launchpad graduation) is now supported for the following endpoints: * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) **Payload example:** ```json theme={null} "launchpad_details": { "graduation_percentage": 100, "completed": true, "completed_at": "2024-04-08T16:52:35Z", "migrated_destination_pool_address": "5wNu5QhdpRGrL37ffcd6TMMqZugQgxwafgz477rShtHy" } ``` More endpoints to support bonding curve data soon. ### πŸš€ Now Supporting Pooled Token Balance Data The following endpoints now support additional pool token balance data by flagging this parameter `include_composition=true`: * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) * [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) (requires `include=top_pools` parameter to be flagged together) * [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) (requires `include=top_pools` parameter to be flagged together) **Payload example:** ```json theme={null} "base_token_balance": "11700.98", "base_token_liquidity_usd": "29630000", "quote_token_balance": "66384614.21", "quote_token_liquidity_usd": "66330000", ``` ### πŸš€ Other improvements 1. [Onchain Megafilter](https://docs.coingecko.com/reference/pools-megafilter) endpoint now supports more `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` 2. [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) endpoint now supports additional price change percentage data by flagging `price_change_percentage` parameter. The available options are: `1h,24h,7d,14d,30d,60d,200d,1y`. * Payload example: ```json theme={null} "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 ``` 3. [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers) endpoint now supports sorting tickers based on market cap, by flagging the `order` parameter. * Available options: `market_cap_desc`, `market_cap_asc` ## Improved Update Frequency for selected Pro-API On-chain Endpoints πŸ—“οΈ **August 18, 2025** \[Changes below are applicable to all [paid plan subscribers](https://www.coingecko.com/en/api/pricing).] Dear CoinGecko API paid plan subscribers, We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, September 2, 2025**, the edge cache duration for the following endpoints will be reduced from **30s** to **10s**, allowing you to retrieve updated data more frequently. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :----------------------------------------------------------------------------------------------------------- | :-------------------------------------- | :----------------------- | :------------------- | | [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | Tuesday, 02:00 UTC, September 2, 2025 | 30s | 10s | | [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s | | [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) | Wednesday, 02:00 UTC, September 3, 2025 | 30s | 10s | | [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | | [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address#/) | Thursday, 02:00 UTC, September 4, 2025 | 30s | 10s | **What This Means for You:** * **Fresher Data, Quicker**: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! * **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 10 seconds for endpoints above), there will be no additional credits chargedβ€”just like before. **Things to Keep in Mind:** * If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. * To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [soonaik@coingecko.com](mailto:soonaik@coingecko.com). **CoinGecko API Team** ## Now Supported: Launchpad Data (Pump.fun & More), Granular OHLCV, and Honeypot Info πŸ—“οΈ **August 05, 2025** We're excited to announce a major update to our on-chain API endpoints! This release introduces support for popular token launchpads, adds high-frequency OHLCV data, and enhances our honeypot detection capabilities to give you deeper and more timely on-chain insights. ### πŸš€ Now Supporting Launchpad Data (Pump.fun & More!) In addition to the 1,600+ DEXes already integrated with GeckoTerminal.com, you can now track token data from popular launchpad platforms directly through the CoinGecko API. More launchpads will be supported soon! **New Supported Launchpads:** | Launchpad | network id (API) | dex id (API) | | :---------------------------------------------------------------------------------------------- | :--------------- | :---------------- | | [Meteora DBC](https://www.geckoterminal.com/solana/meteora-dbc/pools) | solana | meteora-dbc | | [Pump.fun](https://www.geckoterminal.com/solana/pump-fun/pools) | solana | pump-fun | | [Raydium Launchpad](https://www.geckoterminal.com/solana/raydium-launchlab/pools) (LetsBonkFun) | solana | raydium-launchlab | | [Boop.fun](https://www.geckoterminal.com/solana/boop-fun/pools) | solana | boop-fun | | [Virtuals (Base)](https://www.geckoterminal.com/base/virtuals-base/pools) | base | virtuals-base | **Improved endpoints to track launchpad data:** * [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) * [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) More launchpad-specific data will be supported soon for the endpoints above! **Tips:** use [megafilter endpoint](https://docs.coingecko.com/reference/pools-megafilter) to retrieve latest launchpad data, by flagging `sort=pool_created_at_desc` **Request example** (Get latest pools on Pump.fun): ```curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&networks=solana&dexes=pump-fun&sort=pool_created_at_desc&x_cg_pro_api_key=YOUR_KEY ``` ### \[Pro-API Exclusive] More Granular OHLCV Data On-chain OHLCV endpoints now support higher frequency intervals, down to 1-second granularity. | Timeframe | Aggregate (Before) | Aggregate (New) | | :-------- | :----------------- | :-------------- | | day | 1 | 1 | | hour | 1, 4, 12 | 1, 4, 12 | | minute | 1, 5, 15 | 1, 5, 15 | | second | n/a | 1, 15, 30 | **Improved Endpoints:** * [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) * [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address) **New interval supported:** * 1s * 15s * 30s **Example Request (Get the last 100 1-second intervals for a pool on Ethereum):** ```curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/networks/eth/pools/0x06da0fd433c1a5d7a4faa01111c044910a184553/ohlcv/second?aggregate=1&limit=100&include_empty_intervals=false&x_cg_pro_api_key=YOUR_KEY ``` ### 🍯 Enhanced Honeypot Information We've expanded our honeypot detection features to provide more comprehensive risk assessment. You can now check if a token is a potential honeypot using the main info endpoints. **Improved Endpoints:** * [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) * [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) **Example Payload:** ```json theme={null} { "mint_authority": null, "freeze_authority": null, "is_honeypot": true // possible values: true / false / unknown } ``` ### \[Pro-API Exclusive] New Filtering Option in Megafilter Previously, the [Pools Megafilter](https://docs.coingecko.com/reference/pools-megafilter) endpoint could only show tokens confirmed as ***not*** a honeypot (`checks=no_honeypot`). Now, you can also include tokens where the honeypot status is 'unknown'. * To use this, set `include_unknown_honeypot_tokens=true`. * Important: This parameter only takes effect when `checks=no_honeypot` is also specified in the request. **Example Request (Get trending pools that are not confirmed honeypots, including those with an unknown status):** ```curl theme={null} https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter?page=1&sort=h6_trending&checks=no_honeypot&include_unknown_honeypot_tokens=true&x_cg_pro_api_key=YOUR_KEY ``` ### πŸ“ˆ Expanded Pool Data **Endpoint**: [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) By adding `include=pool` to your request on the pool tokens endpoint, you can now retrieve additional context about the pool itself. * Base and quote token address * Sentiment vote percentage (positive and negative) * Community suspicious reports count **Payload Example**: ```json theme={null} "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 πŸ—“οΈ **June 19, 2025** We're excited to announce that you can now obtain real-time and historical price & market data for tokens listed on CoinGecko.com, with the option to return data value in **SOL** (Solana) currency. Note: for dates prior to May 2025, 'SOL' historical data is limited to hourly and daily granularity. **Improved endpoints:** * [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price) * [Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price) * [Supported Currencies List](https://docs.coingecko.com/reference/simple-supported-currencies) * [Top Gainers & Losers](https://docs.coingecko.com/reference/coins-top-gainers-losers) * [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets) * [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) * [Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history) * [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart) * [Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range) * [Coin OHLC Chart by ID](https://docs.coingecko.com/reference/coins-id-ohlc) * [Coin OHLC Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-ohlc-range) * [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address) * [Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart) * [Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range) * [Trending Search List](https://docs.coingecko.com/reference/trending-search) * [Crypto Global Market Data](https://docs.coingecko.com/reference/crypto-global) **Example**: price of Bitcoin in Solana, using [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price) endpoint. ```json theme={null} { "bitcoin": { "sol": 720.21 } } ``` **Example:** historical daily price, market cap and volume of Trump in Solana, using [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart) endpoint. ```json theme={null} { "prices": [ [ 1750118400000, 0.0640701365814472 ], [ 1750204800000, 0.0644263929356261 ], [ 1750291200000, 0.0639713357587322 ], [ 1750326151000, 0.06415963364804504 ] ], "market_caps": [ [ 1750118400000, 12843589.584485611 ], [ 1750204800000, 12882547.839086628 ], [ 1750291200000, 12793790.726102708 ], [ 1750326151000, 12826247.390733324 ] ], "total_volumes": [ [ 1750118400000, 2425793.780846796 ], [ 1750204800000, 2055697.9106767387 ], [ 1750291200000, 1871087.4334618242 ], [ 1750326151000, 2008278.189223005 ] ] } ``` ## New Endpoints & Improvements: Historical Token Holders Chart, OHLCV by Token Address, Multi-pool Token Data Support πŸ—“οΈ **June 09, 2025** ### \[Pro-API Exclusive] New Endpoint - Historical Token Holders Chart by Token Address This new endpoint allows you to get the historical token holders chart based on the provided token contract address on a network. * Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin. Check it out now: [Historical Token Holders Chart by Token Address](https://docs.coingecko.com/reference/token-holders-chart-token-address) ### \[Pro-API Exclusive] New Endpoint - Token OHLCV chart by Token Address This endpoint allows you to get the OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network. * This endpoint will return OHLCV data of the most liquid pool of the specified token. You may use the [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address) endpoint to check the top pools of a token. Check it out now: [Token OHLCV chart by Token Address](https://docs.coingecko.com/reference/token-ohlcv-token-address#/) ### Improved Endpoints - Support Multi-pool Token Data Previously, we only surfaced 1 quote token for pools with more than 2 tokens. With these new improvements, for pools that have 2 or more tokens: * Extra quote tokens being listed under a new key `relationships.quote_tokens` * If `include=quote_token` is flagged, the extra quote tokens will be also listed under `included` ```json theme={null} "relationships": { "base_token": { "data": { "id": "eth_0x40d16fc0246ad3160ccc09b8d0d3a2cd28ae6c2f", "type": "token" } }, "quote_token": { "data": { "id": "eth_0x8353157092ed8be69a9df8f95af097bbf33cb2af", "type": "token" } }, "quote_tokens": { "data": [ { "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "type": "token" }, { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token" } ``` This improvement is applicable to all onchain pool endpoints that support `relationships.quote_token`, including but not limited to: * [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address#/) * [Search Pools](https://docs.coingecko.com/reference/search-pools#/) * [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter#/) * [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list#/) * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address#/) * [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network#/) * [New Pools List](https://docs.coingecko.com/reference/latest-pools-list#/) ## Upcoming Change Notice: Removal of normalized\_volume\_btc Data πŸ—“οΈ **May 30, 2025** **`Notice: Upcoming Change to CoinGecko API Endpoints - Removal of normalized_volume_btc Data`** **Effective Date: 16 June 2025** **Affected Endpoints:** * [Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id) * [Exchanges List with Data](https://docs.coingecko.com/reference/exchanges#/) **Details of the Change:** Please be advised that the `normalized_volume_btc` data point will be removed from the above-listed API endpoints, effective 16 June 2025. This change is being implemented due to significant recent changes to a 3rd party data source provider, which have fundamentally altered how this specific data can be accessed. Example of Affected Data Structure: ```json theme={null} { "trade_volume_24h_btc_normalized": 47765.5886637453 }, ``` After the effective date, the `trade_volume_24h_btc_normalized` field will no longer be present in the API responses for these endpoints. **Action Required:** If your applications or integrations currently rely on the `trade_volume_24h_btc_normalized` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 16 June 2025 to avoid potential errors or data discrepancies. ## New Endpoint & Improvements: On-Chain Trades, Net Buy Volume, and More πŸ—“οΈ **May 29, 2025** ### \[Pro-API Exclusive] New Endpoint - On-chain Trades by Token Address Previously, the [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-address) endpoint allows you to retrieve the last 300 trades of a specific pool only. With this new endpoint [Past 24 Hour Trades by Token Address](https://docs.coingecko.com/reference/token-trades-contract-address), you can now retrieve the last 300 trades **across different pools**, based on the provided **token contract address** on a network. ### Improved Endpoints - Support Net Buy Volume Data The following endpoints now support more volume breakdown data: * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses#/) By flagging `include_volume_breakdown=true`, you can surface the following data: * net\_buy\_volume\_usd * buy\_volume\_usd * sell\_volume\_usd Sample Response: ```json JSON theme={null} { "data": { "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "type": "pool", "attributes": { ... }, "net_buy_volume_usd": { "m5": "-40796.577553965", "m15": "-69765.771189161", "m30": "-88014.095440243", "h1": "0.000000000000", "h6": "1884879.921855301", "h24": "17555422.243003801" }, "buy_volume_usd": { "m5": "30597.433165473", "m15": "139531.542378324", "m30": "396063.429481099", "h1": "969922.728762430", "h6": "10366839.570204150", "h24": "52666266.729011402" }, "sell_volume_usd": { "m5": "71394.010719438", "m15": "209297.313567485", "m30": "484077.524921342", "h1": "969922.728762430", "h6": "8481959.648348849", "h24": "35110844.486007601" }, ``` ### Improved Endpoint - On-Chain OHLCV endpoint [Pool OHLCV chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) endpoint now supports including empty intervals by flagging `include_empty_intervals=true`. * By default, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded (or **skipped**) from the response. * This new parameter option provides the flexibility to get **padded** data, when there's no trade data. Sample Response: ```json theme={null} { "data": { "id": "81da0682-1c4f-445a-9bed-9b5454004df5", "type": "ohlcv_request_response", "attributes": { "ohlcv_list": [ [ 1744712700, 0.000212149802253853, 0.000212173305907688, 0.000212149802253853, 0.000212173305907688, 46.48164903882 ], [ 1744712400, 0.000212149802253853, πŸ‘ˆ O β€” Follow previous Close value 0.000212149802253853, πŸ‘ˆ H β€” Follow previous Close value 0.000212149802253853, πŸ‘ˆ L β€” Follow previous Close value 0.000212149802253853, πŸ‘ˆ C β€” Follow previous Close value 0.0 πŸ‘ˆ V β€” Set to zero ], [ 1744712100, 0.000210532522666822, 0.000212149802253853, 0.000210532522666822, 0.000212149802253853, πŸ‘ˆ Previous Close value 46.4765 ], ... } ``` ### Improved Endpoints - Support Large Images The following endpoints now support more size options for coin logo image: * [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) * [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) Sample Response: ```json theme={null} "data": { "id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7", "type": "token", "attributes": { ... "image_url": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", "image": { "thumb": "https://assets.coingecko.com/coins/images/325/thumb/Tether.png?1696501661", "small": "https://assets.coingecko.com/coins/images/325/small/Tether.png?1696501661", "large": "https://assets.coingecko.com/coins/images/325/large/Tether.png?1696501661" }, ``` ### Improved Endpoints - Support Normalized Supply Data The following endpoints now support `normalized_total_supply`: * [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) * [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) Sample Response: ```json theme={null} "decimals": 6, "total_supply": "49999156520373530.0", "normalized_total_supply": "49999156520.37353", ``` ### Improved Endpoints - Support Pool 'Name' and 'Fee' Data The following endpoints now support `pool_name` and `pool_fee`: * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) Sample Response: ```json theme={null} "name": "WETH / USDC 0.05%", "pool_name": "WETH / USDC", "pool_fee_percentage": "0.05", ``` ### Improved Endpoints - Support Symbols of DEX Pairs The following endpoints now allow you to flag `dex_pair_format=symbol` to return DEX pair symbols instead of contract addresses. * [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) * [Coin Tickers by ID](https://docs.coingecko.com/reference/coins-id-tickers) * [Exchange Tickers by ID](https://docs.coingecko.com/reference/exchanges-id-tickers) * [Exchange Data by ID](https://docs.coingecko.com/reference/exchanges-id) Sample Response: ```json theme={null} // 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 πŸ—“οΈ **April 25, 2025** ### \[Pro-API Exclusive] New Endpoint - On-chain Trending Search Data With this new endpoint [Trending Search Pools](https://docs.coingecko.com/reference/trending-search-pools), you can now retrieve the on-chain trending search pools and tokens data, as seen on GeckoTerminal.com. By default, this endpoint returns the top 4 trending pools data, you may specify the `pools` parameter to retrieve up to top 10 pools data. Tips: you may flag `include=base_token` to retrieve the trending tokens data. Note: this exclusive endpoint is available for our API [paid plan](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). ### \[Pro-API Exclusive] Improved Endpoint - Trending Search List [Paid plan](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above) can now use [Trending Search List](https://docs.coingecko.com/reference/trending-search) endpoint and flag `show_max` parameter to retrieve more trending coins, NFTs and coin categories on CoinGecko.com. | Trending Data | Public API (Demo plan) | Paid API (Analyst plan & above) | | :-------------- | :--------------------- | :------------------------------ | | Coins | 15 | 30 | | NFTs | 7 | 10 | | Coin Categories | 6 | 10 | ### Improved Endpoints - Support Token Lookup by Symbol and Name The following endpoints now support token lookup by symbol and name, in addition to the existing API ID support: * [Coin Price by IDs and Symbols](https://docs.coingecko.com/reference/simple-price) * [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets) Previously, these endpoints only supported token lookup by [API IDs](https://docs.coingecko.com/docs/1-get-data-by-id-or-address#/methods-to-query-price--market-data-of-coins). This enhancement streamlines token data retrieval and eliminates the need for manual coin ID mapping. Example Mapping: | API IDs | Symbol | Name | | :------- | :----- | :------ | | bitcoin | btc | Bitcoin | | tether | usdt | Tether | | usd-coin | usdc | USDC | Lookup Priority: When multiple lookup parameters are provided, the system applies the following priority order: id (highest) > name > symbol (lowest). **`Filtering by Symbol with include_tokens`** The `include_tokens` parameter has been added to provide flexibility when filtering by symbol: * `include_tokens=top` : Returns only the top market cap token for the specified symbol. * `include_tokens=all`: Returns all tokens that share the specified symbol. Example Request & Data: | Request Example | Token Data Returned | Remarks | | :-------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | pro-api.coingecko.com/api/v3/coins/markets?vs\_currency=usd\&symbols=btc\&include\_tokens=top | 1. Bitcoin | When symbols and 'include\_tokens=**top**' is specified, only the top market cap tokens will be returned. | | pro-api.coingecko.com/api/v3/coins/markets?vs\_currency=usd\&symbols=btc\&include\_tokens=all | 1. Bitcoin
2. Osmosis allBTC
3. atcat
4. Meld Bridged BTC (Meld)
5. BlackrockTradingCurrency | When symbols and 'include\_tokens=**all**' is specified, all the coins that share the same symbol will be returned.

All the 5 coins stated in the example have the same symbol 'btc'. | ### /coins/markets Endpoint Improvement We've enhanced the `/coins/markets` endpoint [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets), by including 'total' and 'per-page' values in the Response Headers. This addition to the Response Headers enables developers to identify the total number of active coins on coingecko.com and specify the required pagination to retrieve all available data. ```Text Response Header (Example) theme={null} per-page: 250 total: 16989 ``` ## Upcoming Change Notice: Removal of twitter\_followers Data πŸ—“οΈ **April 25, 2025** **`Notice: Upcoming Change to CoinGecko API Endpoints - Removal of twitter_followers Data`** **Effective Date: 15 May 2025** **Affected Endpoints:** * [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) * [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-address) * [Coin Historical Data by ID](https://docs.coingecko.com/reference/coins-id-history) **Details of the Change:** Please be advised that the `twitter_followers` data point within the `community_data` object will be removed from the above-listed API endpoints, effective 15 May 2025. This change is being implemented due to significant recent changes to the X (formerly Twitter) API, which have fundamentally altered how this specific data can be accessed. Example of Affected Data Structure: ```json theme={null} "community_data": { "twitter_followers": 7694251, // ... other community data points ... } ``` After the effective date, the `twitter_followers` field will no longer be present in the API responses for these endpoints. **Action Required:** If your applications or integrations currently rely on the `twitter_followers` data from these CoinGecko API endpoints, please make the necessary adjustments to your code before 15 May 2025 to avoid potential errors or data discrepancies. **`Important Note Regarding Previously Stored twitter_followers Data:`** Please be aware that if you have previously stored `twitter_followers` data obtained from the CoinGecko API and archived it within your own systems, you are solely responsible for its continued use and any implications thereof. We appreciate your understanding as we adapt to changes in third-party platforms to maintain the stability and reliability of our API. If you have any questions or require further clarification, please do not hesitate to contact our support team. ## New Endpoint & Multiple Improvements: On-Chain Top Token Holder Address, Security Data, Historical Supply. πŸ—“οΈ **March 28, 2025** ### \[Pro-API Exclusive] New Endpoint - Top Token Holder Address Data You can now access the top 50 token holder address data for tokens, as seen on GeckoTerminal.com. By default, this endpoint returns the top 10 holders data, you can also specify the `holders` parameter to retrieve up to top 50 holders data. **Network supported:** * EVM: Ethereum, Polygon, BNB, Arbitrum, Optimism, Base * Solana * Sui * TON * Ronin πŸ‘‰ Visit the endpoint reference page - [Top Token Holders by Token Address](https://docs.coingecko.com/reference/top-token-holders-token-address) to learn more and try it out now! **Note:** this exclusive endpoint is available for our API [paid plan](https://www.coingecko.com/en/api/pricing) 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](https://docs.coingecko.com/reference/token-info-contract-address) * [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-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)](https://docs.coingecko.com/reference/coins-list) endpoint and flag `status=inactive`. Note: these endpoints below are exclusive for [Enterprise plan](https://www.coingecko.com/en/api/pricing) customers only. **Improved endpoints:** * [Circulating Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) * [Circulating Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) * [Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart) * [Total Supply Chart within time range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) ### Onchain Pool Data endpoints - Locked Liquidity Now support **`locked_liquidity_percentage`** data. **Improved endpoints:** * [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) ```json theme={null} { "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](https://support.coingecko.com/hc/en-us/articles/38381394237593-What-is-GT-Score-How-is-GT-Score-calculated). * **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](https://docs.coingecko.com/reference/token-info-contract-address) * [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) ```json theme={null} "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](https://docs.coingecko.com/reference/onchain-simple-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 networks. 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 `mcap_fdv_fallback=true`. ## Update Frequency Improvements for selected Pro-API endpoints (March 2025) πŸ—“οΈ **March 14, 2025** \[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing) 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](https://docs.coingecko.com/reference/trending-pools-list) 2. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network) 3. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network) 4. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex) 2. Effective from 02:00 UTC, March 26, 2025: 1. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network) 2. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list) 3. [Megafilter for Pools](https://docs.coingecko.com/reference/pools-megafilter) 4. [Search Pools](https://docs.coingecko.com/reference/search-pools) 3. Effective from 02:00 UTC, March 27, 2025: 4. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address) 5. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated) 6. [Pools by Category ID](https://docs.coingecko.com/reference/pools-category) **What This Means for You:** * **Fresher Data, Quicker**: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! * **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before. **Things to Keep in Mind:** * If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. * To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [soonaik@coingecko.com](mailto:soonaik@coingecko.com). **CoinGecko API Team** ## Multiple Improvements: Holders data, Pool Stats, Simple Token Price πŸ—“οΈ **March 14, 2025** ### Onchain Token Info endpoints - Holders data Now support the following holder data **(Beta)**: * holders count * top holders distribution percentage **Improved endpoints:** * [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) * [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) ```json theme={null} "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](https://docs.coingecko.com/reference/pool-address) * [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) ```json theme={null} "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_reserve_in_usd` (token liquidity data - total liquidity portion attributable to a specific token across all available pools) **Improved Endpoint:** * [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) ```json theme={null} { "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! πŸ—“οΈ **February 27, 2025** 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](https://docs.coingecko.com/reference/pools-megafilter) ### πŸ‘€ 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 are 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](https://docs.coingecko.com/reference/pools-megafilter)\ πŸ”— Live Filtering on [GeckoTerminal](https://www.geckoterminal.com/) ## Update Frequency Improvements for selected Pro-API endpoints πŸ—“οΈ **February 14, 2025** \[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing) 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. | Endpoints | Effective Date & Time | Current Update Frequency | New Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------- | :----------------------- | :------------------- | | Onchain [/networks/../tokens/](https://docs.coingecko.com/reference/token-data-contract-address) | 02:00 UTC, February 24, 2025 | 60s | 30s | | Onchain [/networks/../tokens/multi/](https://docs.coingecko.com/reference/tokens-data-contract-addresses) | 06:00 UTC, February 24, 2025 | 60s | 30s | | Onchain [/networks/../pools/../ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 25, 2025 - Enterprise plan subscribers only | 60s | 30s | | Onchain [/networks/../pools/../ohlcv](https://docs.coingecko.com/reference/pool-ohlcv-contract-address) | 02:00 UTC, February 26, 2025 - Analyst/Lite/Pro plan subscribers | 60s | 30s | **What This Means for You:** * **Fresher Data, Quicker**: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! * **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before. **Things to Keep in Mind:** * If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. * To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer to obtain data without extra credits, consider keeping your request interval at 60 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [soonaik@coingecko.com](mailto:soonaik@coingecko.com). **CoinGecko API Team** ## Enhanced Onchain Metadata, Increased Max Address Limit for Multi Endpoints, Improved Exchange Tickers Sorting πŸ—“οΈ **February 09, 2025** ### Onchain Metadata: Improved Coverage **Previously:** Payload may return 'missing.png' for `image_url` for tokens that do not have image data. **Now:** Coverage of metadata (images, websites, description, socials) is now improved for tokens on Solana, TON, Base, and Sui networks. For tokens that do not contain image data, 'null' value will be returned for `image_url`. **Improved endpoints with image data:** 1. [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list) 2. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network) 3. [Specific Pool Data by Pool Address](https://docs.coingecko.com/reference/pool-address) 4. [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-addresses) 5. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network) 6. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex) 7. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network) 8. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list) 9. [Search Pools](https://docs.coingecko.com/reference/search-pools) 10. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address) 11. [Token Data by Token Address](https://docs.coingecko.com/reference/token-data-contract-address) 12. [Tokens Data by Token Addresses](https://docs.coingecko.com/reference/tokens-data-contract-addresses) 13. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) 14. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) 15. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated) **Improved endpoints with metadata (images, websites, description, socials):** 1. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) 2. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) 3. [Most Recently Updated Tokens List](https://docs.coingecko.com/reference/tokens-info-recent-updated) Note: Metadata may be sourced on-chain and is not vetted by the CoinGecko team. If you wish to get metadata reviewed by the CoinGecko team, you may use the following endpoints: * [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) * [Coin Data by Token Address](https://docs.coingecko.com/reference/coins-contract-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](https://docs.coingecko.com/reference/tokens-data-contract-addresses) 2. [Multiple Pools Data by Pool Addresses](https://docs.coingecko.com/reference/pools-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](https://docs.coingecko.com/reference/exchanges-id-tickers) 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. ## Multiple Improvements: Onchain Pools Page Limit, Trades Token Filter πŸ—“οΈ **January 27, 2025** ### Onchain Pools Data: Supports more than 10 pages of data **Previously:** There was a limitation of a maximum of 10 pages for accessing pools data in the related endpoints. **Now:** All paid plan subscribers (Analyst & above) can access more than 10 pages of pools data for the endpoints below. **Improved Endpoints:** 1. [Search Pools](https://docs.coingecko.com/reference/search-pools) 2. [Top Pools by Token Address](https://docs.coingecko.com/reference/top-pools-contract-address) 3. [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list) 4. [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network) 5. [New Pools by Network](https://docs.coingecko.com/reference/latest-pools-network) 6. [New Pools List](https://docs.coingecko.com/reference/latest-pools-list) 7. [Top Pools by Network](https://docs.coingecko.com/reference/top-pools-network) 8. [Top Pools by Dex](https://docs.coingecko.com/reference/top-pools-dex) ### Onchain Trades: Added Token Filter **Endpoint:** [Past 24 Hour Trades by Pool Address](https://docs.coingecko.com/reference/pool-trades-contract-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**: ```json Example theme={null} ?token=base // get the trades data of base token ?token=quote // get the trades data of quote token ?token=8FqXr6dw5NHA2TtwFeDz6q9p7y9uWyoEdZmpXqqUpump // get the trades data of specific token based on address ``` ## Multiple Improvements: Onchain Token Price, NFT Market Cap πŸ—“οΈ **January 24, 2025** ### Onchain Simple Token Price: Added Market Cap and 24h Volume Data **Endpoint:** [Token Price by Token Addresses](https://docs.coingecko.com/reference/onchain-simple-price) * You can now flag `include_market_cap=true` and `include_24hr_vol=true` to retrieve market cap and 24h trading volume data. e.g. ```json theme={null} { "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](https://docs.coingecko.com/reference/nfts-id) * [NFTs Collection Data by Contract Address](https://docs.coingecko.com/reference/nfts-contract-address) ```json example theme={null} "market_cap_rank": 75, ``` ## Removal of Unsupported Categories πŸ—“οΈ **January 23, 2025** ### Upcoming Removal of Unsupported Categories from CoinGecko and CoinGecko API 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**. | No | Category Name | Category ID | | :- | :--------------------- | :------------------ | | 1 | US Election 2020 | us-election-2020 | | 2 | Governance | governance | | 3 | Cryptocurrency | cryptocurrency | | 4 | Technology and Science | technology-science | | 5 | Presale Meme | presale-meme-coins | | 6 | Business Platform | business-platform | | 7 | Number | number | | 8 | Structured Product | structured-products | | 9 | Investment | investment | | 10 | Niftex Shards | niftex-shards | | 11 | Ethereum POW IOU | ethereum-pow-iou | | 12 | Mirrored Assets | mirrored-assets | | 13 | Remittance | remittance | | 14 | Protocol | protocol | | 15 | Unicly Ecosystem | utokens | | 16 | Finance and Banking | finance-banking | | 17 | Eth 2.0 Staking | eth-2-0-staking | **Reason for Removal:** Many of these categories no longer have associated coins. Some categories are outdated and no longer relevant in the crypto space. The changes align with updated category taxonomy standards to maintain data accuracy and relevance. **Impact:** API responses for the `/coins/markets` [endpoint](https://docs.coingecko.com/reference/coins-markets) 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](https://docs.coingecko.com/reference/coins-markets) are not querying these removed categories. Please update any code or documentation referencing these categories to prevent errors. ## Extended Historical Data for Onchain OHLCV Endpoint πŸ—“οΈ **January 15, 2025** We've improved the [Pool OHLCV Chart by Pool Address](https://docs.coingecko.com/reference/pool-ohlcv-contract-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](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan & above). **Action Required** No changes are required for existing integrations. However, users who need data beyond the past 6 months should adjust their queries to use the `before_timestamp` parameter to fetch additional data. ## Update to Total Supply of POW Coins πŸ—“οΈ **January 15, 2025** **What's Changing?** We are updating the definition of Total Supply for PoW (Proof-of-Work) coins to reflect the actual number of mined coins rather than the maximum supply. This change ensures consistency and accuracy in representing the supply data. **Key Updates** * **Previous Behavior:** * Total Supply: Displayed as the maximum possible supply (e.g., Bitcoin: 21,000,000). * **New Behavior:** * Total Supply: Now reflects the actual number of mined coins.\ For example: Bitcoin: \~19,500,000 (as of January 2025). This update will also affect historical Total Supply data for consistency. This change applies to all affected PoW coins, including Bitcoin, Bitcoin Cash, Litecoin, Ethereum Classic, and more. **Affected endpoints** that contain "total\_supply" data: * **Current Data** * [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) * [Coins List with Market Data](https://docs.coingecko.com/reference/coins-markets) * **Historical Data** * [Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart) * [Total Supply chart within time range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) **Timeline:** **Bitcoin:** Updated on Jan 14, 2025 **Other PoW Coins**: Scheduled for Jan 22, 2025 * [Bitcoin Cash](https://www.coingecko.com/en/coins/bitcoin-cash) * [Litecoin](https://www.coingecko.com/en/coins/litecoin) * [Ethereum Classic](https://www.coingecko.com/en/coins/ethereum-classic) * [Bitcoin SV](https://www.coingecko.com/en/coins/bitcoin-sv) * [Zcash](https://www.coingecko.com/en/coins/zcash) * [eCash](https://www.coingecko.com/en/coins/ecash) * [Dash](https://www.coingecko.com/en/coins/dash) * [Verus Coin](https://www.coingecko.com/en/coins/verus-coin) * [Ravencoin](https://www.coingecko.com/en/coins/ravencoin) * [Kadena](https://www.coingecko.com/en/coins/kadena) * [Decred](https://www.coingecko.com/en/coins/decred) * [Flux (Zelcash)](https://www.coingecko.com/en/coins/flux-zelcash) * [DigiByte](https://www.coingecko.com/en/coins/digibyte) * [Quantum Resistant Ledger](https://www.coingecko.com/en/coins/quantum-resistant-ledger) * [Komodo](https://www.coingecko.com/en/coins/komodo) * [Groestlcoin](https://www.coingecko.com/en/coins/groestlcoin) * [Firo](https://www.coingecko.com/en/coins/firo) * [Litecoin Cash](https://www.coingecko.com/en/coins/litecoin-cash) * [LuckyCoin](https://www.coingecko.com/en/coins/luckycoin) * [Enecuum](https://www.coingecko.com/en/coins/enecuum) * [Wownero](https://www.coingecko.com/en/coins/wownero) * [Radiant](https://www.coingecko.com/en/coins/radiant) * [Tidecoin](https://www.coingecko.com/en/coins/tidecoin) * [Handshake](https://www.coingecko.com/en/coins/handshake) * [Neoxa](https://www.coingecko.com/en/coins/neoxa) * [Vertcoin](https://www.coingecko.com/en/coins/vertcoin) * [Feathercoin](https://www.coingecko.com/en/coins/feathercoin) * [Bitcore](https://www.coingecko.com/en/coins/bitcore) * [Phoenixcoin](https://www.coingecko.com/en/coins/phoenixcoin) * [BitcoinZ](https://www.coingecko.com/en/coins/bitcoinz) * [Hush](https://www.coingecko.com/en/coins/hush) * [DigitalNote](https://www.coingecko.com/en/coins/digitalnote) * [EquityPay](https://www.coingecko.com/en/coins/equitypay) * [Evadore](https://www.coingecko.com/en/coins/evadore) * [Swap](https://www.coingecko.com/en/coins/swap) * [DeVault](https://www.coingecko.com/en/coins/devault) * [AXE](https://www.coingecko.com/en/coins/axe) * [Iridium](https://www.coingecko.com/en/coins/iridium) * [X-Cash](https://www.coingecko.com/en/coins/x-cash) * [Bolivarcoin](https://www.coingecko.com/en/coins/bolivarcoin) * [uPlexa](https://www.coingecko.com/en/coins/uplexa) * [WorldCoin (WDC)](https://www.coingecko.com/en/coins/worldcoin-wdc) ## Improved Update Frequency for selected Pro-API endpoints πŸ—“οΈ **January 13, 2025** \[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing) only.] The edge cache duration for the following endpoints are now reduced to 20-30s, allowing you to retrieve updated data more frequently. | Endpoints | Previous Update Frequency | Current Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :------------------------ | :----------------------- | | CoinGecko [/simple/price](https://docs.coingecko.com/reference/simple-price) | 30s | 20s | | CoinGecko [/simple/token\_price](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s | | Onchain [/simple/networks/../token\_price](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s | | Onchain [/networks/../pools/../trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s | | Onchain [/networks/../pools/..](https://docs.coingecko.com/reference/pool-address) | 60s | 30s | | Onchain [/networks/../pools/multi/..](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s | **What This Means for You:** * **Fresher Data, Quicker**: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! * **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before. **Things to Keep in Mind:** * If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. * To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [soonaik@coingecko.com](mailto:soonaik@coingecko.com). **CoinGecko API Team** ## Improved 5-minutely data for Historical Chart Data endpoints πŸ—“οΈ **January 09, 2025** For the following 4 historical chart endpoints, the data of the *last 48 hours from now* is no longer excluded. * [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart) * [Coin Historical Chart Data within Time Range by ID](https://docs.coingecko.com/reference/coins-id-market-chart-range) * [Coin Historical Chart Data by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart) * [Coin Historical Chart Data within Time Range by Token Address](https://docs.coingecko.com/reference/contract-address-market-chart-range) **Note:** The **5-minutely** and **hourly** interval params are exclusively available to Enterprise plan subscribers, bypassing auto-granularity: * `interval=5m`: 5-minutely historical data, supports up to any 10 days date range per request. * `interval=hourly`: hourly historical data, supports up to any 100 days date range per request. * **Data availability:** * `interval=5m`: Available from 9 February 2018 onwards * `interval=hourly`: Available from 30 Jan 2018 onwards For non-Enterprise plan subscribers who would like to get hourly data, please leave the `interval` params empty for auto granularity: * 1 day from current time = 5-minutely data * 1 day from any time (except current time) = hourly data * 2 - 90 days from any time = hourly data * above 90 days from any time = daily data (00:00 UTC) ## Added: Onchain Categories Data, CG data improvements πŸ—“οΈ **December 24, 2024** ### NEW: Onchain Categories: Get Categories on GeckoTerminal.com This new [Categories List](https://docs.coingecko.com/reference/categories-list) endpoint allows you to query all the categories supported on GeckoTerminal.com such as 'Pump Fun' and 'Animal'. * This endpoint is exclusively available for [Analyst/Lite/Pro/Enterprise plan](https://www.coingecko.com/en/api/pricing) subscribers only. ### NEW: Onchain Category Pools: Get Pools of a specific Category This new [Pools by Category ID](https://docs.coingecko.com/reference/pools-category) endpoint allows you to query all the pools of a specific category on GeckoTerminal.com. * This endpoint is exclusively available for [Analyst/Lite/Pro/Enterprise plan](https://www.coingecko.com/en/api/pricing) subscribers only. * You can also obtain tokens of a specific category, by flagging `include=base_token` ### Onchain Token Info: Added Categories Data You can now obtain the categories of a token via the following endpoints: 1. [Token Info by Token Address](https://docs.coingecko.com/reference/token-info-contract-address) 2. [Pool Tokens Info by Pool Address](https://docs.coingecko.com/reference/pool-token-info-contract-address) Payload example: ```json theme={null} "categories": [ "Doge", "Baby", "Animal" ], "gt_category_ids": [ "doge", "baby", "animal" ``` ### Onchain New Pools Data: Bug Fixed Previously, this [/networks/new\_pools](https://docs.coingecko.com/reference/latest-pools-list) endpoint omitted new pools that were created within the last 24 hours. It now returns all newly created pools in the last 48 hours. ### CoinGecko Exchange Data: Added support of inactive exchange id You can now query the list of IDs of delisted exchanges with [Exchanges List (ID Map)](https://docs.coingecko.com/reference/exchanges-list) endpoint, by flagging `status=inactive` Payload example: ```json theme={null} { "id": "ftx", "name": "FTX (Derivatives)" }, { "id": "ftx_spot", "name": "FTX" }, { "id": "ftx_tr", "name": "FTX TR" }, { "id": "ftx_us", "name": "FTX.US" }, ``` **Tips**: you may query to get historical volume of delisted exchanges via the following endpoints: * [Exchange Volume Chart by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart) * [Exchange Volume Chart within Time Range by ID](https://docs.coingecko.com/reference/exchanges-id-volume-chart-range) ### CoinGecko Historical Chart Data: Faster Last UTC Day (00:00) Data Update For [Coin Historical Chart Data by ID](https://docs.coingecko.com/reference/coins-id-market-chart) endpoint, the last completed UTC day (00:00) data is now available **10 minutes after midnight** on the next UTC day (00:10). Previously, the last completed UTC day (00:00) was only made available **35 minutes** after midnight. ## \[Updated: Q4 2024] CoinGecko Asset Issuance Standardisation Initiative Updates πŸ—“οΈ **December 17, 2024** As part of our commitment to improving data quality and enhancing the consistency of asset information, we are rolling out an asset standardization initiative at CoinGecko. **What is asset standardization?**\ Standardization involves refining how we classify and display assets. By systematically organizing asset listings into more precise categories - such as native, bridged, or wrapped tokens, each following specific naming conventions, we aim to eliminate confusion and enhance data reliability. **What changes should I expect?**\ The most notable change is that non-native token contracts previously grouped under native asset listings will now be assigned their own distinct pages. For example, a bridged version of USDT that might have been aggregated under the original, native USDT page, will now be featured on a dedicated page specifically for that bridged variant. Additionally, there may be varying levels of changes in various aggregated data points of the standardized assets, including trading volume, supply, market cap rankings, etc., due to misplaced contracts being transitioned away from the original page to accurately reflect their true metrics. **Focus for Q3 2024** **\[Completed βœ…]** * [Wrapped Bitcoin (WBTC)](https://www.coingecko.com/en/coins/wrapped-bitcoin) * [Wrapped Ethereum (WETH)](https://www.coingecko.com/en/coins/weth) * [Dai (DAI)](https://www.coingecko.com/en/coins/dai) **For full list of FAQs and updated information, please refer [here](https://support.coingecko.com/hc/en-us/articles/35555248857497-CoinGecko-Asset-Issuance-Standardisation-Initiative-Updates-and-FAQ)** ### What's New in Q4 2024? πŸ‘ˆ Building on Q3's achievements, we're expanding the scope of Standardization to include four additional Coins this quarter, selected based on their significance and impact on the DeFi ecosystem. * [Frax (FRAX)](https://www.coingecko.com/en/coins/frax) * [Wrapped AVAX (WAVAX)](https://www.coingecko.com/en/coins/wrapped-avax) * [Wrapped BNB (WBNB)](https://www.coingecko.com/en/coins/wbnb) * [Wrapped stETH (wstETH)](https://www.coingecko.com/en/coins/wrapped-steth) ### Tips and FAQs for API users #### **1. How does this affect my current API setup?** The following CoinGecko API endpoints will be impacted, with full details tracked in [this spreadsheet](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing). We encourage you to make the necessary adjustments and enable edit notifications on the Google Sheets, to receive real-time updates when non-native token contracts have been successfully standardized. **Simple** * /simple/price * /simple/token\_price/id **Coins** * /coins/markets * /coins/id * /coins/id/tickers * /coins/id/history * /coins/id/market\_chart * /coins/id/market\_chart/range * /coins/id/ohlc * /coins/id/ohlc/range * /coins/id/circulating\_supply\_chart * /coins/id/circulating\_supply\_chart/range * /coins/id/total\_supply\_chart * /coins/id/total\_supply\_chart/range **Contract** * /coins/id/contract/contract\_address * /coins/id/contract/contract\_address/market\_chart * /coins/id/contract/contract\_address/market\_chart/range **Exchange** * /exchanges/id/tickers * /exchanges/id/volume\_chart * /exchanges/id/volume\_chart/range #### **2. Do I have to make changes to my API?** **No changes are necessary** if you do not need data for non-native token contracts that will be separated away from the native tokens. #### **3. What will happen to the coins that are separated into a new coin page?** Historical data for new non-native or bridged assets will only be available from the date of asset page creation (i.e. standardized). To access historical data prior to the asset standardization, we recommend retrieving data from the original native assets. #### **4. How do I identify the list of coins that will be separated?** For a finalised list of token contracts and API IDs that have been separated from its native asset page and listed individually, please refer to this [Google Sheets](https://docs.google.com/spreadsheets/d/15FyY1gvUi20LdnlJRly-pXvm5ATNbFbSy06VoI1vVs4/edit?usp=sharing) You may also identify the list of bridged coins via API: you may also use [/categories/list endpoint](/reference/coins-categories-list) to look for bridged categories such as: 1. bridged-usdc 2. bridged-wbtc 3. bridged-weth Then you may use [/coins/markets endpoint](/reference/coins-markets) to retrieve the list of coins ## Enhancing Your Access to Even Fresher Data! πŸ—“οΈ **December 16, 2024** \[Changes below are applicable to Analyst/Lite/Pro/Enterprise [plan subscribers](https://www.coingecko.com/en/api/pricing) only.] **Dear CoinGecko API paid plan subscribers,** We're excited to announce an improvement to our API, aimed at providing you with even faster access to real-time data! Starting **02:00 UTC, January 13, 2025**, the edge cache duration for the following endpoints will be reduced to 20-30s, allowing you to retrieve updated data more frequently. | Endpoints | Current Update Frequency | New Update Frequency | | :-------------------------------------------------------------------------------------------------------- | :----------------------- | :------------------- | | CoinGecko [/simple/price](https://docs.coingecko.com/reference/simple-price) | 30s | 20s | | CoinGecko [/simple/token\_price](https://docs.coingecko.com/reference/simple-token-price) | 30s | 20s | | Onchain [/simple/networks/../token\_price](https://docs.coingecko.com/reference/onchain-simple-price) | 60s | 30s | | Onchain [/networks/../pools/../trades](https://docs.coingecko.com/reference/pool-trades-contract-address) | 60s | 30s | | Onchain [/networks/../pools/..](https://docs.coingecko.com/reference/pool-address) | 60s | 30s | | Onchain [/networks/../pools/multi/..](https://docs.coingecko.com/reference/pools-addresses) | 60s | 30s | **What This Means for You:** * **Fresher Data, Quicker**: With a reduced cache time, you'll now have the option to access more up-to-date data, closer to real-time! * **No Extra Credits for Cached Data**: If your request hits the cache (now updated every 20-30 seconds for endpoints above), there will be no additional credits chargedβ€”just like before. **Things to Keep in Mind:** * If your request hits our origin server instead of the cache to retrieve the latest data, there may be additional credits used. * To balance cost and real-time data needs, we recommend reviewing your request frequency. For those who prefer fresher data without extra credits, consider keeping your request interval at 30 seconds or more to align with the new cache duration. We're committed to continuously improving your experience and ensuring you get the data you need, as efficiently as possible. If you have any questions or need assistance, feel free to reach out to [soonaik@coingecko.com](mailto:soonaik@coingecko.com). **CoinGecko API Team** ## Multiple Improvements: Onchain Trending Pools, CG New Currencies Support, Snapshot, Exchange Info πŸ—“οΈ **December 15, 2024** ### Onchain Trending Pools: Added Support to Filter by Duration You can now query trending pools with the following endpoints, and filter them by different duration: 5m, 1h, 6h, 24h, using `duration` parameter. e.g. `duration=5m` * [Trending Pools List](https://docs.coingecko.com/reference/trending-pools-list): query all the trending pools across all networks on GeckoTerminal * [Trending Pools by Network](https://docs.coingecko.com/reference/trending-pools-network): query the trending pools based on the provided network ### CG Coin Prices: Added Support for New Fiat Currencies You can now query coin prices in the 13 new currencies for the following 3 endpoints: * [Coin Price by IDs](https://docs.coingecko.com/reference/simple-price): query latest price in selected currencies, by coin ID * [Coin Price by Token Addresses](https://docs.coingecko.com/reference/simple-token-price): query latest price in selected currencies, by token address * [BTC-to-Currency Exchange Rates](https://docs.coingecko.com/reference/exchange-rates): query BTC exchange rates with other currencies **New supported currencies:** 1. Colombia | COP 2. Kenya | KES 3. Romania | RON 4. Dominican Republic | DOP 5. Costa Rica | CRC 6. Honduras | HNL 7. Zambia | ZMW 8. El Salvador | SVC 9. Bosnia and Herzegovina | BAM 10. Peru | PEN 11. Guatemala | GTQ 12. Lebanon | LBP 13. Armenian Dram | AMD ### CG Coin Info: Included Snapshot URL [Coin Data by ID](https://docs.coingecko.com/reference/coins-id) now includes Snapshot link, e.g. ```json theme={null} "snapshot_url": "https://snapshot.org/#/lido-snapshot.eth", ``` ### CG Exchange Info: Included Number of Coins and Pairs [Exchange Data by ID](/reference/exchanges-id) now includes "coins" and "pairs", e.g. ```json theme={null} "coins": 384, "pairs": 1281, ``` ## Multiple Improvements: Onchain Simple Price, Onchain Recently Updated Info, NFT Collection Data πŸ—“οΈ **October 09, 2024** ### Onchain: Simple Price - Increased Token Address Limit from 30 to 100 [Token Price by Token Addresses](/reference/onchain-simple-price) now allows you to input up to 100 contract addresses, instead of 30. * You may now retrieve data of up to 100 token prices of a specific network, in one single request. * Available exclusively to Pro API paid plan subscribers. ### Onchain: Recently Updated Info - Added Filter by Network [Most Recently Updated Token List](/reference/tokens-info-recent-updated) now allows you to filter by blockchain network, by flagging the `network` parameter. e.g. `network=eth`. * You can use the `network` parameter to retrieve the 100 most recently updated token info of a specific network. * View list of supported network via [Supported Networks List](https://docs.coingecko.com/reference/networks-list) endpoint. ### NFT Collection Data - Included Banner Image [NFTs Collection Data by ID](/reference/nfts-id) now provides banner image of an NFT collection. View banner image [example](https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.png?1708416126) on: [https://www.coingecko.com/en/nft/pudgy-penguins](https://www.coingecko.com/en/nft/pudgy-penguins) ```json theme={null} { "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 πŸ—“οΈ **September 26, 2024** ### Global Market Chart - Improved Daily Data Update Previously, for [Global Market Cap Chart Data endpoint](https://docs.coingecko.com/reference/global-market-cap-chart), the daily data is returned at 23:00 UTC. We've made an improvement to return daily data at 00:00 UTC. The last completed UTC day (00:00) is available 5 minutes after midnight on the next UTC day (00:05). The cache will **always expire at 00:05 UTC**. If you wish to get the latest daily data (00:00 UTC), you can make a request at 00:05 UTC or later. ### Asset Platforms - Included Images of Blockchain Network Logos [Asset Platforms List (ID Map)](/reference/asset-platforms-list) now provides the logos of blockchain networks. For example: ```json theme={null} "image": { "thumb": "https://coin-images.coingecko.com/asset_platforms/images/93/thumb/AN_logomark.png?1706606703", "small": "https://coin-images.coingecko.com/asset_platforms/images/93/small/AN_logomark.png?1706606703", "large": "https://coin-images.coingecko.com/asset_platforms/images/93/large/AN_logomark.png?1706606703" } ``` ### Coins Categories - Included IDs of Top 3 Coins [Coins Categories List with Market Data](/reference/coins-categories) now provides coin IDs of the top 3 coins of a category. For example: ```json theme={null} "top_3_coins_id": [ "bitcoin", "ethereum", "binancecoin" ], ``` ### Circulating Supply Chart and Total Supply Chart - Fixed '0' data issue For the following **Enterprise-plan** exclusive endpoints below, there was a bug that returned wrong '0' value in the payload. This is fixed and will no longer return wrong '0' value in the payload. 1. [πŸ‘‘ Circulating Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart) 2. [πŸ‘‘ Circulating Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-circulating-supply-chart-range) 3. [πŸ‘‘ Total Supply Chart by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart) 4. [πŸ‘‘ Total Supply Chart within Time Range by ID](https://docs.coingecko.com/reference/coins-id-total-supply-chart-range) ## Improvement of update frequency for OHLC endpoints πŸ—“οΈ **September 04, 2024** The cache & update frequency of the following endpoints have been improved from every 30 minutes to every 15 minutes: * [/coins/{id}/ohlc](/reference/coins-id-ohlc) * [/coins/{id}/ohlc/range](/reference/coins-id-ohlc-range) ## Included new fields - NFT data πŸ—“οΈ **August 18, 2024** We've added 'user\_favorites\_count', and 'ath' (all-time-high) related data to the following NFT endpoints: * [/nfts/{id}](/reference/nfts-id) * [/nfts/{asset_platform_id}/contract/{contract_address}](/reference/nfts-contract-address) **Example of responses:** ```json theme={null} { "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/id/ohlc/range endpoint πŸ—“οΈ **May 10, 2024** We've introduced a new endpoint [/coins/{id}/ohlc/range](/reference/coins-id-ohlc-range). This endpoint allows you to get the OHLC chart (Open, High, Low, Close) of a coin within a range of timestamps based on particular coin ID. Please note that this endpoint is available exclusively for **paid plan subscribers only**. ## Added interval hourly params to /coins/id/ohlc πŸ—“οΈ **May 04, 2024** We've expanded functionality to include support for the `interval=hourly` parameter within the [/coins/{id}/ohlc](/reference/coins-id-ohlc) endpoint. Users can use this parameter to retrieve OHLC (Open/High/Low/Close) data on an hourly interval for up to 90 days of the date range. Example of endpoint request: `https://pro-api.coingecko.com/api/v3/coins/bitcoin/ohlc?vs_currency=usd&days=1&interval=hourly&x_cg_pro_api_key=YOUR_API_KEY` ## Added support for inactive coins in /coins/list and historical data endpoints πŸ—“οΈ **April 30, 2024** We've now enhanced the [/coins/list](/reference/coins-list) endpoint to include inactive coins * You may access the inactive coins by specifying `status=inactive` in your query * Example of endpoint request:\ `https://pro-api.coingecko.com/api/v3/coins/list?include_platform=false&status=inactive&x_cg_pro_api_key=YOUR_API_KEY` Additionally, historical data for inactive coins can be queried using their IDs in the following endpoints: * [/coins/{id}/history](/reference/coins-id-history) * [/coins/{id}/market\_chart](/reference/coins-id-market-chart) * [/coins/{id}/market\_chart/range](/reference/coins-id-market-chart-range) * [/coins/{id}/contract/{contract_address}/market\_chart](/reference/contract-address-market-chart) * [/coins/{id}/contract/{contract_address}/market\_chart/range](/reference/contract-address-market-chart-range) Please note that these features are available exclusively for **paid plan subscribers only**. ## Introduced /key endpoint πŸ—“οΈ **March 27, 2024** We've introduced a new endpoint [/key](/reference/api-usage) for conveniently monitoring your account's API usage, including rate limits and remaining credits. **Example of responses**: ```json theme={null} { "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) πŸ—“οΈ **February 28, 2024** * image\_url is now returned in the token response for pools and tokens endpoints: Example of responses: ```json JSON theme={null} "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](/reference/pool-ohlcv-contract-address) 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](/reference/pool-ohlcv-contract-address) endpoint now includes the base and target token metadata in the response\ Example of responses: ```json JSON theme={null} { "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/network/trending\_pools endpoint (Onchain/GT) πŸ—“οΈ **February 19, 2024** Trending Pools endpoint, [/networks/{network}/trending\_pools](/reference/trending-pools-network) is now available to fetch a list of pools that are trending as seen on GeckoTerminal based on web visits and on-chain activities. ## Introduced /search/pools endpoint (Onchain/GT) πŸ—“οΈ **February 19, 2024** Added new endpoint to search for pools /search/pools based on keywords passed into query. ## Included new field for /coins/id endpoint πŸ—“οΈ **January 18, 2024** We've included a new field "whitepaper" under "links" section for [/coins/{id}](/reference/coins-id) endpoint **Example of responses:** ```json theme={null} { "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": {} }, ....... } ```