CoinGecko API: List crypto categories
Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
Unofficial. Not affiliated with or endorsed by CoinGecko.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Category optional
category Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories.
Meme
Default
.- Max Results optional
max_results Maximum number of categories, for example 50 (up to 200).
5
Whole number from 1 to 200. Default
50.
Input as JSON
{ "category": "Meme", "max_results": 5}Output
{ "categories": [ { "category_link": "https://www.coingecko.com/en/categories/meme-token" , "category_name": "Meme", "market_cap_usd": 29901289067.534084, "volume_24h_usd": 1956101653.6085272, "top_coin_1_name": "Dogecoin", "top_coin_2_name": "Shiba Inu", "top_coin_3_name": "Pump.fun", "market_cap_change_24h_percent": 1.1352795333420356 }, { "category_link": "https://www.coingecko.com/en/categories/solana-meme-coins" , "category_name": "Solana Meme", "market_cap_usd": 3122049209.0300956, "volume_24h_usd": 519360489.4065774, "top_coin_1_name": "Pudgy Penguins", "top_coin_2_name": "Official Trump", "top_coin_3_name": "Bonk", "market_cap_change_24h_percent": 1.438976513925379 }, { "category_link": "https://www.coingecko.com/en/categories/ip-meme" , "category_name": "IP Meme", "market_cap_usd": 814359221.7508816, "volume_24h_usd": 144591117.44046223, "top_coin_1_name": "Pudgy Penguins", "top_coin_2_name": "ApeCoin", "top_coin_3_name": "cat in a dogs world", "market_cap_change_24h_percent": 2.292148338249442 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"coingecko.com/list_crypto_categories","input":{"category":"Meme","max_results":5}}' # 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_crypto_categories" , "input": { "category": "Meme", "max_results": 5 }})# 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_crypto_categories" , "input": { "category": "Meme", "max_results": 5 } }), 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_crypto_categories# with {"category":"Meme","max_results":5}"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": { "category": { "type": "string", "default": "", "description": "Category name, part of a name, category link, or category ID; for example, Meme or Artificial Intelligence. Leave blank for all categories." }, "max_results": { "type": "integer", "default": 50, "maximum": 200, "minimum": 1, "description": "Maximum number of categories, for example 50 (up to 200)." } }}Output schema
{ "type": "object", "required": [ "categories" ], "properties": { "categories": { "type": "array", "items": { "type": "object", "properties": { "category_link": { "type": "string" }, "category_name": { "type": "string" }, "market_cap_usd": { "type": [ "number", "null" ] }, "volume_24h_usd": { "type": [ "number", "null" ] }, "top_coin_1_name": { "type": [ "string", "null" ] }, "top_coin_2_name": { "type": [ "string", "null" ] }, "top_coin_3_name": { "type": [ "string", "null" ] }, "market_cap_change_24h_percent": { "type": [ "number", "null" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
coingecko.com/list_crypto_categories- Returns
- category name, market cap, 24h change, volume, top 3 coins, category 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_crypto_categories with the inputs above.
Ask your agent
- Show me the crypto sectors ranked by market cap with their 24h change and trading volume
- Which CoinGecko categories are gaining the most today, and what are their top 3 coins?
- Find the Meme coin category and tell me its market cap, volume, and leading tokens
- List up to 25 crypto categories including Artificial Intelligence, with links to their pages
- What are the biggest DeFi sectors right now by volume, and which coins lead each one?
See more
All CoinGecko methodsLists 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.
coingecko.com/list_trending_coinsGets 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 the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.
polymarket.com/list_trending_marketsLists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
twitch.tv/list_top_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_coinsGets the ranked AI models of an LMArena (Arena) leaderboard with scores, confidence intervals, votes, organizations, licenses and the date the leaderboard was last updated.
arena.ai/get_leaderboardLists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
similarweb.com/list_top_websites