Skip to main content
GET
List prediction order history
This endpoint is in closed beta. It is available only to accounts enrolled in the beta, and only on staging (https://api.tradearies.dev). Request and response shapes may change before general availability.

Overview

accountId is required. Every order on the account is returned, whoever placed it, newest first. placedBy narrows the list to the orders one user placed. List Prediction Orders is the current trading day. This endpoint is the full record, one page at a time.

Filter by time

from and to bound the page by when the order was created, as RFC 3339 times. from is inclusive and to is exclusive. Either can be left out.

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.

from
string<date-time>

Only orders created at or after this time (RFC 3339). Not RFC 3339 returns 400 INVALID_FROM.

to
string<date-time>

Only orders created before this time (RFC 3339). Not RFC 3339 returns 400 INVALID_TO.

Response

One page of orders.

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

success
boolean
required
Example:

true

data
object