GuidesAPI Reference
DocumentationLog In

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.

πŸ“˜

Note that orders with a "pending" status have a reduced set of fields in the response.

  • "pending" Limit orders will not have stp, time_in_force, expire_time, and post_only.
  • "pending" Market orders will have the same fields as a "pending" Limit order minus price and size, and no Market specific fields (funds, specified_funds).
  • "pending" Stop orders will have the same fields as a "pending" Limit order and no Stop specific fields (stop, stop_price).

API Key Permissions

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.

This request is paginated. Please see the Pagination section for more information.

Order status and settlement

Orders which are no longer resting on the order book, will be 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.

Polling

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 may change state between the request and the response depending on market conditions.

Language
Authentication
Response
Click Try It! to start a request and see the response here!