Skip to main content
GET
GET /v2/data/combos/stats: Combo Stats
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
Answers are cached per window for 60 seconds; a cached answer’s window.end is the time it was computed.
window=all (the default) scans the whole tape. A cold call can take tens of seconds, once per cache period. Pass a bounded window or explicit start_time / end_time when latency matters.

Query Parameters

string
default:"all"
Rolling window ending now. One of 24h, 7d, 30d, all. Ignored when start_time or end_time is given.
string
Explicit window start. ISO-8601, or epoch seconds / milliseconds.
string
Explicit window end. Same formats as start_time.

Response

string
Always polymarket.
object
start (ISO-8601 or null for all time) and end (ISO-8601) actually used.
string
Sum of taker notional in the window, decimal string.
integer
Settlements (taker fills) in the window.
integer
Distinct taker wallets.
integer
Distinct combos traded.
string | null
total_volume / total_trades. null when there are no trades.
string | null
Mean leg count over the combos traded in the window, one weight per combo (a 2-leg combo with a hundred settlements weighs the same as a 10-leg combo with one).
object | null
The settlement with the highest notional, as a ComboTrade.
object
Combos traded in the window, by their resolution now: win, loss, partial, unresolved.
object
Taker-side PnL on resolved combos: resolved_trades (integer) and total (decimal string).
array
The ten underlying markets that appear most often as legs of combos traded in the window. Each: condition_id, question, slug, combo_count, trade_count.

Errors

Example