Order Management
Query your order history and cancel pending limit orders.
List 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
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}
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"
}
- BUY orders: Reserved cash is returned to your balance
- SELL orders: Reserved shares are returned to your position
Next Steps
