Skip to main content
GET
Python (SDK)
This endpoint is in closed beta. It is available only to accounts enrolled in the beta. Request and response shapes may change before general availability.

Overview

accountId is required. Orders belong to the account, so every order on it is returned, whoever placed it. placedBy narrows the list to the orders one user placed. This is the current view, not the whole history. It returns:
  • every order still open (pending_new, new, partially_filled, unknown), however long ago it was placed, such as a gtc order from last week, and
  • every order created or closed since the trading day rolled over at 17:00 America/Chicago.
Orders that closed before the rollover are read from List Prediction Order History. Orders are returned newest first. Each has the same shape as data.order in Get Prediction Order, without the fills and events. That includes contract: the contract’s event, label, question and lifecycle, or null when the catalogue does not have it.

Filter by state

status takes a comma-separated list of states:
open is shorthand for every state an order can still rest or execute in: pending_new, new, partially_filled, and unknown. It can be combined with other states.
Valid states are pending_new, new, partially_filled, filled, canceled, rejected, expired, done_for_day, and unknown. Any other value returns 400. symbol and placedBy narrow the results further.

Paging

limit sets the page size. It defaults to 50, and values above 200 are clamped to 200. Pass the response’s nextCursor as cursor to fetch the next page. nextCursor is absent on the last page.
Quantities and prices are exact decimals serialized as JSON strings. Parse them with a decimal type.

Example

Errors

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Query Parameters

status
string

Comma-separated order states, or open for every state an order can still rest or execute in (pending_new, new, partially_filled, unknown). An unknown state returns 400.

accountId
string
required

The account. Every order on it is covered, whoever placed it.

placedBy
string

Only orders this user placed.

symbol
string

Only orders on this contract symbol.

limit
integer
default:50

Orders per page. Values above 200 are clamped to 200. 0, a negative value, or a non-integer returns 400.

Required range: 1 <= x <= 200
cursor
string

nextCursor from the previous page.

Response

One page of orders.

Standard success envelope used by all success responses. data is endpoint-specific.

success
boolean
required
Example:

true

data
object