Ranked entities with filters
Entities ranked by PnL. Unbought entities appear as handles with their unlock price (revealCents). No key: 20-row sample. With a key: up to 200 rows a call; each call spends limit rows of a 20,000/day allowance (403 when used up). mine=1 lists your unlocked addresses, free. Never charges.
Query parameters
Window id from GET /v1/periods (30d or 7d). Default 30d. Unknown → 400.
Order column. Default realizedPnl; an unknown value falls back to realizedPnl.
Allowed values: realizedPnlroiOnBuyseligiblewinsLossesnFillsconditionsgrossBuyUsdcunrealizedPnlwinLofillsPerDaylastFill
Sort direction. Anything other than asc means desc.
Allowed values: ascdesc
Rows to return, 1-200 (anonymous capped to 20). Out of range → 400. With a key this many rows are taken from the daily allowance, whether or not that many come back.
Allowed range: 1 <= x <= 200
Rows to skip, 0-100000 (anonymous forced to 0).
Allowed range: 0 <= x <= 100000
Set to 1 to list only the addresses you have unlocked (needs a key; 401 without). Spends no row allowance; minEligible defaults to 0.
Allowed values: 1
Floor on settled markets (wins + losses + breakevens). Default 5.
Allowed range: 0 <= x <= 100000
Floor on markets won or lost (breakevens excluded). Absent = no floor; the website uses 10.
Allowed range: 0 <= x <= 100000
Floor on realised PnL, dollars. May be negative.
Allowed range: -1000000000000 <= x <= 1000000000000
Floor on ROI on buys (0.2 = 20%).
Allowed range: -100 <= x <= 1000000
Floor on the Wilson 95% lower bound of the win rate.
Allowed range: 0 <= x <= 1
Ceiling on addresses of the entity that traded in the window (1 = single address).
Allowed range: 1 <= x <= 100000
Floor on fills in the window.
Allowed range: 0 <= x <= 1000000000000
Floor on dollars spent buying in the window (grossBuyUsdc).
Allowed range: 0 <= x <= 1000000000000000
Last fill <24h (active), <7d (quiet), older (dormant).
Allowed values: activequietdormant
By share of traded value made as maker: >=0.8 maker, <=0.2 taker, else two-sided.
Allowed values: makertakertwo-sided
Entities that traded this category in the window.
Allowed values: crypto-updowncryptoesportssportspoliticseconomygeopoliticsscience-techcultureotherunknown
With category only (400 otherwise): at least this share (0, 1] of traded value in that category.
Allowed range: x <= 1
Unlock price bands, any of them, comma-separated (0 = free … 5). Priced on the 30d window whatever period is.
Response
anon = no valid key; subscriber = an active push subscription or active plan.
Allowed values: anonfreesubscriber
The caller's plan and what is left of its unlock allowance (present when signed in).
true for the anonymous 20-row sample.
The filters actually applied.
Allowed values: realizedPnlroiOnBuyseligiblewinsLossesnFillsconditionsgrossBuyUsdcunrealizedPnlwinLofillsPerDaylastFill
Allowed values: ascdesc
First UTC day of the ledger behind this window.
Entities in the window (independent of filters). With mine=1: how many addresses you have unlocked.
mine=1, first page only: your unlocked addresses with no fill in this window.
Responses
message names what was expected.retry-after header may be set.