Ctrl+K

List Orders

get/api/prime/trading/v1/accounts/{accountId}/orders

Lists all orders from the given trading account.

Path Parameters

  • accountIdstringRequired
    The ID of the account

Query Parameters

  • offsetinteger
  • limitinteger
  • clientOrderIdstring
    The clientOrderId of the order to retrieve
  • dateGtestring<date-time>
    Return client orders with a `creationDate` that is greater than or equal to the given timestamp
  • dateLtstring<date-time>
    Return client orders with a `creationDate` that is less than the given timestamp
  • statusstring
    Return client orders with an order `status` that is equal to the given string
    Enum: pending_open open completed pending_cancel canceled error scheduled
  • fundingTypestringDefault: funded
    Filter by funding type. 'funded' for available balance, 'margin' for margin balance.
    Enum: margin funded

200 Response

data array[object] required
Example: {"id":"67fd640c-cb6c-4218-80ae-49e79ec15646","accountId":"60e740e7898f7d00064d43769a73dc48","enterpriseId":"129841a2143f99c3229c1f4x590396b4","initiatedByUserId":"1203c28030c4320a4b90255b4683ecq6","canceledByUserId":null,"clientOrderId":"myorderid1","time":"2025-11-25T23:12:18.210507Z","creationDate":"2025-11-25T23:12:18.210507Z","scheduledDate":null,"lastFillDate":"2025-11-25T23:12:17.642764Z","completionDate":"2025-11-25T23:12:17.642764Z","settleDate":null,"fundingType":"funded","type":"market","timeInForce":null,"status":"completed","reason":null,"reasonDescription":null,"product":"BTC-USD","side":"buy","quantity":"1000","quantityCurrency":"USD","filledQuantity":"0.02457152","filledQuoteQuantity":"1000","leavesQuantity":null,"leavesQuoteQuantity":"0","averagePrice":"40697.32","limitPrice":null,"duration":null,"twapInterval":null,"rtId":null,"isFinanced":false,"notes":null}
id string <uuid>required
Unique identifier for the order. Used to reference the order in other endpoints.
accountId string required
The ID of the account
enterpriseId string required
initiatedByUserId string required
canceledByUserId string required
clientOrderId string required
Custom order ID provided by the client. This must be a unique ID for each individual order and cannot be the same across multiple requests. Can be used to ensure idempotency of order requests.
Max length: <= 256 characters
time string <date-time>required
creationDate string <date-time>required
scheduledDate string <date-time>required
Date to schedule the order. If not provided, the order will be placed immediately.
lastFillDate string <date-time>required
completionDate string <date-time>required
settleDate string <date-time>required
fundingType string required
The funding type of the order. - Funded orders will be placed using the Go account balance. - Margin orders will be placed using the margin account balances. See our [Trade Guide](/docs/trade-overview) for more details on each funding type.
Allowed values: margin funded
Default: funded
type string required
The type of order to be placed. See our [Trade Guide](/docs/trade-overview) for more details on each order type.
Allowed values: market twap limit steady_pace
timeInForce string required
Time in force policy for the order. GTC (Good Till Cancelled) is the only allowed value.
Allowed value: GTC
status string required
Allowed values: pending_open open completed pending_cancel canceled error scheduled
reason string required
Reason for order cancellation. 'internalError' indicates an error occurred within the server while processing the order, resulting in an order cancellation. 'insufficientFunds' indicates that the order was cancelled due to shortage of funds to complete the transaction.
Allowed values: internalError insufficientFunds
Example: insufficientFunds
reasonDescription string required
product string required
Product name e.g. BTC-USD (base-quote)
side string required
The side of the order
Allowed values: buy sell
Example: buy
quantity string <decimal>required
The specified quantity.
quantityCurrency string required
The specified quantity currency.
filledQuantity string <decimal>required
The total base quantity filled.
filledQuoteQuantity string <decimal>required
The total quote quantity filled.
leavesQuantity string <decimal>required
For orders created with base currency, this field is set to the remaining unfilled base quantity. - Only one of leavesQuantity or leavesQuoteQuantity will be set. - This field is set to null for orders created with quote currency.
leavesQuoteQuantity string <decimal>required
For orders created with quote currency, this field is set to the remaining unfilled quote quantity. - Only one of leavesQuantity or leavesQuoteQuantity will be set. - This field is set to null for orders created with base currency.
averagePrice string <decimal>required
The average price for the order's trades.
limitPrice string <decimal>required
The limit price. It always refers to the quote currency. - It's maximum precision is determined by the product's `quoteDisplayPrecision` field, which can be fetched from the list products endpoint.
Example: 10005.00
duration integer required
Duration of the order in minutes.
twapInterval integer required
Interval length of the TWAP order in minutes.
rtId string required
The request tracking ID associated with the order.
parameters object
notes string required
Additional notes associated with the order.

401 Response

error string required
errorName string required
reqId string required

403 Response

error string required
errorName string required
reqId string required

500 Response

error string required
errorName string required
reqId string required