New Endpoint & Improvements: On-Chain Trades, Net Buy Volume, and More
[Pro-API Exclusive] New Endpoint - On-chain Trades by Token Address
Previously, the Past 24 Hour Trades by Pool Address endpoint allows you to retrieve the last 300 trades of a specific pool only.
With this new endpoint Past 24 Hour Trades by Token Address, you can now retrieve the last 300 trades across different pools, based on the provided token contract address on a network.
Improved Endpoints - Support Net Buy Volume Data
The following endpoints now support more volume breakdown data:
By flagging include_volume_breakdown=true , you can surface the following data:
- net_buy_volume_usd
- buy_volume_usd
- sell_volume_usd
Improved Endpoint - On-Chain OHLCV endpoint
Pool OHLCV chart by Pool Address endpoint now supports to include empty intervals by flagging include_empty_intervals=true .
- By default, specific timeframe intervals (e.g. minutely) with no recorded swaps are excluded (or skipped) from the response.
- This new parameter option provides the flexibility to get padded data, when there's no trade data.
Improved Endpoints - Support Large Images
The following endpoints now support more size options for coin logo image:
Improved Endpoints - Support Normalized Supply Data
The following endpoints now support normalized_total_supply:
Improved Endpoints - Support Pool 'Name' and 'Fee' Data
The following endpoints now support pool_name and pool_fee:
Improved Endpoints - Support Symbols of DEX Pairs
The following endpoints now allow to flag dex_pair_format=symbol to return DEX pair symbols instead of contract address.
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, you can now retrieve the on-chain trending search pools and tokens data, as seen on GeckoTerminal.com .
By default, this endpoint returns the top 4 trending pools data, you may specify the pools parameter to retrieve up to top 10 pools data.
Tips: you may flag include=base_token to retrieve the trending tokens data.
Note: this exclusive endpoint is available for our API paid plan subscribers (Analyst plan & above).
[Pro-API Exclusive] Improved Endpoint - Trending Search List
Paid plan subscribers (Analyst plan & above) can now use Trending Search List endpoint and flag show_max parameter to retrieve more trending coins, NFTs and coin categories on CoinGecko.com.
| Trending 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:
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.
| 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 withinclude_tokens
The include_tokensparameter has been added to provide flexibility when filtering by symbol:
include_tokens=top: Returns only the top market cap token for the specified symbol.include_tokens=all: Returns all tokens that share the specified symbol.
Example Request & Data:
| Request Example | Token Data Returned | Remarks |
|---|---|---|
| pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&symbols=btc&include_tokens=top | 1. Bitcoin | When symbols and 'include_tokens=top' is specified, only the top market cap tokens will be returned. |
| pro-api.coingecko.com/api/v3/coins/markets?vs_currency=usd&symbols=btc&include_tokens=all | 1. Bitcoin 2. Osmosis allBTC 3. atcat 4. Meld Bridged BTC (Meld) 5. BlackrockTradingCurrency | When symbols and 'include_tokens=all' is specified, all the coins that share the same symbol will be returned. All the 5 coins stated in the example have the same symbol 'btc'. |
/coins/markets Endpoint Improvement
We've enhanced the/coins/markets endpoint Coins List with Market Data, by including 'total' and 'per-page' values in the Response Headers.
This addition to the Response Headers enables developers to identify the total number of active coins on coingecko.com and specify the required pagination to retrieve all available data.