CoinMarketCap API: List top coins by market cap
Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
Unofficial. Not affiliated with or endorsed by CoinMarketCap.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Currency optional
currency Currency name or code for prices, market caps, and volumes. Example: Euro or EUR.
USD
Default
USD.- Max Results optional
max_results Maximum number of ranked coins to return, from 1 to 200.
20
Whole number from 1 to 200. Default
20.
Input as JSON
{ "currency": "USD", "max_results": 20}Output
{ "coins": [ { "name": "Bitcoin", "rank": 1, "price": 81746.0357327227, "symbol": "BTC", "market_cap": 1643282271411.447, "volume_24h": 27239840632.650894, "change_7d_percent": -0.42740148, "change_24h_percent": -0.29555307, "circulating_supply": 20102287, "coinmarketcap_link": "https://coinmarketcap.com/currencies/bitcoin/" }, { "name": "Ethereum", "rank": 2, "price": 2407.0651739479576, "symbol": "ETH", "market_cap": 294035924755.98047, "volume_24h": 11671629104.57986, "change_7d_percent": -1.80385028, "change_24h_percent": -0.28758248, "circulating_supply": 122155364.9391704, "coinmarketcap_link": "https://coinmarketcap.com/currencies/ethereum/" }, { "name": "Tether USDt", "rank": 3, "price": 0.9986155756513813, "symbol": "USDT", "market_cap": 182473160113.14856, "volume_24h": 58522545534.190285, "change_7d_percent": -0.01105512, "change_24h_percent": -0.02222513, "circulating_supply": 182726130617.5043, "coinmarketcap_link": "https://coinmarketcap.com/currencies/tether/" } ], "currency_code": "USD"}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"coinmarketcap.com/list_top_coins","input":{"currency":"USD","max_results":20}}' # 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": "coinmarketcap.com/list_top_coins" , "input": { "currency": "USD", "max_results": 20 }})# 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": "coinmarketcap.com/list_top_coins" , "input": { "currency": "USD", "max_results": 20 } }), 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 coinmarketcap.com/list_top_coins# with {"currency":"USD","max_results":20}"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", "description": "Currency name or code for prices, market caps, and volumes. Example: Euro or EUR." }, "max_results": { "type": "integer", "default": 20, "maximum": 200, "minimum": 1, "description": "Maximum number of ranked coins to return, from 1 to 200." } }}Output schema
{ "type": "object", "required": [ "currency_code", "coins" ], "properties": { "coins": { "type": "array", "items": { "type": "object", "required": [ "rank", "name", "symbol", "coinmarketcap_link" ], "properties": { "name": { "type": "string" }, "rank": { "type": "integer" }, "price": { "type": [ "number", "null" ] }, "symbol": { "type": "string" }, "market_cap": { "type": [ "number", "null" ] }, "volume_24h": { "type": [ "number", "null" ] }, "change_7d_percent": { "type": [ "number", "null" ] }, "change_24h_percent": { "type": [ "number", "null" ] }, "circulating_supply": { "type": [ "number", "null" ] }, "coinmarketcap_link": { "type": "string" } } } }, "currency_code": { "type": "string" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
coinmarketcap.com/list_top_coins- Returns
- rank, name, symbol, price, 24h/7d change, market cap, volume, supply, 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 coinmarketcap.com/list_top_coins with the inputs above.
Ask your agent
- Show me the 15 largest cryptocurrencies by market cap priced in Euros, with 24h and 7d changes
- What are the top 50 coins ranked by market cap in USD right now?
- Give me a ranked list of the biggest crypto assets on CoinMarketCap with their circulating supply and 24-hour trading volume
- I need the top 10 coins by market capitalization in Japanese Yen, including prices and weekly percentage moves
- Which cryptocurrencies rank highest by market cap today? List around 100 with symbols and links to their pages
See more
All CoinMarketCap methodsGets 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 the largest price rises and falls among CoinMarketCap's top 100 coins with over $50,000 in 24-hour volume, for a chosen period.
coinmarketcap.com/list_gainers_and_losersReturns the current crypto Fear and Greed Index with yesterday, last week and last month comparisons, plus total crypto market size, BTC and ETH dominance from CoinMarketCap.
coinmarketcap.com/get_fear_and_greed_indexRanks public companies worldwide, or by country and industry, by market cap, revenue, earnings, employees or dividend yield. When both a country and an industry are set, the industry ranking order is kept and only companies from that country are shown.
companiesmarketcap.com/list_largest_companiesLists 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_coinsLists DefiLlama stablecoins ranked by circulating supply in US dollars. Each coin comes with its peg, price, weekly supply change and chain count. You can filter by peg.
defillama.com/list_stablecoinsGets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.
coinbase.com/get_coin_overviewLists 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_categories