交易

網格訂單詳情

GEThttps://openapi.longbridge.com/v1/gridtrading/detail

鑑權

簽名方式:每個請求用 App Key / Secret 簽名。請求頭如下:

名稱類型必填說明
Authorizationstring · header必填OpenAPI 後台 上的賬戶 Access Token,作為原始 token 傳入(不帶 Bearer 前綴),並參與簽名計算。
X-Api-Keystring · header必填你的 App Key。
X-Timestampstring · header必填請求時間戳,單位秒(Unix 時間)。
X-Api-Signaturestring · header必填HMAC-SHA256 簽名。格式:HMAC-SHA256 SignedHeaders=authorization;x-api-key;x-timestamp, Signature=。

查詢單個網格訂單的完整詳情,包括網格規則、分頁的成交子訂單(grid_sub_orders)以及分頁的生命週期歷史(grid_order_history)。

>_ CLI
# Rule, sub-orders and history of a grid order
longbridge grid detail 764609681686573056

請求

查詢參數

名稱類型必填說明
order_idstring必填網格訂單 ID,例如:`764609681686573056`
history_idstring可選生命週期歷史的分頁遊標,傳入某頁最後一條的 `history_id` 以獲取更早的記錄
limitinteger可選`grid_sub_orders` 與 `grid_order_history` 的分頁大小

響應

響應欄位

名稱類型必填說明
order_idstring必填網格訂單 ID
symbolstring必填標的代碼,`ticker.region` 格式
stock_namestring必填標的名稱
statusstring必填網格訂單狀態,例如:`Performing` / `Suspended`
grid_statusstring必填網格詳細運行狀態
suspend_reasonstring必填網格被暫停的原因,運行中時為空
sleeping_reasonstring必填網格休眠的原因,活躍時為空
submitted_base_pricestring必填提交時網格錨定的基準價
current_base_pricestring必填觸發後的當前基準價
upper_limit_pricestring必填價格上界
lower_limit_pricestring必填價格下界
trigger_price_typeint32必填觸發閾值的計價方式。**枚舉值:**, `1` - 價差(絕對值), `2` - 百分比
trigger_spread_upstring必填向上觸發價差(當 `trigger_price_type` 為 `1` 時)
trigger_spread_downstring必填向下觸發價差(當 `trigger_price_type` 為 `1` 時)
trigger_percent_upstring必填向上觸發百分比(當 `trigger_price_type` 為 `2` 時)
trigger_percent_downstring必填向下觸發百分比(當 `trigger_price_type` 為 `2` 時)
pullback_percentstring必填回落百分比
pullback_spreadstring必填回落價差
rebound_percentstring必填反彈百分比
rebound_spreadstring必填反彈價差
multiple_triggerboolean必填單個網格檔位是否可多次觸發
time_in_forceint32必填訂單有效期。**枚舉值:**, `0` - 當日有效,`1` - GTC, `6` - GTD
trigger_quantitystring必填每次觸發的數量
trigger_sell_quantitystring必填賣出方向累計觸發數量
trigger_buy_quantitystring必填買入方向累計觸發數量
upper_limit_quantitystring必填觸及上界時處理的數量
lower_limit_quantitystring必填觸及下界時處理的數量
upper_limit_eventint32必填觸及上界時的動作。**枚舉值:**, `1` - 忽略,`2` - 按最新價平倉
lower_limit_eventint32必填觸及下界時的動作。**枚舉值:**, `1` - 忽略,`2` - 按最新價平倉
trigger_sell_depthint32必填賣出方向盤口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_up`
trigger_buy_depthint32必填買入方向盤口深度(-5 ~ 5)。`0` = 使用 `grid_order_type_down`
created_atstring必填創建時間,RFC3339 格式
updated_atstring必填最後更新時間,RFC3339 格式
settlement_currencystring必填結算貨幣,例如:`HKD`
expire_timestring必填過期時間,RFC3339 格式(當 `time_in_force` 為 GTD 時)
gtdstring必填Good-Til-Date,`YYYY-MM-DD` 格式
grid_sub_ordersobject[]可選該網格已成交的子訂單
└ idstring必填子訂單 ID
└ pricestring必填訂單價格
└ order_typestring必填訂單類型
└ quantitystring必填訂單數量
└ executed_qtystring必填已成交數量
└ actionint32必填買賣方向
└ statusstring必填子訂單狀態
└ submitted_atstring必填提交時間,RFC3339 格式
└ rthint32必填盤中交易時段標識(`0` / `1` / `2`)
sub_has_moreboolean必填是否還有更多子訂單可分頁
grid_order_historyobject[]可選生命週期歷史記錄
└ history_idstring必填歷史記錄 ID,同時用作分頁遊標
└ created_atstring必填事件時間,RFC3339 格式
└ suspend_reasonstring必填暫停原因(如適用)
└ reasonstring必填事件的可讀描述
history_has_moreboolean必填是否可通過 `history_id` 分頁獲取更多歷史記錄
support_shortsellboolean必填是否允許賣空
rthint32必填盤中交易時段標識(`0` / `1` / `2`)
grid_order_type_upstring必填`trigger_sell_depth` 為 `0` 時的賣出方向訂單類型。**枚舉值:**, `GMO` / `GLO` / `GTG`
grid_order_type_downstring必填`trigger_buy_depth` 為 `0` 時的買入方向訂單類型。**枚舉值:**, `GMO` / `GLO` / `GTG`

響應 JSON 示例

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "764609681686573056",
    "symbol": "700.HK",
    "stock_name": "TENCENT",
    "status": "Performing",
    "grid_status": "Performing",
    "suspend_reason": "",
    "sleeping_reason": "",
    "submitted_base_price": "300",
    "current_base_price": "300",
    "upper_limit_price": "360",
    "lower_limit_price": "240",
    "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": "",
    "multiple_trigger": false,
    "time_in_force": 1,
    "trigger_quantity": "100",
    "trigger_sell_quantity": "0",
    "trigger_buy_quantity": "0",
    "upper_limit_quantity": "200",
    "lower_limit_quantity": "100",
    "upper_limit_event": 1,
    "lower_limit_event": 1,
    "trigger_sell_depth": 0,
    "trigger_buy_depth": 0,
    "created_at": "2024-08-12T10:30:00+08:00",
    "updated_at": "2024-08-12T10:30:00+08:00",
    "settlement_currency": "HKD",
    "expire_time": "",
    "gtd": "",
    "grid_sub_orders": [],
    "sub_has_more": false,
    "grid_order_history": [
      {
        "history_id": "764609681686573100",
        "created_at": "2024-08-12T10:30:00+08:00",
        "status": "Performing",
        "suspend_reason": "",
        "reason": "Grid order started"
      }
    ],
    "history_has_more": false,
    "support_shortsell": false,
    "rth": 0,
    "grid_order_type_up": "GMO",
    "grid_order_type_down": "GMO"
  }
}

錯誤碼

參見錯誤碼文檔。