Positions
Authentication
API key only —X-API-Key: <key> (or the PM-compat POLY_API_KEY /
Authorization: Bearer ps_live_... aliases). A Supabase Bearer JWT is not
accepted here.
Query Parameters
This endpoint is unpaginated — there is no
limit/offset. It returns
every matching position in one response. For paginated results use
Trade History. Polymarket’s status=ALL has no
direct equivalent — simply omit status to get the unfiltered set.Request
Response
With
envelope=true the same rows are wrapped Polymarket-style:
Python Example
Position Lifecycle
A position closed byPOST /v1/account/reset-api-balance carries the
CLOSED_BY_RESET status. The status=CLOSED filter surfaces both CLOSED
and CLOSED_BY_RESET positions.
Errors
All errors return{"error": "<CODE>", "message": "<human-readable>"}.
Next Steps
- Portfolio — Aggregate view with balance + positions
- Equity Curve — Track value over time