Get order - TQX Docs

Returns the current order snapshot for the authenticated account.

CLI

tqx trading orders get <order-id> --json

HTTP

curl --request GET \
  --url 'https://www.tqx.trade/openapi/v1/trading/orders/<order-id>' \
  --header "X-API-Key: $TQX_API_KEY" \
  --header 'Accept: application/json'

The path parameter must be 1 to 128 characters. URL-encode it when necessary.

Response

The JSON envelope contains code (string; "0" means success), message (string), data (OrderData or null), request_id (string or null), and timestamp (integer Unix time in milliseconds). On success, data is one OrderData object:

Field	Type	Description
`order_id`	string	TQX order identifier.
`client_order_id`	string or `null`	Client-supplied order identifier, when provided.
`symbol`	string	Trading symbol.
`symbol_name`	string	Human-readable symbol name.
`market`	`HK` or `US`	Order market.
`currency`	string	Currency used for the account’s amounts. It is not necessarily the currency of `price` or `average_fill_price`: a US order in an HKD account reports `HKD` here. See `price_currency`.
`side`	`BUY` or `SELL`	Order direction.
`order_type`	`MARKET` or `LIMIT`	Order type.
`status`	enum	Current order lifecycle status.
`quantity`	string	Requested quantity.
`price`	string or `null`	Limit price; `null` for market orders.
`filled_quantity`	string	Quantity filled so far.
`remaining_quantity`	string	Quantity not yet filled.
`average_fill_price`	string or `null`	Average execution price; `null` when nothing has filled.
`submitted_at`	date-time string or `null`	Submission time, when available.
`updated_at`	date-time string or `null`	Last update time, when available.
`time_in_force`	`DAY` (optional)	Order validity policy.
`market_session`	string or `null` (optional)	Broker market session associated with the order.
`effective_trade_date`	string or `null` (optional)	Effective trading date reported by the broker.
`expire_at`	date-time string or `null` (optional)	Expiration time, when applicable.
`cancel_request_id`	string or `null` (optional)	Identifier of the cancellation request, when one exists.
`price_currency`	string or `null` (optional)	Currency of `price` and `average_fill_price`, which use the instrument’s trading currency. `null` when TQX cannot determine it. Do not infer it from `market`.

status uses the same values as List orders. The endpoint returns the current order view. An order_not_found response does not by itself prove that an order was filled, cancelled, or rejected; cross-check the original signal and trades.