交易

提交網格訂單

POSThttps://openapi.longbridge.com/v1/gridtrading/submit

鑑權

簽名方式:每個請求用 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=。

提交網格策略訂單。網格以 submitted_base_price 為基準價,在 [lower_limit_price, upper_limit_price] 區間內,價格下跌時掛買單、價格上漲時掛賣單。

使用網格交易前,你需要先記錄一次策略風險揭示的同意確認,詳見提交策略問卷。

>_ CLI
# Submit a percent-triggered grid on 700.HK
longbridge grid submit 700.HK --currency HKD --base-price 300 --upper-price 360 --lower-price 240 --trigger-type percent --trigger-up 2 --trigger-down 2 --quantity 100 --upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc
# Validate the rule without submitting
longbridge grid submit 700.HK --currency HKD --base-price 300 --upper-price 360 --lower-price 240 --trigger-type percent --trigger-up 2 --trigger-down 2 --quantity 100 --upper-quantity 200 --lower-quantity 100 --order-type GMO --tif gtc --dry-run

請求

請求體

名稱類型必填說明
symbolstring必填標的代碼,`ticker.region` 格式,例如:`700.HK`
settlement_currencystring必填結算貨幣,例如:`HKD`
grid_trading_ruleobject必填網格規則,欄位見下方。
grid_trading_rule.submitted_base_pricestring必填網格錨定的基準價
grid_trading_rule.upper_limit_pricestring必填價格上邊界
grid_trading_rule.lower_limit_pricestring必填價格下邊界
grid_trading_rule.trigger_price_typeinteger必填觸發閾值的解釋方式。**可選值:**, `1` - spread(絕對價差), `2` - percent(百分比)
grid_trading_rule.trigger_spread_upstring可選上漲觸發價差,`trigger_price_type` 為 `1` 時必填
grid_trading_rule.trigger_spread_downstring可選下跌觸發價差,`trigger_price_type` 為 `1` 時必填
grid_trading_rule.trigger_percent_upstring可選上漲觸發百分比,`trigger_price_type` 為 `2` 時必填
grid_trading_rule.trigger_percent_downstring可選下跌觸發百分比,`trigger_price_type` 為 `2` 時必填
grid_trading_rule.trigger_buy_quantitystring必填每次觸發買入數量
grid_trading_rule.trigger_sell_quantitystring必填每次觸發賣出數量
grid_trading_rule.time_in_forceinteger必填訂單有效期。**可選值:**, `0` - Day(當日有效), `1` - GTC(撤單前有效), `6` - GTD(到期前有效)
grid_trading_rule.expire_timeinteger可選到期時間(Unix 時間戳,單位秒),`time_in_force` 為 `6`(GTD)時必填
grid_trading_rule.upper_limit_eventinteger可選達到上邊界時的動作。**可選值:**, `1` - ignore(繼續運行), `2` - 按最新價平倉
grid_trading_rule.lower_limit_eventinteger可選達到下邊界時的動作。**可選值:**, `1` - ignore(繼續運行), `2` - 按最新價平倉
grid_trading_rule.trigger_sell_depthinteger可選賣盤盤口檔位(-5 ~ 5)。`0` 表示改用 `grid_order_type_up` 而非檔位
grid_trading_rule.trigger_buy_depthinteger可選買盤盤口檔位(-5 ~ 5)。`0` 表示改用 `grid_order_type_down` 而非檔位
grid_trading_rule.grid_order_type_upstring可選`trigger_sell_depth` 為 `0` 時的賣盤訂單類型。**可選值:**, `GMO` / `GLO` / `GTG`
grid_trading_rule.grid_order_type_downstring可選`trigger_buy_depth` 為 `0` 時的買盤訂單類型。**可選值:**, `GMO` / `GLO` / `GTG`
grid_trading_rule.multiple_triggerboolean可選單個網格檔位是否允許多次觸發
grid_trading_rule.support_shortsellboolean可選是否允許賣空
grid_trading_rule.rthinteger可選常規交易時段標誌(`0` / `1` / `2`)

響應

響應 JSON 示例

{
  "code": 0,
  "message": "success",
  "data": {
    "order_id": "764609681686573056"
  }
}

錯誤碼

參見錯誤碼文檔。