exchange.ModifyConditionOrder

exchange.ModifyConditionOrder()函数用于修改现有的条件单，可修改条件单的下单量、触发条件和执行价格。支持通过附加参数修改条件单的其它属性（具体取决于交易所API的支持情况）。

    
    
    
exchange.ModifyConditionOrder(orderId, side, amount, condition)

示例

• 修改条件单的数量和触发条件。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 创建一个止盈条件单
      var condition = {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 77,
          TpOrderPrice: 76
      }
      var id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition)
      Log("Original Condition Order ID:", id)
      Sleep(2000)
  
      // 查询原始条件单信息
      var order = exchange.GetConditionOrder(id)
      Log("Original Condition Order Info:", order)
      Sleep(1000)
  
      // 修改条件单的数量和触发条件
      var newCondition = {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 75,
          TpOrderPrice: 71
      }
      var newId = exchange.ModifyConditionOrder(id, "buy", 2, newCondition)
      Log("Modified Condition Order ID:", newId)
      Sleep(2000)
  
      // 查询修改后的条件单信息
      var newOrder = exchange.GetConditionOrder(newId)
      Log("Modified Condition Order Info:", newOrder)
  
      // 取消条件单
      exchange.CancelConditionOrder(newId)
  }
  

  
      python
      
      
  def main():
      # 创建一个止盈条件单
      condition = {
          "ConditionType": ORDER_CONDITION_TYPE_TP,
          "TpTriggerPrice": 77,
          "TpOrderPrice": 76
      }
      id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition)
      Log("Original Condition Order ID:", id)
      Sleep(2000)
  
      # 查询原始条件单信息
      order = exchange.GetConditionOrder(id)
      Log("Original Condition Order Info:", order)
      Sleep(1000)
  
      # 修改条件单的数量和触发条件
      newCondition = {
          "ConditionType": ORDER_CONDITION_TYPE_TP,
          "TpTriggerPrice": 75,
          "TpOrderPrice": 71
      }
      newId = exchange.ModifyConditionOrder(id, "buy", 2, newCondition)
      Log("Modified Condition Order ID:", newId)
      Sleep(2000)
  
      # 查询修改后的条件单信息
      newOrder = exchange.GetConditionOrder(newId)
      Log("Modified Condition Order Info:", newOrder)
  
      # 取消条件单
      exchange.CancelConditionOrder(newId)
  

  
      rust
      
      
  fn main() {
      // 创建一个止盈条件单
      let condition = OrderCondition {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 77.0,
          TpOrderPrice: 76.0,
          ..Default::default()
      };
      let id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, &condition).unwrap();
      Log!("Original Condition Order ID:", id);
      Sleep(2000);
  
      // 查询原始条件单信息
      let order = exchange.GetConditionOrder(&id);
      Log!("Original Condition Order Info:", order);
      Sleep(1000);
  
      // 修改条件单的数量和触发条件
      let newCondition = OrderCondition {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 75.0,
          TpOrderPrice: 71.0,
          ..Default::default()
      };
      let newId = exchange.ModifyConditionOrder(&id, "buy", 2, &newCondition).unwrap();
      Log!("Modified Condition Order ID:", newId);
      Sleep(2000);
  
      // 查询修改后的条件单信息
      let newOrder = exchange.GetConditionOrder(&newId);
      Log!("Modified Condition Order Info:", newOrder);
  
      // 取消条件单
      let _ = exchange.CancelConditionOrder(&newId);
  }
  

  
      c++
      
      
  void main() {
      // 创建一个止盈条件单
      OrderCondition condition = {.ConditionType = ORDER_CONDITION_TYPE_TP, .TpTriggerPrice = 77, .TpOrderPrice = 76};
      auto id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition);
      Log("Original Condition Order ID:", id);
      Sleep(2000);
  
      // 查询原始条件单信息
      auto order = exchange.GetConditionOrder(id);
      Log("Original Condition Order Info:", order);
      Sleep(1000);
  
      // 修改条件单的数量和触发条件
      OrderCondition newCondition = {.ConditionType = ORDER_CONDITION_TYPE_TP, .TpTriggerPrice = 75, .TpOrderPrice = 71};
      auto newId = exchange.ModifyConditionOrder(id, "buy", 2, newCondition);
      Log("Modified Condition Order ID:", newId);
      Sleep(2000);
  
      // 查询修改后的条件单信息
      auto newOrder = exchange.GetConditionOrder(newId);
      Log("Modified Condition Order Info:", newOrder);
  
      // 取消条件单
      exchange.CancelConditionOrder(newId);
  }
  

