Active Orders

This endpoint retrieves a list of active (i.e., not fully filled or canceled) orders for the authenticated account. It can be filtered by market. This is typically used to monitor outstanding orders in real-time.

---

HTTP Request

GET /trade/v1/orders/active

---

Request Parameters

Name	Type	Required	Description
market	ENUM	No	Market code to filter orders (see market enum definition)
portfolio_id	STRING	No	Portfolio ID
page_index	INT	YES	Current page index, default is 1
page_size	INT	YES	Number of records per page, default is 20, max limit is 100

---

Example cURL Request

curl --location --request GET '{$base_url}/trade/v1/orders/active?market=hkex' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'

---

Successful Response Format

Field	Type	Description
market	ENUM	Market code
order_type	ENUM	Order type (e.g., limit, enhanced limit)
symbol	STRING	Product code
name	STRING	Product name
order_side	ENUM	Order direction: buy or sell
account_code	STRING	Trading account identifier
order_no	STRING	System-generated order ID
order_status	ENUM	Current order status
price	DECIMAL	Order price
qty	DECIMAL	Total order quantity
outstand_qty	DECIMAL	Remaining unexecuted quantity
execute_qty	DECIMAL	Quantity that has been executed
execute_price	DECIMAL	Average execution price
execute_amount	DECIMAL	Total value of executed quantity
charge	DECIMAL	Transaction fee
charge_base_currency	STRING	Fee currency code
base_currency	STRING	Trade currency code
trigger_price	DECIMAL	Trigger price (for conditional orders)
reference_id	STRING	Custom client-defined order ID
portfolio_id	STRING	Portfolio ID (which is a user-defined external id )
reject_reason	STRING	Reason for rejection (if any)
update_time	LONG	Last update timestamp (UNIX format)
create_time	LONG	Order creation timestamp (UNIX format)

---

Successful Response Example

{
	"code": 0,
	"data": {
		"total_records": 1,
		"page": 1,
		"page_size": 20,
		"orders": [
			{
				"market": "hkex",
				"order_type": "enhanced_limit_order",
				"symbol": "00700",
				"name": "TENCENT",
				"order_side": "buy",
				"account_code": "80114138",
				"order_no": "22000000022",
				"order_status": "can",
				"price": 423.83,
				"qty": 1000,
				"outstand_qty": 0,
				"execute_qty": 1000,
				"execute_amount": 423.83,
				"charge": 20.03,
				"charge_base_currency": "HKD",
				"base_currency": "HKD",
				"reference_id": "",
				"portfolio_id": "",
				"reject_reason": "",
				"update_time": 1746775317,
				"create_time": 1746775257
			}
		]
	}
}

---

Error Response Example

{
	"code": 500,
	"message": "Internal Service Error",
	"details": ""
}

See the Error Code Reference for full error descriptions.