# 提交网格订单

`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"
  }
}
```