• 使用附加参数（option）修改条件单的触发价格类型。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 创建一个止盈条件单
      var condition = {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 77,
          TpOrderPrice: 76
      }
      var id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition)
      Log("Original Condition Order ID:", id)
      Sleep(2000)
  
      // 修改条件单，并将触发价格类型设置为指数价格（index）
      // 通过 side 参数传递附加参数（JSON 格式）
      var option = {"newTpTriggerPxType": "index"}
      var sideWithOption = "buy;" + JSON.stringify(option)
  
      var newCondition = {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 75,
          TpOrderPrice: 71
      }
      var newId = exchange.ModifyConditionOrder(id, sideWithOption, 2, newCondition)
      Log("Modified Condition Order ID:", newId)
      Sleep(2000)
  
      // 查询修改后的条件单信息
      var newOrder = exchange.GetConditionOrder(newId)
      Log("Modified Condition Order Info:", newOrder)
  
      // 取消条件单
      exchange.CancelConditionOrder(newId)
  }
  

  
      python
      
      
  import json
  
  def main():
      # 创建一个止盈条件单
      condition = {
          "ConditionType": ORDER_CONDITION_TYPE_TP,
          "TpTriggerPrice": 77,
          "TpOrderPrice": 76
      }
      id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition)
      Log("Original Condition Order ID:", id)
      Sleep(2000)
  
      # 修改条件单，并将触发价格类型设置为指数价格（index）
      # 通过 side 参数传递附加参数（JSON 格式）
      option = {"newTpTriggerPxType": "index"}
      sideWithOption = "buy;" + json.dumps(option)
  
      newCondition = {
          "ConditionType": ORDER_CONDITION_TYPE_TP,
          "TpTriggerPrice": 75,
          "TpOrderPrice": 71
      }
      newId = exchange.ModifyConditionOrder(id, sideWithOption, 2, newCondition)
      Log("Modified Condition Order ID:", newId)
      Sleep(2000)
  
      # 查询修改后的条件单信息
      newOrder = exchange.GetConditionOrder(newId)
      Log("Modified Condition Order Info:", newOrder)
  
      # 取消条件单
      exchange.CancelConditionOrder(newId)
  

  
      rust
      
      
  fn main() {
      // 创建一个止盈条件单
      let condition = OrderCondition {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 77.0,
          TpOrderPrice: 76.0,
          ..Default::default()
      };
      let id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, &condition).unwrap();
      Log!("Original Condition Order ID:", id);
      Sleep(2000);
  
      // 修改条件单，并将触发价格类型设置为指数价格（index）
      // 通过 side 参数传递附加参数（JSON 格式；Rust 无 JSON 序列化，故直接使用原始字符串构造）
      let sideWithOption = r#"buy;{"newTpTriggerPxType": "index"}"#;
  
      let newCondition = OrderCondition {
          ConditionType: ORDER_CONDITION_TYPE_TP,
          TpTriggerPrice: 75.0,
          TpOrderPrice: 71.0,
          ..Default::default()
      };
      let newId = exchange.ModifyConditionOrder(&id, sideWithOption, 2, &newCondition).unwrap();
      Log!("Modified Condition Order ID:", newId);
      Sleep(2000);
  
      // 查询修改后的条件单信息
      let newOrder = exchange.GetConditionOrder(&newId);
      Log!("Modified Condition Order Info:", newOrder);
  
      // 取消条件单
      let _ = exchange.CancelConditionOrder(&newId);
  }
  

  
      c++
      
      
  void main() {
      // 创建一个止盈条件单
      OrderCondition condition = {.ConditionType = ORDER_CONDITION_TYPE_TP, .TpTriggerPrice = 77, .TpOrderPrice = 76};
      auto id = exchange.CreateConditionOrder("SOL_USDT.swap", "buy", 1, condition);
      Log("Original Condition Order ID:", id);
      Sleep(2000);
  
      // 修改条件单，并将触发价格类型设置为指数价格（index）
      // 通过 side 参数传递附加参数（JSON 格式）
      json option = R"({"newTpTriggerPxType": "index"})"_json;
      string sideWithOption = "buy;" + option.dump();
  
      OrderCondition newCondition = {.ConditionType = ORDER_CONDITION_TYPE_TP, .TpTriggerPrice = 75, .TpOrderPrice = 71};
      auto newId = exchange.ModifyConditionOrder(id, sideWithOption, 2, newCondition);
      Log("Modified Condition Order ID:", newId);
      Sleep(2000);
  
      // 查询修改后的条件单信息
      auto newOrder = exchange.GetConditionOrder(newId);
      Log("Modified Condition Order Info:", newOrder);
  
      // 取消条件单
      exchange.CancelConditionOrder(newId);
  }
  

返回值

参数

参考

备注

exchange.ModifyConditionOrder()函数返回的条件单ID因交易所API实现的不同而可能表现出不同行为。有些交易所API返回的条件单ID会更新，有些则保持不变。建议使用返回的新条件单ID进行后续操作。

exchange.ModifyConditionOrder()函数不会依据交易所接口规则校验参数的有效性，而是将参数直接提交给交易所API。传入无效参数时（如数量为-1），该参数可能会被交易所忽略，条件单保持原有属性不变。

支持通过side参数传递附加参数（option），用于修改条件单的其它属性。附加参数需要与side参数合并传入，格式为"side;{JSON对象}"（推荐）或"side;key=value"（URL编码格式）。例如修改触发价格类型："buy;{\"newTpTriggerPxType\":\"index\"}"。

对于条件单的市价单修改，需要具体查看交易所API是否支持。将condition参数中的TpOrderPrice或SlOrderPrice设置为-1表示市价单。

修改条件单时，条件单的其它属性（如条件类型、持仓模式、账户模式、杠杆等）通常会保留原条件单的设置。如需修改这些属性，可以通过附加参数（option）传入，前提是交易所API支持。

可以通过附加参数修改触发价格类型，例如将触发价格类型从最新价（last）修改为指数价格（index）或标记价格（mark）。具体的参数名称和支持情况取决于交易所API文档。

修改条件单功能的支持情况取决于具体交易所，部分交易所可能不支持修改条件单功能，或仅支持修改部分参数。使用前请查阅对应交易所的API文档。