Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get All Positions

Fetch all user positions with filtering and pagination.

Designed for analytics and streaming use cases where clients need to:

  • Backfill historical position data
  • Stream new position updates as they come in

Use min_block to start from a specific block (for backfill). Use order=asc to get oldest first (for streaming/backfill). Use order=desc to get latest first (for recent data).

The pagination cursor encodes the last position's block/timestamp and IDs, allowing efficient continuation from any point.

get/v2/polymarket/positions

Query parameters

order_by'block' | 'timestamp'

Order by options for all-user positions streaming endpoint.

Order by block number or timestamp

order'asc' | 'desc'

Sort order direction enum.

Sort order (desc for latest first, asc for streaming from oldest)

min_blockinteger nullable

Minimum block number (inclusive)

Minimum block number (inclusive)

max_blockinteger nullable

Maximum block number (inclusive)

Maximum block number (inclusive)

min_timestampinteger nullable

Minimum timestamp in Unix seconds (inclusive)

Minimum timestamp in Unix seconds (inclusive)

max_timestampinteger nullable

Maximum timestamp in Unix seconds (inclusive)

Maximum timestamp in Unix seconds (inclusive)

walletstring nullable

Filter by wallet address

Filter by wallet address

token_idstring nullable

Filter by token ID

Filter by token ID

condition_idstring nullable

Filter by market condition ID

Filter by market condition ID

limitinteger

Maximum positions per page (1-500)

Maximum positions per page (1-500)

pagination_keystring nullable

Cursor for pagination

Cursor for pagination

Response

Successful Response