CoinMarketCap API: Get coin price
Gets 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.
Unofficial. Not affiliated with or endorsed by CoinMarketCap.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Coin, required
coin Cryptocurrency name or symbol, such as Bitcoin or ETH.
ETH
- Currency optional
currency Currency name or code for prices and monetary values, such as Euro or EUR. Defaults to USD.
Euro
Default
USD.
Input as JSON
{ "coin": "ETH", "currency": "Euro"}Output
{ "link": "https://coinmarketcap.com/currencies/ethereum/" , "name": "Ethereum", "rank": 2, "slug": "ethereum", "price": 2144.2897863674384, "symbol": "ETH", "currency": "EUR", "market_cap": 261936501389.05014, "volume_24h": 10628539689.816965, "last_updated": "2026-10-23T07:20:00.000Z", "maximum_supply": null, "coinmarketcap_id": 1027, "change_1h_percent": -0.017174, "change_7d_percent": -1.861411, "all_time_high_date": "2025-08-24", "change_24h_percent": -0.669346, "circulating_supply": 122155364.9391704, "all_time_high_price": 4424.1640040879465}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"coinmarketcap.com/get_coin_price","input":{"coin":"ETH","currency":"Euro"}}' # 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/get_coin_price" , "input": { "coin": "ETH", "currency": "Euro" }})# 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/get_coin_price" , "input": { "coin": "ETH", "currency": "Euro" } }), 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/get_coin_price# with {"coin":"ETH","currency":"Euro"}"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", "required": [ "coin" ], "properties": { "coin": { "type": "string", "description": "Cryptocurrency name or symbol, such as Bitcoin or ETH." }, "currency": { "type": "string", "default": "USD", "description": "Currency name or code for prices and monetary values, such as Euro or EUR. Defaults to USD." } }}Output schema
{ "type": "object", "required": [ "name", "symbol", "rank", "price", "currency", "change_1h_percent", "change_24h_percent", "change_7d_percent", "market_cap", "volume_24h", "circulating_supply", "maximum_supply", "all_time_high_price", "all_time_high_date", "last_updated", "link", "coinmarketcap_id", "slug" ], "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "rank": { "type": [ "integer", "null" ] }, "slug": { "type": "string" }, "price": { "type": "number" }, "symbol": { "type": "string" }, "currency": { "type": "string" }, "market_cap": { "type": [ "number", "null" ] }, "volume_24h": { "type": [ "number", "null" ] }, "last_updated": { "type": "string", "format": "date-time" }, "maximum_supply": { "type": [ "number", "null" ] }, "coinmarketcap_id": { "type": "integer" }, "change_1h_percent": { "type": [ "number", "null" ] }, "change_7d_percent": { "type": [ "number", "null" ] }, "all_time_high_date": { "type": [ "string", "null" ], "format": "date" }, "change_24h_percent": { "type": [ "number", "null" ] }, "circulating_supply": { "type": [ "number", "null" ] }, "all_time_high_price": { "type": [ "number", "null" ] } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
coinmarketcap.com/get_coin_price- Returns
- name, symbol, rank, price, changes, market cap, volume, supply, all-time high, last update, 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/get_coin_price with the inputs above.
Ask your agent
- What is Bitcoin trading at right now in US dollars?
- price of ETH in euros with market cap and circulating supply
- Solana current price, 24h change and all-time high in Japanese yen
- how much is Dogecoin worth today, and what's its trading volume?
- check coinmarketcap for the live Cardano price in British pounds
See more
All CoinMarketCap methodsLists 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_coinsReturns 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_indexLists 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_losersLooks up a cryptocurrency's current Coinbase spot, buy and sell prices in a chosen currency.
coinbase.com/get_coin_priceGets a cryptocurrency's price, 24-hour change, market statistics, popularity, tradability, description and website from its public Coinbase price page.
coinbase.com/get_coin_overviewGets a Binance spot pair's latest price and rolling 24-hour trading statistics from a coin name or symbol. Only currently trading pairs are available.
binance.com/get_coin_priceGets 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_dateGets a coin's current Kraken price, bid and ask, and 24-hour trading statistics in a chosen currency, with change since today's midnight UTC open.
kraken.com/get_coin_price