Market Overview
The global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.
What it does
Global market snapshot: total market cap, BTC/ETH dominance, Fear & Greed index, and Altcoin Season index
Parameters
None — call it with empty arguments.
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/overview" \
-H "Authorization: Bearer $F1OW_API_KEY"{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "market_overview",
"arguments": {}
}
}const res = await fetch("https://mcp.f1ow.com/v1/market/overview", {
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/overview",
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_overview",
"arguments": {}
}
}
// Or push a fresh result whenever it changes (minimum interval 15 s)
{
"jsonrpc": "2.0",
"id": 2,
"method": "subscriptions/subscribe",
"params": {
"name": "market_overview",
"arguments": {},
"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/overview"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.
=== Global Market Overview ===
Total Market Cap: $2.31T
24h Volume: $95.10B
BTC Dominance: 59.64%
ETH Dominance: 10.21%
Fear & Greed: 20/100 — Extreme Fear
Altcoin Season Index: 47/100 — Neutral{
"altcoinSeasonIndex": 47,
"btcDominancePct": 59.637379558453,
"ethDominancePct": 10.214333791008,
"fearGreedLabel": "Extreme Fear",
"fearGreedValue": 20,
"totalMarketCapUsd": 2313671494496.61,
"totalVolume24hUsd": 95103917342.86,
"generatedAt": "2026-11-13T08:05:38.6753119+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_top_moversThe day's ranked gainers and losers, plus the quieter names already trending more than five percent.
Call Market Overview 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
Bulk History
Paged 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.
Top Movers
The day's ranked gainers and losers, plus the quieter names already trending more than five percent.