QUANT_API
UTCSign inGet a key ↗
POLYMARKET · ✓ LIVE

PM Flow Imbalance

Signed trade-flow imbalance.

polymarket.pm_flow_imbalance(buy − sell)/(buy + sell)Polymarket

What it measures

Signed trade-flow imbalance on Polymarket by aggressor side: (buy − sell) / (buy + sell), bounded in [−1, +1]. This is taker flow — participants paying the spread to get YES or NO exposure now — the prediction-market counterpart of order-flow imbalance on a crypto venue. Read it against the book imbalance: crossing flow expresses urgency, resting flow expresses patience.

References: PM trade flow aggressor side.

Point-in-time, leak-free

Like every QUANT_API feature, polymarket.pm_flow_imbalance is computed point-in-time: each value uses only data that had actually arrived at the timestamp you query — live or historical. No restatements, no backfills that quietly rewrite the past, no look-ahead. The value your backtest sees at a given stamp is the value the live API would have returned at that stamp. How we enforce this is documented on the methodology page.

Windows & transforms

The signal is computed over rolling windows; each window can be served raw or through a transform (z-score, percentile rank, delta…). Which windows and transforms you can query depends on your plan — the signal itself supports:

WINDOWS
5m15m1h4h24h
TRANSFORMS
leveldeltaratezscorepctrankewmaminmaxrange

Plan & access

polymarket.pm_flow_imbalance unlocks on the Signal plan ($99/mo) and every plan above it. Every new account starts with a 14-day free trial of the Signal plan — no card required.

Try it free →Compare plans

Example call

Resolve the latest value for BTC (5m window, delta transform — both available on the Signal plan):

curl -G https://api.quant-api.dev/v1/features/live \
  -H "Authorization: Bearer fk_live_<your_key>" \
  --data-urlencode "asset=BTC" \
  --data-urlencode "features=polymarket.pm_flow_imbalance@5m:delta"

Same key works on /v1/features/historical for point-in-time backtesting — see the API docs.

RELATED SIGNALS
PM Microprice (YES) polymarket.pm_micropricePM Spread (YES) polymarket.pm_spreadPM Book Imbalance (Top 5) polymarket.pm_imbalance_top5Guide: how this family trades in practiceRead ↗