Skip to main content
Retrieve a list of limit orders associated with your account. By default, only open orders are returned. Use the query parameters to filter by market, event, currency mode, status, or order side. This is also how you read one order or its fills: there is no GET /orders/{id}/ endpoint and no fills or trades endpoint. Filter by market and status, find the order by id, and read shares_filled, average_price, and proceeds.

Endpoint

Authentication

This endpoint requires HMAC authentication. Include the Key, Timestamp, and HMAC headers on every request. See the authentication guide for signing instructions.

Request

string
default:"open"
Filter orders by status. One of open, processing, filled, partial_filled, partial_filled_cancelled, or canceled. One value per request.
  • open (default) returns orders that are open or processing, on events that are still open.
  • partial_filled_cancelled returns ioc orders that filled in part.
  • partial_filled returns the other partly filled, finished orders.
See Order lifecycle.
string
Filter by order side. Use bid for buy orders or ask for sell orders.
integer
Filter orders by market (outcome) ID.
integer
Filter orders by event ID. When this parameter is present, event and market in each result are plain IDs instead of nested objects.
string
Filter by a specific currency code. Maximum 4 characters (e.g., USDC, OOM).
string
Filter by currency mode. One of play_money or real_money.
string[]
Filter by one or more currency codes.
integer[]
Filter by one or more category IDs.
Full-text search query. Maximum 255 characters.
string
Field to sort results by: created, price, market_title, expiration_date, or total. Prefix with - for descending order (e.g., -created). The default is newest first.
integer
Number of results to return per page. The default is 20.
integer
Pagination offset. Number of results to skip before returning results.

Response

Returns a paginated list of limit order objects.
object
required
Pagination metadata for the result set.
object[]
required
Array of limit order objects.

Example

The request filters by event, so event and market are IDs. Without event they are nested objects, as in Create order.
Sample response