Skip to main content
GET
Get biggest open positions leaderboard
Returns the largest currently open position lines across all markets, ranked by position size in collateral. Each entry pins the market it belongs to. Public — no authentication required.
Rankings are computed from a live projection maintained by a dedicated worker. Successful responses include a strong ETag; pass it back as If-None-Match to get 304 Not Modified while the projection is unchanged.

State field

Every response carries a state. Treat it as the readiness signal: For live refresh, subscribe to the unrealizedPnlProjectionChanged WebSocket event for the BIGGEST_POSITIONS scope and refetch this endpoint when a hint arrives.

Query Parameters

limit
integer
default:20

Number of position lines to return (1-50).

Required range: 1 <= x <= 50

Response

Ranked biggest open positions

schemaVersion
enum<integer>
required
Available options:
1
state
enum<string>
required

Readiness of the underlying projection. READY is a complete, current snapshot. BUILDING means the projection is being rebuilt and data is empty. STALE and DEGRADED return the last complete snapshot with Cache-Control: no-store; callers should retry shortly.

Available options:
BUILDING,
DEGRADED,
READY,
STALE
scope
enum<string>
required
Available options:
BIGGEST_POSITIONS
limit
integer
required
Required range: 1 <= x <= 50
data
object[]
required
projectionVersion
string | null
scopeVersion
string | null
presentationVersion
string | null
asOf
string<date-time> | null
markAsOf
string<date-time> | null
staleReason
string | null
collateralToken
object | null