交易
鑑權
簽名方式:每個請求用 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=。 |
提交網格策略訂單。網格以 submitted_base_price 為基準價,在 [lower_limit_price, upper_limit_price] 區間內,價格下跌時掛買單、價格上漲時掛賣單。
使用網格交易前,你需要先記錄一次策略風險揭示的同意確認,詳見提交策略問卷。
# 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
請求
請求體
| 名稱 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 必填 | 標的代碼,`ticker.region` 格式,例如:`700.HK` |
settlement_currency | string | 必填 | 結算貨幣,例如:`HKD` |
grid_trading_rule | object | 必填 | 網格規則,欄位見下方。 |
grid_trading_rule.submitted_base_price | string | 必填 | 網格錨定的基準價 |
grid_trading_rule.upper_limit_price | string | 必填 | 價格上邊界 |
grid_trading_rule.lower_limit_price | string | 必填 | 價格下邊界 |
grid_trading_rule.trigger_price_type | integer | 必填 | 觸發閾值的解釋方式。**可選值:**, `1` - spread(絕對價差), `2` - percent(百分比) |
grid_trading_rule.trigger_spread_up | string | 可選 | 上漲觸發價差,`trigger_price_type` 為 `1` 時必填 |
grid_trading_rule.trigger_spread_down | string | 可選 | 下跌觸發價差,`trigger_price_type` 為 `1` 時必填 |
grid_trading_rule.trigger_percent_up | string | 可選 | 上漲觸發百分比,`trigger_price_type` 為 `2` 時必填 |
grid_trading_rule.trigger_percent_down | string | 可選 | 下跌觸發百分比,`trigger_price_type` 為 `2` 時必填 |
grid_trading_rule.trigger_buy_quantity | string | 必填 | 每次觸發買入數量 |
grid_trading_rule.trigger_sell_quantity | string | 必填 | 每次觸發賣出數量 |
grid_trading_rule.time_in_force | integer | 必填 | 訂單有效期。**可選值:**, `0` - Day(當日有效), `1` - GTC(撤單前有效), `6` - GTD(到期前有效) |
grid_trading_rule.expire_time | integer | 可選 | 到期時間(Unix 時間戳,單位秒),`time_in_force` 為 `6`(GTD)時必填 |
grid_trading_rule.upper_limit_event | integer | 可選 | 達到上邊界時的動作。**可選值:**, `1` - ignore(繼續運行), `2` - 按最新價平倉 |
grid_trading_rule.lower_limit_event | integer | 可選 | 達到下邊界時的動作。**可選值:**, `1` - ignore(繼續運行), `2` - 按最新價平倉 |
grid_trading_rule.trigger_sell_depth | integer | 可選 | 賣盤盤口檔位(-5 ~ 5)。`0` 表示改用 `grid_order_type_up` 而非檔位 |
grid_trading_rule.trigger_buy_depth | integer | 可選 | 買盤盤口檔位(-5 ~ 5)。`0` 表示改用 `grid_order_type_down` 而非檔位 |
grid_trading_rule.grid_order_type_up | string | 可選 | `trigger_sell_depth` 為 `0` 時的賣盤訂單類型。**可選值:**, `GMO` / `GLO` / `GTG` |
grid_trading_rule.grid_order_type_down | string | 可選 | `trigger_buy_depth` 為 `0` 時的買盤訂單類型。**可選值:**, `GMO` / `GLO` / `GTG` |
grid_trading_rule.multiple_trigger | boolean | 可選 | 單個網格檔位是否允許多次觸發 |
grid_trading_rule.support_shortsell | boolean | 可選 | 是否允許賣空 |
grid_trading_rule.rth | integer | 可選 | 常規交易時段標誌(`0` / `1` / `2`) |
響應
響應 JSON 示例
{
"code": 0,
"message": "success",
"data": {
"order_id": "764609681686573056"
}
}錯誤碼
參見錯誤碼文檔。