交易
鑑權
簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
Authorization | string · header | 必填 | OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。 |
X-Api-Key | string · header | 必填 | 你的 App Key。 |
X-Timestamp | string · header | 必填 | 請求時間戳,單位秒(Unix 時間)。 |
X-Api-Signature | string · header | 必填 | HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。 |
按 ID 查詢指定的網格訂單。
請求
請求體
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
order_ids | array | 必填 | 待查詢的網格訂單 ID |
響應
響應欄位
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
grid_order | object[] | 可選 | 網格訂單 |
└ order_id | string | 必填 | 網格訂單 ID |
└ symbol | string | 必填 | 標的代碼,使用 `ticker.region` 格式,例如:`AAPL.US` |
└ stock_name | string | 必填 | 標的名稱 |
└ market | string | 必填 | 市場 |
└ status | string | 必填 | 網格訂單狀態 |
└ grid_status | string | 必填 | 網格運行狀態 |
└ submitted_base_price | string | 必填 | 網格錨定的提交基準價格 |
└ current_base_price | string | 必填 | 當前基準價格 |
└ pre_trigger_base_price | string | 必填 | 上次觸發前的基準價格 |
└ post_trigger_base_price | string | 必填 | 上次觸發後的基準價格 |
└ upper_limit_price | string | 必填 | 價格上限 |
└ lower_limit_price | string | 必填 | 價格下限 |
└ trigger_price_type | int32 | 必填 | 觸發價格類型。**Enum Value:**, `1` - 價差,`2` - 百分比 |
└ trigger_spread_up | string | 必填 | 向上觸發價差,`trigger_price_type` 為 `1` 時使用 |
└ trigger_spread_down | string | 必填 | 向下觸發價差,`trigger_price_type` 為 `1` 時使用 |
└ trigger_percent_up | string | 必填 | 向上觸發百分比,`trigger_price_type` 為 `2` 時使用 |
└ trigger_percent_down | string | 必填 | 向下觸發百分比,`trigger_price_type` 為 `2` 時使用 |
└ pullback_percent | string | 必填 | 回調百分比 |
└ pullback_spread | string | 必填 | 回調價差 |
└ rebound_percent | string | 必填 | 反彈百分比 |
└ rebound_spread | string | 必填 | 反彈價差 |
└ trigger_sell_order_type | string | 必填 | 賣出方網格訂單類型。**Enum Value:**, `GMO` - 網格市價單,`GLO` - 網格限價單,`GTG` - 網格觸價單 |
└ trigger_buy_order_type | string | 必填 | 買入方網格訂單類型。**Enum Value:**, `GMO` - 網格市價單,`GLO` - 網格限價單,`GTG` - 網格觸價單 |
└ trigger_sell_depth | int32 | 必填 | 賣出方盤口深度,範圍 `-5..5`;`0` 表示使用 `trigger_sell_order_type` |
└ trigger_buy_depth | int32 | 必填 | 買入方盤口深度,範圍 `-5..5`;`0` 表示使用 `trigger_buy_order_type` |
└ trigger_quantity | string | 必填 | 每次觸發數量 |
└ trigger_sell_quantity | string | 必填 | 賣出方觸發數量 |
└ trigger_buy_quantity | string | 必填 | 買入方觸發數量 |
└ upper_limit_quantity | string | 必填 | 觸及上限時處理的數量 |
└ lower_limit_quantity | string | 必填 | 觸及下限時處理的數量 |
└ upper_limit_event | int32 | 必填 | 觸及上限時的處理事件。**Enum Value:**, `1` - 忽略(保持網格運行), `2` - 以最新價平倉 |
└ lower_limit_event | int32 | 必填 | 觸及下限時的處理事件。**Enum Value:**, `1` - 忽略(保持網格運行), `2` - 以最新價平倉 |
└ multiple_trigger | boolean | 必填 | 單個網格檔位是否可多次觸發 |
└ trigger_times | int32 | 必填 | 網格已觸發次數 |
└ total_buy_quantity | string | 必填 | 累計買入數量 |
└ total_sell_quantity | string | 必填 | 累計賣出數量 |
└ total_profit_balance | string | 必填 | 累計收益餘額 |
└ settlement_currency | string | 必填 | 結算貨幣 |
└ time_in_force | int32 | 必填 | 訂單有效期類型。**Enum Value:**, `0` - 當日有效,`1` - 撤單前有效,`6` - 指定日期前有效 |
└ gtd | string | 必填 | 指定日期前有效的到期日期,格式:`YYYY-MM-DD` |
└ created_at | string | 必填 | 創建時間,格式為 RFC3339 |
└ rth | int32 | 必填 | 盤中交易時段標識。**Enum Value:**, `0`, `1`, `2` |
└ support_shortsell | boolean | 必填 | 是否允許賣空 |
└ grid_order_type_up | string | 必填 | 深度為 `0` 時賣出方的訂單類型。**Enum Value:**, `GMO` - 網格市價單,`GLO` - 網格限價單,`GTG` - 網格觸價單 |
└ grid_order_type_down | string | 必填 | 深度為 `0` 時買入方的訂單類型。**Enum Value:**, `GMO` - 網格市價單,`GLO` - 網格限價單,`GTG` - 網格觸價單 |
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"grid_order": [
{
"order_id": "764609681686573056",
"symbol": "700.HK",
"stock_name": "TENCENT",
"market": "HK",
"status": "Performing",
"grid_status": "Performing",
"submitted_base_price": "300.000",
"current_base_price": "300.000",
"pre_trigger_base_price": "300.000",
"post_trigger_base_price": "306.000",
"upper_limit_price": "360.000",
"lower_limit_price": "240.000",
"trigger_price_type": 2,
"trigger_spread_up": "",
"trigger_spread_down": "",
"trigger_percent_up": "2",
"trigger_percent_down": "2",
"pullback_percent": "",
"pullback_spread": "",
"rebound_percent": "",
"rebound_spread": "",
"trigger_sell_order_type": "GMO",
"trigger_buy_order_type": "GMO",
"trigger_sell_depth": 0,
"trigger_buy_depth": 0,
"trigger_quantity": "100",
"trigger_sell_quantity": "100",
"trigger_buy_quantity": "100",
"upper_limit_quantity": "200",
"lower_limit_quantity": "100",
"upper_limit_event": 1,
"lower_limit_event": 1,
"multiple_trigger": false,
"trigger_times": 3,
"total_buy_quantity": "300",
"total_sell_quantity": "200",
"total_profit_balance": "1250.00",
"settlement_currency": "HKD",
"time_in_force": 1,
"gtd": "",
"created_at": "2025-01-15T09:30:00+08:00",
"rth": 0,
"support_shortsell": false,
"grid_order_type_up": "GMO",
"grid_order_type_down": "GMO"
}
]
}
}錯誤碼
參見錯誤碼文檔。