Get account order detail
Changed onReturns the detail of a single order, identified by the brokerage order ID in the path, in the same kind-discriminated format as /accounts/{accountId}/orders/all.
The order carries a legs list with at least one leg; switch on legs[].instrument.kind and order_type.kind to know which fields are present. Multi-leg orders are a single order with multiple legs.
This endpoint is always realtime and does not rely on cached data, except that an order in a terminal state (executed, canceled, rejected, failed, expired, replaced) may be served from a short-lived cache since it can no longer change.
This endpoint only returns orders placed through SnapTrade. In other words, orders placed outside of the SnapTrade network are not returned by this endpoint.
Beta: this endpoint and its response schema may change.
Request
- Base URLhttps://api.snaptrade.com
- AuthAPI key in header Signature and API key in query parameter clientId and API key in query parameter timestamp
Path parameters
Unique identifier for the connected brokerage account. This is the UUID used to reference the account in SnapTrade.
Order ID returned by brokerage. This is the unique identifier for the order in the brokerage system.
Query parameters
SnapTrade User ID. This is chosen by the API partner and can be any string that is a) unique to the user, and b) immutable for the user. It is recommended to NOT use email addresses for this property because they are usually not immutable.
SnapTrade User Secret. This is a randomly generated string and should be stored securely. If compromised, please rotate it via the rotate user secret endpoint.
Response
OK
Example response
{
"brokerage_order_id": "66a033fa-da74-4fcf-b527-feefdec9257e",
"order_type": {
"kind": "market"
},
"time_in_force": "DAY",
"expiry_date": "2026-07-30T22:51:49Z",
"priced_in": {
"kind": "cash",
"code": "EUR"
},
"total_quantity": "10",
"filled_quantity": "9",
"canceled_quantity": "1",
"open_quantity": "0",
"execution_price": "12.34",
"time_placed": "2026-07-30T22:51:49Z",
"time_updated": "2026-07-30T22:52:10Z",
"time_executed": "2026-08-05T00:05:57Z",
"group": {
"id": "1234567890",
"role": "TRIGGER"
},
"legs": [
{
"instrument": {
"kind": "stock",
"id": "1ef3a5d3-4a9b-40b2-b8d1-cc35f74d6324",
"symbol": "AAPL",
"raw_symbol": "AAPL",
"description": "Apple Inc.",
"currency": "USD",
"exchange": "XNAS",
"figi_instrument": {
"figi_code": "BBG000B9Y5X2",
"figi_share_class": "BBG001S5N8V8"
}
},
"total_quantity": "10",
"filled_quantity": "9",
"canceled_quantity": "1",
"execution_price": "12.34"
}
]
}Changes
- info
api tag
Account Informationadded - info
api tag
Experimental endpointsremoved
- info
- info
endpoint added
- info