Spot & Perp Quotes

Spot 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 datamarket_quotesGET /market/quotesx402 · $0.01 / callRead-onlyMCP App

What it does

Per-coin market snapshot (spot price, perpetual mark price, 24h change, funding rate, open interest, long/short ratio, 24h liquidations), merged across providers. Spot and perp prices are separate fields (spot from spot-market providers, perp mark from the perp venue); they differ by the basis. Pass 'symbols' to filter to specific coins; omit it for every covered coin.

Parameters

Name	Type	Description
`symbols`query	string[]	Coin symbols to include, e.g. ["BTC","ETH"]. Omit for all covered coins.

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/quotes?symbols=BTC,ETH,SOL" \
  -H "Authorization: Bearer $F1OW_API_KEY"

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "market_quotes",
    "arguments": {
      "symbols": [
        "BTC",
        "ETH",
        "SOL"
      ]
    }
  }
}

const res = await fetch("https://mcp.f1ow.com/v1/market/quotes?symbols=BTC,ETH,SOL", {
  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/quotes?symbols=BTC,ETH,SOL",
    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_quotes",
    "arguments": {
      "symbols": [
        "BTC",
        "ETH",
        "SOL"
      ]
    }
  }
}

// Or push a fresh result whenever it changes (minimum interval 15 s)
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "subscriptions/subscribe",
  "params": {
    "name": "market_quotes",
    "arguments": {
      "symbols": [
        "BTC",
        "ETH",
        "SOL"
      ]
    },
    "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/quotes?symbols=BTC,ETH,SOL"

Sample response

A real response captured 2026-11-13. Interactive is the tool's MCP App rendering it, as Claude, ChatGPT and other MCP Apps hosts show it; here it is read-only. 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.

Loading interactive view…

BTC: spot $68591.00 | perp $68654.00 | 24h -6.80% | mcap $1.38T | funding +0.0002% | OI $47.73B | L/S 3.32 | liq 24h $918.62M
ETH: spot $1933.15 | perp $1935.30 | 24h -5.70% | mcap $236.20B | funding -0.0003% | OI $23.84B | L/S 3.73 | liq 24h $287.68M
SOL: spot $79.8200 | perp $79.9530 | 24h -3.75% | mcap $47.19B | funding -0.0006% | OI $4.75B | L/S 3.44 | liq 24h $57.75M

{
  "quotes": [
    {
      "fundingRatePct": 0.0002105,
      "liquidation24hUsd": 918621983.506613,
      "longShortRatio24h": 3.32,
      "marketCapUsd": 1379122275188,
      "openInterestUsd": 47725277621.5434,
      "perpPriceUsd": 68654,
      "priceChangePct24h": -6.79676,
      "priceUsd": 68591,
      "spotPriceUsd": 68591,
      "symbol": "BTC"
    },
    {
      "fundingRatePct": -0.000259375,
      "liquidation24hUsd": 287675173.946331,
      "longShortRatio24h": 3.73,
      "marketCapUsd": 236200313080,
      "openInterestUsd": 23840041160.8518,
      "perpPriceUsd": 1935.3,
      "priceChangePct24h": -5.70444,
      "priceUsd": 1933.15,
      "spotPriceUsd": 1933.15,
      "symbol": "ETH"
    },
    {
      "fundingRatePct": -0.000615,
      "liquidation24hUsd": 57752900.9362416,
      "longShortRatio24h": 3.44,
      "marketCapUsd": 47187721491,
      "openInterestUsd": 4747136219.8862,
      "perpPriceUsd": 79.953,
      "priceChangePct24h": -3.74663,
      "priceUsd": 79.82,
      "spotPriceUsd": 79.82,
      "symbol": "SOL"
    }
  ],
  "generatedAt": "2026-11-13T08:05:39.3218993+00:00"
}

Candlesmarket_candles

Spot 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.

Bulk Historymarket_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.

Market Overviewmarket_overview

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

Top Moversmarket_top_movers

The day's ranked gainers and losers, plus the quieter names already trending more than five percent.

Call Spot & Perp Quotes from your agent

Get an API key Browse tools

For agents: this page as Markdown · all docs