List Orders

List pending, filled, and cancelled limit orders.

Supports both offset and cursor-based pagination:

• Offset: Use limit + offset query params.
• Cursor: Use the next_cursor value from a previous response as the cursor query param for the next page. Cursor pagination is preferred for bots that iterate through large result sets.

GET /v1/orders

List Orders

cURL

curl --request GET \
  --url https://staging-api.polysimulator.com/v1/orders \
  --header 'X-API-Key: <x-api-key>'

200

{
  "orders": [
    {
      "order_id": 123,
      "market_id": "<string>",
      "side": "<string>",
      "outcome": "<string>",
      "order_type": "<string>",
      "limit_price": "<string>",
      "quantity": "<string>",
      "time_in_force": "<string>",
      "status": "<string>",
      "client_order_id": "<string>",
      "created_at": "<string>",
      "filled_at": "<string>",
      "fill_price": "<string>",
      "cancelled_at": "<string>"
    }
  ],
  "next_cursor": "<string>",
  "has_more": false,
  "total_hint": 123
}

Headers

X-API-Key · string · required

Your PolySimulator API key

Query Parameters

status · string | null

market_id · string | null

side · string | null

limit · integer · default: 50

offset · integer · default: 0

cursor · string | null

Response

200

application/json

Successful Response

Paginated response with cursor for efficient iteration.

orders · PendingOrderItem · object[] · required

Show child attributes

next_cursor · string | null

has_more · boolean · default: false

total_hint · integer | null