Positions
List current positions (positions-board feed)
Returns the current positions-board feed backed by the wallet_positions mirror. Ordered by current_value_usd DESC with deterministic (wallet, condition_id, outcome_index) tiebreakers. Pre-reconcile rows (current_value_usd IS NULL) are excluded. Cursor-paginated. Every filter pushes into SQL.
get/api/v1/positions
Query parameters
limitinteger
cursorstring
Pagination cursor from previous response's next_cursor.
min_sizenumber
Minimum current position value in USD.
categorystring
Exact match against provider-backed market_canonical.category.
min_grade'S' | 'A' | 'B' | 'C' | 'D' | 'F'
Minimum trader grade allowlist. A matches S and A; B matches S, A, B; etc.
side'yes' | 'no'
Filter by the binary outcome side. yes maps to outcome_index=0, no to outcome_index=1.
Headers
If-None-Matchstring
Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.
Response
Page of positions