v25

OpenAPI 3.1.0raw.githubusercontent.com2026-08-015486519.4 KB

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/crates/large-positions/src/scanner.rs), 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 Pro subscription (wire tier insider), 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

One RFC 4180 CSV record of exact current provider-backed market_canonical.category values. Legacy unquoted lists such as NBA,WNBA remain valid; values containing commas, quotes, or newlines are CSV-quoted. Matching is case-insensitive. Malformed quoted input fails closed as one unknown exact 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.