Every perpetual contract is a pair: one long, one short. Open interest (OI) counts how many of those pairs are currently open. Price tells you where the market went; open interest tells you whether money entered or left on the way there. The same candle can mean opposite things depending on what OI did underneath it — and open interest divergence, where price pushes to a new extreme while OI falls, is one of the most readable positioning tells in crypto.

The four price/OI states

Price up, OI up — new longs are initiating. The move is backed by fresh capital and can persist, but it gets more crowded with every bar.
Price up, OI down — shorts are covering. Nobody new is buying the rally; existing positions are closing. Closing flow is finite, so the move is fragile by construction.
Price down, OI up — new shorts are initiating. Fresh conviction on the downside, and fresh fuel for a squeeze if price refuses to break.
Price down, OI down — longs are exiting or being liquidated. The flush removes leverage; when OI stops falling, the forced selling is largely spent.

The divergence cases are the second and fourth rows: price moving while open interest drains. A short-covering rally looks identical to genuine accumulation on a price chart — and completely different in OI. Because closing flow exhausts itself (once the shorts are out, that bid disappears), divergence is a statement about how much is left in the tank, not about direction alone.

Reading it with real signals

QUANT_API serves open interest as positioning.oi_usdtm (USDT-margined perps across Binance, Bybit and OKX) and positioning.oi_hl (Hyperliquid). The addressing scheme does the rest: positioning.oi_usdtm@30m:delta is the 30-minute change in OI, and positioning.oi_usdtm@1h:zscore asks whether the current build-up is unusual for this asset. Cross it with funding.funding_avg to see who is paying to hold the lean, and with positioning.lsr_top or positioning.taker_ratio to see which cohort is doing the work. The catalog also lists a packaged positioning.oi_price_divergence signal alongside them — browse the full positioning set in the catalog.

Price up while positioning.oi_usdtm@30m:delta is negative → covering rally; the buyer is temporary, treat strength with suspicion.
Price up, OI delta positive, funding.funding_avg@1h climbing → real but increasingly crowded trend; squeeze risk compounds with every funding print.
Price flat while OI rises fast → positions stacking without resolution; the eventual break inherits all of that stored leverage.
Price down, OI delta deeply negative, liquidations.liq_imbalance@15m long-skewed → forced deleveraging — the setup the cascade-reversal playbook trades.

◆

Open interest is one of the easiest series to leak. Venues restate OI snapshots, backfill gaps and revise prints — so a backtest run against today's copy of the history quietly knows things the live system did not. Every QUANT_API value, live or historical, is computed strictly from data with ts <= as_of: the OI your backtest reads at a timestamp is the OI that was actually knowable then.

bash

# Price/OI divergence snapshot for BTC: level, 30-minute change, and context
curl -s -G https://api.quant-api.dev/v1/features/live \
  -H "Authorization: Bearer fk_live_<secret>" \
  --data-urlencode "asset=BTC" \
  --data-urlencode "features=positioning.oi_usdtm@1h:level,positioning.oi_usdtm@30m:delta,positioning.oi_hl@30m:delta,funding.funding_avg@1h:level,positioning.lsr_top@1h:level"

To study divergence historically, post your decision timestamps to POST /v1/features/historical — one row per asset/as_of pair — and the same addresses come back resolved point-in-time at each instant, ready for POST /v1/backtest. Positioning and funding are Pro-tier categories, unlocked from the Edge plan upward; plan limits are on pricing and the request shapes are in the docs.

Start free — 14-day Signal trial, no card ↗