Skip to Content
f1owdocs
Tool reference

Market Overview

The global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.

Market datamarket_overviewGET /market/overviewx402 · $0.01 / callRead-only

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"
}

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

On this page