Market snapshot

One call, every pair: price, 24h change, rolling volumes and their growth, volatility, taker delta, trade counts, funding and BTC correlation, recomputed every 10 seconds.

GET/v1/market

GET/v1/market/{symbol}

The market snapshot is the workhorse endpoint: a compact pre-computed summary of the entire futures universe, rebuilt every 10 seconds by the metrics engine. When you need "the state of everything right now" (for a dashboard grid, a scanner pass, or feature vectors across all pairs), one snapshot call replaces hundreds of per-symbol requests.

/v1/market returns the full map keyed by symbol; /v1/market/{symbol} returns a single pair's row (same shape, wrapped with the symbol and timestamp). The asOf field is the engine's rebuild timestamp. If you cache, key on it: a new asOf means new data, an unchanged one means the snapshot hasn't rolled yet.

Request

Parameter	In	Description
`exchange`	query	Venue whose board to read. See Exchanges. Default: Binance.

One pair

curl "https://osiristrader.com/api/v1/market/ETHUSDT?exchange=bybit" \
  -H "Authorization: Bearer osk_YOUR_KEY"

Response

{
  "symbol": "ETHUSDT",
  "asOf": 1783877000000,
  "data": {
    "price": 1818.6,
    "change": 0.39,
    "funding": 0.0000531,
    "apr": 5.84,
    "corr": 0.91,
    "vol":    { "m15": 5391077, "h1": 19404225, "h24": 5492748757, "grow": 1.08 },
    "natr":   { "m1": 0.031, "m5": 0.097 },
    "delta":  { "m5": -140020, "h1": -876783 },
    "trades": { "h1": 66760, "h24": 1587549, "grow": 1.03 }
  }
}

Field reference

Field	Description
`price`	Last traded price.
`change`	24-hour price change, percent.
`funding`	Current (predicted) funding rate as a decimal: `0.0001` is the standard 0.01% baseline. See Funding for the full picture.
`apr`	That funding rate annualized at the pair's payment interval, percent: the cost/yield of holding the position for a year at today's rate.
`corr`	Pearson correlation of the pair's recent returns with BTCUSDT. Near 1 = moves with bitcoin; near 0 = trades its own story, usually pair-specific news or flow.
`vol.m15 / h1 / h24`	USDT quote volume over the trailing 15 minutes / hour / 24 hours.
`vol.grow`	Current volume pace vs its own recent average (1.0 = normal, 2.0 = double). The quickest "is something happening here" flag in the snapshot.
`natr.m1 / m5`	Normalized ATR on 1-minute and 5-minute bars, percent of price: realized volatility at scalping horizons, comparable across pairs of any price.
`delta.m5 / h1`	Net taker flow in USDT over 5 minutes / 1 hour: taker buys minus taker sells. Positive = aggressive buying; the sign and trend matter more than the absolute number.
`trades.h1 / h24`	Trade counts over the trailing hour / 24 hours.
`trades.grow`	Trade-count pace vs recent average. Rising trade count with flat volume = smaller orders (retail); the reverse = larger orders (size stepping in).

Usage patterns

Scanner pass: pull /v1/market, filter client-side (e.g. vol.grow > 2 and natr.m5 > 0.3), then deep-dive survivors with Metrics and Levels. Two requests plus one per candidate.
Dashboard grid: poll the full snapshot every 10 s (matching its rebuild cadence) and diff asOf to skip no-op renders.
Cross-sectional features: the snapshot is a ready-made feature matrix (527 pairs × 14 numbers) refreshed every 10 s; many quant users store it as a time series and never touch per-symbol endpoints.

If what you actually want is the market page's aggregates (breadth, fear & greed, dominance, top gainers), that's the Market overview endpoint, which computes them for you from this same snapshot.

Candles

Market overview