Biggest Open Positions
Live leaderboard of the largest currently open position lines across all markets, ranked by position size. Public - no authentication required.
Responses are served from a live Redis projection with ETag support and short client cache. When the projection is still being rebuilt, callers may receive a BUILDING, STALE, or DEGRADED snapshot with Cache-Control: no-store and (for BUILDING) an empty data array - retry after a short delay.
ETag; pass it back as If-None-Match to get 304 Not Modified while the projection is unchanged.State field
Every response carries astate. Treat it as the readiness signal:
unrealizedPnlProjectionChanged WebSocket event for the BIGGEST_POSITIONS scope and refetch this endpoint when a hint arrives.Query Parameters
Number of position lines to return (1-50).
1 <= x <= 50Response
Ranked biggest open positions
1 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.
BUILDING, DEGRADED, READY, STALE BIGGEST_POSITIONS 1 <= x <= 50