訂單詳情
此端點可查詢指定訂單的詳細資訊。有兩種查詢訂單詳情的方式：
- 按訂單編號查詢（推薦）：使用系統產生的
order_no查詢 - 按參考編號查詢：使用客戶自訂的
reference_id查詢
按訂單編號查詢（推薦）
使用系統產生的訂單編號查詢訂單詳情。這是推薦的查詢方式。
HTTP 請求
bash
GET /trade/v1/orders/{order_no}請求參數
| 參數名稱 | 類型 | 是否必填 | 說明 |
|---|---|---|---|
order_no | STRING | 是 | 系統產生的內部訂單編號 |
cURL 請求範例
bash
curl --location --request GET '{$base_url}/trade/v1/orders/22000000023' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'按參考編號查詢
使用客戶自訂的參考編號查詢訂單詳情。
⚠️ 重要提醒：
reference_id是用戶自訂的識別碼。用戶需自行確保其唯一性。如果存在重複的reference_id值，可能會返回多筆訂單記錄，用戶需自行承擔重複識別碼所產生的後果。
HTTP 請求
bash
GET /trade/v1/orders/byref/{reference_id}請求參數
| 參數名稱 | 類型 | 是否必填 | 說明 |
|---|---|---|---|
reference_id | STRING | 是 | 客戶自訂的訂單識別碼 |
cURL 請求範例
bash
curl --location --request GET '{$base_url}/trade/v1/orders/byref/be65dd22898b44158d34ad1014148d90' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142003'回應格式
訂單物件欄位
兩種查詢方式都返回具有以下結構的訂單物件：
訂單物件欄位說明
| 欄位名稱 | 類型 | 說明 |
|---|---|---|
market | ENUM | 市場代碼（如 hkex, nasdaq） |
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 | 手續費幣別 |
charge_details | ARRAY<charge_detail> | 手續費詳情，詳見 charge_detail 字段明細 |
base_currency | STRING | 交易幣別 |
trigger_price | DECIMAL | 觸發價格（如適用） |
reference_id | STRING | 客戶自訂識別碼 |
portfolio_id | STRING | 投資組合 ID（用戶自訂外部 ID） |
reject_reason | STRING | 拒單原因（如有） |
currency_conversion | currency_conversion | 貨幣轉換資訊，詳見 currency_conversion 字段明細 |
update_time | LONG | 最後更新時間（UNIX 時間戳） |
create_time | LONG | 訂單建立時間（UNIX 時間戳） |
字段明細
| 名稱 | 類型 | 描述 |
|---|---|---|
| code | STRING | 手續費項編碼，例如 us_trading_commission |
| amount | DECIMAL | 該項手續費金額 |
| currency | STRING | 貨幣幣種 |
手續費項目明細
| 代碼 | 收費項 |
|---|---|
| us_trading_commission | 佣金 |
| us_platform_fee | 平台使用費 |
| us_settlement_and_delivery_cost | 交收費 |
| us_sec_membership_fee | 证监会规费 |
| us_external_agency_fee_and_trading_activity_fee | 交易活動費 |
| us_accounting_tracks_fund_fees | 綜合審計追蹤資金費用 |
| us_option_regulation_fees | 監管費 |
按訂單編號查詢回應
在 data 欄位中直接返回單一訂單物件。
單一訂單回應範例（按訂單編號查詢）
json
{
"code": 0,
"data": {
"market": "usex",
"order_type": "limit_order",
"symbol": "AAPL",
"name": "Apple Inc.",
"order_side": "buy",
"account_code": "80112345",
"order_no": "25000000033",
"order_status": "filled",
"price": 200.00,
"qty": 100,
"outstand_qty": 0,
"execute_qty": 100,
"execute_price": 200.00,
"execute_amount": 20000.00,
"charge": 2.04,
"charge_base_currency": "USD",
"charge_details": [
{
"code": "us_trading_commission",
"amount": 1.00,
"currency": "USD"
},
{
"code": "us_platform_fee",
"amount": 1.00,
"currency": "USD"
},
{
"code": "us_settlement_and_delivery_cost",
"amount": 0.03,
"currency": "USD"
},
{
"code": "us_accounting_tracks_fund_fees",
"amount": 0.01,
"currency": "USD"
},
{
"code": "us_sec_membership_fee",
"amount": 0,
"currency": "USD"
},
{
"code": "us_external_agency_fee_and_trading_activity_fee",
"amount": 0,
"currency": "USD"
},
{
"code": "us_option_regulation_fees",
"amount": 0,
"currency": "USD"
}
],
"base_currency": "USD",
"reference_id": "client_ref_001",
"portfolio_id": "portfolio_123",
"reject_reason": "",
"currency_conversion": {
"base_currency": "USDT",
"target_currency": "USD",
"base_amount": 20097.427919,
"target_amount": 20002.04,
"rate": 0.995253725
},
"update_time": 1746775317,
"create_time": 1746775257
}
}按參考編號查詢回應
在 data 欄位中直接返回訂單物件陣列。如果存在重複的 reference_id 值，可能會返回多筆訂單。
回應結構
回應在 data 欄位中直接包含訂單物件陣列。每個訂單物件包含上述訂單物件欄位部分中描述的相同欄位。
多筆訂單回應範例（按參考編號查詢）
json
{
"code": 0,
"data": {
"reference_id": "client_ref_001",
"orders": [
{
"market": "hkex",
"order_type": "limit_order",
"symbol": "00700",
"name": "TENCENT",
"order_side": "buy",
"account_code": "80114138",
"order_no": "22000000022",
"order_status": "filled",
"price": 423.83,
"qty": 1000,
"outstand_qty": 0,
"execute_qty": 1000,
"execute_price": 423.83,
"execute_amount": 423830.0,
"charge": 20.03,
"charge_base_currency": "HKD",
"charge_details": [
{
"code": "hk_trading_commission",
"amount": 15.0,
"currency": "HKD"
},
{
"code": "hk_platform_fee",
"amount": 5.03,
"currency": "HKD"
}
],
"base_currency": "HKD",
"reference_id": "client_ref_001",
"portfolio_id": "portfolio_123",
"reject_reason": "",
"currency_conversion": {
"base_currency": "USDT",
"target_currency": "HKD",
"base_amount": 53125.03,
"target_amount": 423850.03,
"rate": 7.978
},
"update_time": 1746775317,
"create_time": 1746775257
},
{
"market": "hkex",
"order_type": "limit_order",
"symbol": "00700",
"name": "TENCENT",
"order_side": "sell",
"account_code": "80114138",
"order_no": "22000000023",
"order_status": "pending",
"price": 425.0,
"qty": 500,
"outstand_qty": 500,
"execute_qty": 0,
"execute_price": 0,
"execute_amount": 0,
"charge": 0,
"charge_base_currency": "HKD",
"charge_details": [],
"base_currency": "HKD",
"reference_id": "client_ref_001",
"portfolio_id": "portfolio_123",
"reject_reason": "",
"currency_conversion": {
"base_currency": "USDT",
"target_currency": "HKD",
"rate": 7.978
},
"update_time": 1746775400,
"create_time": 1746775400
}
]
}
}錯誤回應範例
json
{
"code": 500,
"message": "Internal Service Error",
"details": ""
}完整錯誤說明請參見 錯誤碼參考。