Skip to main content
GET
Get All Positions
Designed for analytics and streaming use cases - backfill historical position data or stream new updates as they come in.
Free & Unlimited. This endpoint does not count toward your monthly usage limits on any plan.
Use min_block / max_block or min_timestamp / max_timestamp to scope your query, and pagination_key to page through results.

Authorizations

x-api-key
string
header
required

Query Parameters

order_by
enum<string>
default:block

Order by block number or timestamp

Available options:
block,
timestamp
order
enum<string>
default:desc

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

Available options:
asc,
desc
min_block
integer | null

Minimum block number (inclusive)

Required range: x >= 0
max_block
integer | null

Maximum block number (inclusive)

Required range: x >= 0
min_timestamp
integer | null

Minimum timestamp in Unix seconds (inclusive)

Required range: x >= 0
max_timestamp
integer | null

Maximum timestamp in Unix seconds (inclusive)

Required range: x >= 0
wallet
string | null

Filter by wallet address

token_id
string | null

Filter by token ID

condition_id
string | null

Filter by market condition ID

limit
integer
default:100

Maximum positions per page (1-500)

Required range: 1 <= x <= 500
pagination_key
string | null

Cursor for pagination

Response

Successful Response

Response for all-user positions endpoint.

positions
AllUsersPosition · object[]
required

Position records

pagination
CursorPagination · object
required

Cursor-based pagination for endpoints that don't support offset.