# 修改網格訂單

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