Skip to main content
GET
Get order history

Headers

x-wallet
string

Wallet address — primary user identification method

x-device-id
string

Device identifier — mobile fallback when x-wallet is not set

Query Parameters

wallet
string

Wallet address — fallback if neither x-wallet nor x-device-id headers are set

Response

200 - application/json

Array of orders

id
integer
required

Unique order identifier

Example:

42

instrument_id
string
required
Example:

"SOL_USDC-28FEB26-150-C"

owner
string
required

User who placed the order

Example:

"alice"

side
enum<string>
required
Available options:
bid,
ask
order_type
enum<string>
required
Available options:
limit,
market
price
integer
required

Limit price in USDC micros

Example:

1500000

size
integer
required

Original order size in millicontracts

Example:

1000

remaining
integer
required

Unfilled quantity in millicontracts

Example:

500

status
enum<string>
required
Available options:
open,
partially_filled,
filled,
cancelled
created_at
integer
required

Order creation timestamp (Unix microseconds)

Example:

1709164800000000

price_decimals
integer
required

Decimals applied to price (always 6).

Example:

6

size_decimals
integer
required

Decimals applied to size/remaining (always 3).

Example:

3

contract_size
integer
required

Underlying units per contract — currently 1 for all listed instruments. Always read this from the response, never hard-code: future contracts may ship with a different multiplier. 0 indicates the instrument has rolled off and is no longer in the live engine.

Example:

1