CoinGecko API: List trending coins
Lists up to 15 of the most-searched coins on CoinGecko in trending order, with price and 24-hour change in the chosen currency. Non-USD prices may be unavailable for some coins.
Unofficial. Not affiliated with or endorsed by CoinGecko.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Currency optional
currency Currency for prices and 24-hour changes, such as USD or EUR.
USD
Exactly 3 characters. Default
USD.
Input as JSON
{ "currency": "USD"}Output
{ "trending_coins": [ { "name": "Universal High Income", "price": 0.029752903788995113, "symbol": "UHI", "currency": "USD", "coingecko_link": "https://www.coingecko.com/en/coins/universal-high-income-2" , "market_cap_rank": 643, "trending_position": 1, "price_change_24h_percent": 44.38060490195063 }, { "name": "Dacity Coin", "price": 0.016406504164843638, "symbol": "DACITY", "currency": "USD", "coingecko_link": "https://www.coingecko.com/en/coins/dacity-coin-3" , "market_cap_rank": 922, "trending_position": 2, "price_change_24h_percent": 112.49592821909424 }, { "name": "Irys", "price": 0.035595925253853425, "symbol": "IRYS", "currency": "USD", "coingecko_link": "https://www.coingecko.com/en/coins/irys" , "market_cap_rank": 346, "trending_position": 3, "price_change_24h_percent": 73.03287489879648 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"coingecko.com/list_trending_coins","input":{"currency":"USD"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "coingecko.com/list_trending_coins" , "input": { "currency": "USD" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "coingecko.com/list_trending_coins" , "input": { "currency": "USD" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run coingecko.com/list_trending_coins# with {"currency":"USD"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "currency": { "type": "string", "default": "USD", "maxLength": 3, "minLength": 3, "description": "Currency for prices and 24-hour changes, such as USD or EUR." } }}Output schema
{ "type": "object", "required": [ "trending_coins" ], "properties": { "trending_coins": { "type": "array", "items": { "type": "object", "required": [ "trending_position", "name", "symbol", "market_cap_rank", "price", "currency", "price_change_24h_percent", "coingecko_link" ], "properties": { "name": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "symbol": { "type": "string" }, "currency": { "type": "string" }, "coingecko_link": { "type": "string" }, "market_cap_rank": { "type": [ "integer", "null" ] }, "trending_position": { "type": "integer" }, "price_change_24h_percent": { "type": [ "number", "null" ] } } }, "description": "Coins ordered by trending position." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
coingecko.com/list_trending_coins- Returns
- trending position, name, symbol, market cap rank, price, 24h change, CoinGecko link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method coingecko.com/list_trending_coins with the inputs above.
Ask your agent
- What coins are trending right now with their prices in USD and 24-hour change?
- Show me the top 15 most searched cryptocurrencies today priced in euros
- Which crypto tokens are gaining search interest on CoinGecko this hour?
- I want a trending coin list with market cap ranks and 24h percentage moves in Japanese yen
- What are the hottest coins people are looking up right now, priced in British pounds?
See more
All CoinGecko methodsGets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change.
coingecko.com/get_coin_price_historyGets a coin's price, market cap and 24-hour volume at 00:00 UTC on a past date. Non-USD currencies are available only for the last 365 days.
coingecko.com/get_coin_price_on_dateLists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
coingecko.com/list_crypto_categoriesLists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
coinmarketcap.com/list_top_coinsLists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.
trends.google.com/list_trending_searchesGets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap.
coinmarketcap.com/get_coin_priceLists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those.
themoviedb.org/list_trendingGets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.
coinbase.com/get_coin_overview