Get Order's Info
Retrieve information about a particular order
Last updated
Retrieve information about a particular order
Last updated
This GET endpoint enables you to retrieve information about an outstanding order of the user whose authorization token is provided in the header request. If the user has buy, sell, short-sell, or buy-to-cover orders pending, you can request information on one of those orders by sending this API request.
There are five required parameters that must be provided in the request header:
Authorization (header). This is the authorization token from the very first . The value of this header must have the following format: Bearer BQ898r9fefi (Bearer + 1 space + the token).
orderId (path). This is the numeric ID of the order whose information you need to retrieve.
version (path). Unless necessary, leave it at "1.0"
accountID (path). This is the numeric ID of the trading account on which the order is registered.
This API request must be sent to the following URL:
In response to this API request, you'll receive a JSON file with comprehensive information about the order:
Here are some of the common mistakes that developers make when trying to retrieve information about an outstanding order.
Failing to Specify the Et-App-Key Parameter
If you specify the wrong Et-App-Key parameter or fail to include it in the header altogether, you'll get the following error:
Specifying a Trading Account of a Different User
It's critical to understand that when you use the authorization token of a particular user in this request's header, only this user's orders can be examined. Retrieving information about orders of a different user will lead to the 401 error.
In the following article we provide in-depth coverage of the syntax for this API request.