New Endpoint & Improvements: On-Chain Trending Data, Enhanced Trending Search, and Improved Token Lookup
[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 |
Trending Search on CoinGecko.com
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. 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 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 |
| 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 |
| 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.
per-page: 250
total:16989