Coin Details
Price, market cap, all-time high and low, and the project's own description of itself.
What it does
Fetches price, market cap, ATH/ATL and description for a coin by its coin ID (e.g. 'bitcoin', 'ethereum') or by ticker symbol (e.g. 'BTC', 'WAVES'). IDs are case-sensitive; a symbol, or an ID in the wrong case, is resolved by search and the response names the ID actually fetched, so a resolution is never silent.
Parameters
| Name | Type | Description |
|---|---|---|
coin_idrequiredpath | string | Coin ID (e.g. 'bitcoin') or ticker symbol (e.g. 'BTC'). IDs are case-sensitive; symbols are resolved by search. |
Call it
One API key works for MCP, REST and WebSocket; each call uses one unit. Agents without an account can pay per call with x402.
curl "https://mcp.f1ow.com/v1/market/coins/bitcoin" \
-H "Authorization: Bearer $F1OW_API_KEY"{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "market_coin_details",
"arguments": {
"coin_id": "bitcoin"
}
}
}const res = await fetch("https://mcp.f1ow.com/v1/market/coins/bitcoin", {
headers: { Authorization: `Bearer ${process.env.F1OW_API_KEY}` },
});
const data = await res.json(); // the tool's result as JSON, typed in the OpenAPI spec
console.log(data);import os, requests
res = requests.get(
"https://mcp.f1ow.com/v1/market/coins/bitcoin",
headers={"Authorization": f"Bearer {os.environ['F1OW_API_KEY']}"},
)
data = res.json() # the tool's result as JSON, typed in the OpenAPI spec
print(data)// wss://mcp.f1ow.com/v1/ws — subprotocol "jsonrpc-2.0", Authorization: Bearer <key>
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "market_coin_details",
"arguments": {
"coin_id": "bitcoin"
}
}
}
// Or push a fresh result whenever it changes (minimum interval 15 s)
{
"jsonrpc": "2.0",
"id": 2,
"method": "subscriptions/subscribe",
"params": {
"name": "market_coin_details",
"arguments": {
"coin_id": "bitcoin"
},
"intervalSeconds": 60
}
}# No account: the first call answers 402 with a PAYMENT-REQUIRED challenge;
# an x402 client pays it in USDC on Base and retries.
curl "https://mcp.f1ow.com/x402/v1/market/coins/bitcoin"Sample response
A real response captured 2026-11-13. JSON is what REST and WebSocket return, and the structuredContent of an MCP call (trimmed for length), with generatedAt for freshness. Text is the report an MCP client hands to a model.
Bitcoin (BTC)
Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto. It enables peer-to-peer electronic cash transactions without intermediaries like banks or governments, operating on a blockchain secured by Proof of Work mining and the SHA-256 cryptographic algorithm.
With a fixed supply cap of 21 million coins and programmatic halvings every four ye...
Price: $68623.00 | 24h: -6.77% | MCap: $1.38T
ATH: $126080.00 | ATL: $67.8100
Homepage: http://www.bitcoin.org{
"athUsd": 126080,
"atlUsd": 67.81,
"change24hPct": -6.7651,
"description": "Bitcoin is the world's first decentralized cryptocurrency, created in 2009 by the pseudonymous Satoshi Nakamoto. It enables peer-to-peer electronic cash transactions without intermediaries like banks or governments, operating on a blockchain secured by Proof of Work mining and the SHA-256 cryptographic algorithm. \n\nWith a fixed supply cap of 21 million coins and programmatic halvings every four ye…",
"homepage": "http://www.bitcoin.org",
"id": "bitcoin",
"marketCapUsd": 1379930220362,
"name": "Bitcoin",
"priceUsd": 68623,
"symbol": "BTC",
"generatedAt": "2026-11-13T08:05:38.7785282+00:00"
}Related tools
market_quotesSpot and perp mark side by side, with funding, open interest, long/short ratio and the day's liquidations. Five providers merged into one snapshot, cached for thirty seconds.
market_candlesSpot or perpetual OHLCV candles with venue routing and fallback, for the timeframes your analysis needs. For months of paged candles or derivatives series, use Bulk History.
market_historyPaged spot/perp candles, aggregate open interest, funding or long/short liquidations. Up to 1,000 rows per call with a backward-page cursor, explicit time bounds and a forming-row flag — for historical research and backtests.
market_overviewThe global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.
Call Coin Details from your agent
Sign in, get an API key and make your first call in under a minute. No card required.
For agents: this page as Markdown · all docs