List your current open orders. Only open or un-settled orders are returned by default. As soon as an order is no longer open and settled, it will no longer appear in the default request. Open orders may change state between the request and the response depending on market conditions.
Orders with a “pending” status have fewer fields in the response.
stp
, time_in_force
, expire_time
, and post_only
.price
and size
, and no market specific fields (funds
, specified_funds
).stop
, stop_price
).Order Type | Does Not Have These Fields |
---|---|
Pending Limit Order | stp , time_in_force , expire_time , post_only |
Pending Market Order | stp , time_in_force , expire_time , post_only , price , size , funds , specified_funds |
Pending Stop Order | stp , time_in_force , expire_time , post_only , stop , stop_price |
This endpoint requires either the “view” or “trade” permission.
To specify multiple statuses, use the status query argument multiple times: /orders?status=done&status=pending
.
Orders which are no longer resting on the order book, are marked with the done
status. There is a small window between an order being done
and settled
. An order is settled when all of the fills have settled and the remaining holds (if any) have been removed.
For high-volume trading it is strongly recommended that you maintain your own list of open orders and use one of the streaming market data feeds to keep it updated. You should poll the open orders endpoint once when you start trading to obtain the current state of any open orders.
executed_value
is the cumulative match size
* price
and is only present for orders placed after 2016-05-20.
Open orders can change state between the request and the response depending on market conditions.
This request is paginated. See Pagination for more information.
Filter results by a specific profile_id
Filter results by a specific product_id
Sort criteria for results.
created_at
, price
, size
, order_id
, side
, type
Ascending or descending order, by sortedBy
desc
, asc
Filter results by minimum posted date
Filter results by maximum posted date
Used for pagination. Sets start cursor to before
date.
Used for pagination. Sets end cursor to after
date.
Limit on number of results to return.
Array with order statuses to filter by.
Market type which the order was traded in.
The response is of type object[]
.