Order Management

List, filter, and cancel pending orders with pagination.

Order Management

Query your order history and cancel pending limit orders.

---

List Orders

GET /v1/orders

Supports both offset and cursor-based pagination.

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter: PENDING, FILLED, CANCELLED, EXPIRED
market_id	string	—	Filter by condition_id
side	string	—	Filter: BUY, SELL
limit	int	50	Max results (1–200)
offset	int	0	Pagination offset
cursor	int	—	Cursor-based pagination (preferred for bots)

Examples

Offset Pagination

curl -H "X-API-Key: $API_KEY" \
  "https://api.polysimulator.com/v1/orders?status=PENDING&limit=20&offset=0"

Response

{
  "orders": [
    {
      "order_id": 15,
      "market_id": "0x1a2b3c...",
      "side": "BUY",
      "outcome": "Yes",
      "order_type": "limit",
      "limit_price": "0.60",
      "quantity": "10.0",
      "time_in_force": "GTC",
      "status": "PENDING",
      "client_order_id": "limit-001",
      "created_at": "2026-02-06T12:00:00Z",
      "filled_at": null,
      "fill_price": null,
      "cancelled_at": null
    }
  ],
  "next_cursor": "22",
  "has_more": true
}

Use cursor-based pagination for bots. It’s more efficient and avoids issues with page drift when new orders arrive between requests.

---

Cancel Order

DELETE /v1/orders/{order_id}

Cancel a pending limit order. Only PENDING orders can be cancelled.

curl -X DELETE -H "X-API-Key: $API_KEY" \
  https://api.polysimulator.com/v1/orders/42

Response

{
  "order_id": 42,
  "status": "CANCELLED",
  "order_type": "limit",
  "side": "BUY",
  "outcome": "Yes",
  "price": "0.60",
  "quantity": "10.0",
  "notional": "6.00",
  "fee": "0"
}

Cancellation returns reserved funds:

• BUY orders: Reserved cash is returned to your balance
• SELL orders: Reserved shares are returned to your position

---

Next Steps

• Batch Orders — Place multiple orders at once
• Trade History — View filled orders