# 修改网格订单

`POST` `/v1/gridtrading/replace`

修改已存在的网格订单规则。提交的 `grid_trading_rule` 会整体替换原有规则，因此需要传入完整的规则，而不是仅传改动的字段。

## Parameters

### Request Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `order_id` | string | Yes | 网格订单 ID，例如：`764609681686573056` |
| `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` - 价差（绝对值）, `2` - 百分比 |
| `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` - 当日有效，`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` - 忽略（保持运行）, `2` - 以最新价平仓 |
| `grid_trading_rule.lower_limit_event` | integer | No | 到达下边界时的动作。**可选值：**, `1` - 忽略（保持运行）, `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/replace' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{"order_id":"<order_id>","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": {}
}
```
