有效訂單

此端點用於查詢已認證帳戶下的有效訂單（即尚未完全成交或已撤銷的訂單）。可依市場進行篩選。通常用於即時監控未完成的訂單。

---

HTTP 請求

GET /trade/v1/orders/active

---

請求參數

參數名稱	類型	是否必填	說明
market	ENUM	否	市場代碼，用於篩選訂單（參見 market 列舉定義）
portfolio_id	STRING	否	投資組合 ID
page_index	INT	是	當前頁碼，預設為 1
page_size	INT	是	每頁返回記錄數，預設為 20，上限 100

---

範例 cURL 請求

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'

---

成功回應格式

欄位名稱	類型	說明
market	ENUM	市場代碼
order_type	ENUM	訂單類型（如限價單、增強限價單等）
symbol	STRING	股票代碼
name	STRING	股票名稱
order_side	ENUM	買賣方向：buy 或 sell
account_code	STRING	交易帳戶識別碼
order_no	STRING	系統產生的訂單編號
order_status	ENUM	當前訂單狀態
price	DECIMAL	下單價格
qty	DECIMAL	下單總數量
outstand_qty	DECIMAL	尚未成交的剩餘數量
execute_qty	DECIMAL	已成交數量
execute_price	DECIMAL	平均成交價格
execute_amount	DECIMAL	已成交總金額
charge	DECIMAL	交易手續費
charge_base_currency	STRING	手續費幣別
base_currency	STRING	交易幣別
trigger_price	DECIMAL	觸發價格（條件單適用）
reference_id	STRING	客戶自訂訂單編號
portfolio_id	STRING	投資組合 ID（用戶自訂外部 ID）
reject_reason	STRING	拒絕原因（如有）
update_time	LONG	最後更新時間戳（UNIX 格式）
create_time	LONG	訂單建立時間戳（UNIX 格式）

---

成功回應範例

{
	"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
			}
		]
	}
}

---

錯誤回應範例

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

完整錯誤說明請參見 錯誤碼參考。