# Spot & Perp Quotes (`market_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.

- Category: Market data
- MCP tool: `market_quotes`
- REST: `GET /market/quotes`
- MCP App: hosts that support MCP Apps render the result as an interactive view
- x402 price: $0.01 per call (USDC on Base)
- HTML: https://www.f1ow.com/docs/tools/market_quotes

## 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 | In | Required | Description |
| --- | --- | --- | --- | --- |
| `symbols` | string[] | query | no | Coin symbols to include, e.g. ["BTC","ETH"]. Omit for all covered coins. |

## Call it

### cURL

```bash
curl "https://mcp.f1ow.com/v1/market/quotes?symbols=BTC,ETH,SOL" \
  -H "Authorization: Bearer $F1OW_API_KEY"
```

### MCP

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

### TypeScript

```ts
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);
```

### Python

```python
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)
```

### WebSocket

```jsonc
// 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
  }
}
```

### x402

```bash
# 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

Captured 2026-11-13. The JSON is what REST and WebSocket return and the `structuredContent` of an MCP call (trimmed):

```json
{
  "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"
}
```

Over MCP the text report a model reads comes with it:

```text
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
```

## Related tools

- [Candles](https://www.f1ow.com/docs/tools/market_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 History](https://www.f1ow.com/docs/tools/market_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 Overview](https://www.f1ow.com/docs/tools/market_overview) — The global frame in one read: total market cap, BTC and ETH dominance, Fear & Greed, Altcoin Season.
- [Top Movers](https://www.f1ow.com/docs/tools/market_top_movers) — The day's ranked gainers and losers, plus the quieter names already trending more than five percent.