# 提交網格訂單

`POST` `/v1/gridtrading/submit`

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

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

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `symbol` | string | Yes | 標的代碼，`ticker.region` 格式，例如：`700.HK` |
| `settlement_currency` | string | Yes | 結算貨幣，例如：`HKD` |
| `grid_trading_rule` | object | Yes | 網格規則，欄位見下方。 |
| `grid_trading_rule.submitted_base_price` | string | Yes | 網格錨定的基準價 |
| `grid_trading_rule.upper_limit_price` | string | Yes | 價格上邊界 |
| `grid_trading_rule.lower_limit_price` | string | Yes | 價格下邊界 |
| `grid_trading_rule.trigger_price_type` | integer | Yes | 觸發閾值的解釋方式。**可選值：**, `1` - spread（絕對價差）, `2` - percent（百分比） |
| `grid_trading_rule.trigger_spread_up` | string | No | 上漲觸發價差，`trigger_price_type` 為 `1` 時必填 |
| `grid_trading_rule.trigger_spread_down` | string | No | 下跌觸發價差，`trigger_price_type` 為 `1` 時必填 |
| `grid_trading_rule.trigger_percent_up` | string | No | 上漲觸發百分比，`trigger_price_type` 為 `2` 時必填 |
| `grid_trading_rule.trigger_percent_down` | string | No | 下跌觸發百分比，`trigger_price_type` 為 `2` 時必填 |
| `grid_trading_rule.trigger_buy_quantity` | string | Yes | 每次觸發買入數量 |
| `grid_trading_rule.trigger_sell_quantity` | string | Yes | 每次觸發賣出數量 |
| `grid_trading_rule.time_in_force` | integer | Yes | 訂單有效期。**可選值：**, `0` - Day（當日有效）, `1` - GTC（撤單前有效）, `6` - GTD（到期前有效） |
| `grid_trading_rule.expire_time` | integer | No | 到期時間（Unix 時間戳，單位秒），`time_in_force` 為 `6`（GTD）時必填 |
| `grid_trading_rule.upper_limit_event` | integer | No | 達到上邊界時的動作。**可選值：**, `1` - ignore（繼續運行）, `2` - 按最新價平倉 |
| `grid_trading_rule.lower_limit_event` | integer | No | 達到下邊界時的動作。**可選值：**, `1` - ignore（繼續運行）, `2` - 按最新價平倉 |
| `grid_trading_rule.trigger_sell_depth` | integer | No | 賣盤盤口檔位（-5 ~ 5）。`0` 表示改用 `grid_order_type_up` 而非檔位 |
| `grid_trading_rule.trigger_buy_depth` | integer | No | 買盤盤口檔位（-5 ~ 5）。`0` 表示改用 `grid_order_type_down` 而非檔位 |
| `grid_trading_rule.grid_order_type_up` | string | No | `trigger_sell_depth` 為 `0` 時的賣盤訂單類型。**可選值：**, `GMO` / `GLO` / `GTG` |
| `grid_trading_rule.grid_order_type_down` | string | No | `trigger_buy_depth` 為 `0` 時的買盤訂單類型。**可選值：**, `GMO` / `GLO` / `GTG` |
| `grid_trading_rule.multiple_trigger` | boolean | No | 單個網格檔位是否允許多次觸發 |
| `grid_trading_rule.support_shortsell` | boolean | No | 是否允許賣空 |
| `grid_trading_rule.rth` | integer | No | 常規交易時段標誌（`0` / `1` / `2`） |

## Request Example

```bash
curl --request POST \
  --url 'https://openapi.longbridge.com/v1/gridtrading/submit' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"symbol":"<symbol>","settlement_currency":"<settlement_currency>","grid_trading_rule":{},"submitted_base_price":"<submitted_base_price>","upper_limit_price":"<upper_limit_price>","lower_limit_price":"<lower_limit_price>","trigger_price_type":0,"trigger_spread_up":"<trigger_spread_up>","trigger_spread_down":"<trigger_spread_down>","trigger_percent_up":"<trigger_percent_up>","trigger_percent_down":"<trigger_percent_down>","trigger_quantity":"<trigger_quantity>","upper_limit_quantity":"<upper_limit_quantity>","lower_limit_quantity":"<lower_limit_quantity>","time_in_force":0,"expire_time":0,"upper_limit_event":0,"lower_limit_event":0,"trigger_sell_depth":0,"trigger_buy_depth":0,"grid_order_type_up":"<grid_order_type_up>","grid_order_type_down":"<grid_order_type_down>","multiple_trigger":false,"support_shortsell":false,"rth":0}'
```

## Response

### Response JSON Example

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