Sign in
Large Positions

List large positions

Returns the largest current open positions from graded traders, value-descending, with opaque cursor pagination. Polymarket-only by design: the large-positions scanner filters platform = 'polymarket' (backend/src/large_positions/scanner.rs:238,245), so no Kalshi rows are ever scanned and a Kalshi or unknown condition_id filter returns an empty list (never fabricated rows). The teaser cap that the internal product UI applies to anonymous viewers does not apply here: the API key already proves an active insider/annual subscription, so authed API callers get full access.

get/api/v1/large-positions

Query parameters

limitinteger
cursorstring

Opaque pagination cursor from a previous response.

min_sizenumber

Minimum position value in USD.

categorystring

Filter by provider-backed market category.

min_grade'S' | 'A' | 'B' | 'C' | 'D' | 'F'

Minimum trader grade.

condition_idstring

Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Polymarket-only; a Kalshi or unknown id returns [].

Response

Large positions list

object'list' required
has_moreboolean required
next_cursorstring nullable

Opaque cursor for the next page; absent on the last page.

totalinteger nullable

Total ranked rows when the read model exposes a count; may be absent.

Changes