exchange.GetHistoryConditionOrders

exchange.GetHistoryConditionOrders()函数用于获取当前交易对、合约的历史条件单（包括已触发、已取消、已过期的条件单），并支持指定具体的交易品种。

    
    
    
exchange.GetHistoryConditionOrders()

    
    
    
exchange.GetHistoryConditionOrders(symbol)

    
    
    
exchange.GetHistoryConditionOrders(symbol, since)

    
    
    
exchange.GetHistoryConditionOrders(symbol, since, limit)

    
    
    
exchange.GetHistoryConditionOrders(since)

    
    
    
exchange.GetHistoryConditionOrders(since, limit)

示例

• 查询历史条件单，返回的结果按时间升序排列。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      var historyConditionOrders = exchange.GetHistoryConditionOrders()
      Log("Historical condition orders count:", historyConditionOrders.length)
  
      // 遍历并显示，订单按 Time 属性升序排列
      for (var i = 0; i < historyConditionOrders.length; i++) {
          Log("Order", i+1, "Created at:", historyConditionOrders[i].Time,
              "ID:", historyConditionOrders[i].Id,
              "Status:", historyConditionOrders[i].Status)
      }
  }
  

  
      python
      
      
  def main():
      historyConditionOrders = exchange.GetHistoryConditionOrders()
      Log("Historical condition orders count:", len(historyConditionOrders))
  
      # 遍历并显示，订单按 Time 属性升序排列
      for i in range(len(historyConditionOrders)):
          Log("Order", i+1, "Created at:", historyConditionOrders[i]["Time"],
              "ID:", historyConditionOrders[i]["Id"],
              "Status:", historyConditionOrders[i]["Status"])
  

  
      rust
      
      
  fn main() {
      let historyConditionOrders = exchange.GetHistoryConditionOrders(None, None, None).unwrap();
      Log!("Historical condition orders count:", historyConditionOrders.len());
  
      // 遍历并显示，订单按 Time 属性升序排列
      for i in 0..historyConditionOrders.len() {
          Log!("Order", i + 1, "Created at:", historyConditionOrders[i].Time,
              "ID:", historyConditionOrders[i].Id,
              "Status:", historyConditionOrders[i].Status);
      }
  }
  

  
      c++
      
      
  void main() {
      auto historyConditionOrders = exchange.GetHistoryConditionOrders();
      Log("Historical condition orders count:", historyConditionOrders.size());
  
      // 遍历并显示，订单按 Time 属性升序排列
      for (int i = 0; i < historyConditionOrders.size(); i++) {
          Log("Order", i+1, "Created at:", historyConditionOrders[i].Time,
              "ID:", historyConditionOrders[i].Id,
              "Status:", historyConditionOrders[i].Status);
      }
  }
  

• 查询指定交易对的历史条件单，并限制返回的数量。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 查询BTC_USDT交易对最近的10条历史条件单
      var historyConditionOrders = exchange.GetHistoryConditionOrders("BTC_USDT", 0, 10)
      Log("BTC_USDT historical condition orders:", historyConditionOrders)
  }
  

  
      python
      
      
  def main():
      # 查询BTC_USDT交易对最近的10条历史条件单
      historyConditionOrders = exchange.GetHistoryConditionOrders("BTC_USDT", 0, 10)
      Log("BTC_USDT historical condition orders:", historyConditionOrders)
  

  
      rust
      
      
  fn main() {
      // 查询BTC_USDT交易对最近的10条历史条件单
      let historyConditionOrders = exchange.GetHistoryConditionOrders("BTC_USDT", 0, 10);
      Log!("BTC_USDT historical condition orders:", historyConditionOrders);
  }
  

  
      c++
      
      
  void main() {
      // 查询BTC_USDT交易对最近的10条历史条件单
      auto historyConditionOrders = exchange.GetHistoryConditionOrders("BTC_USDT", 0, 10);
      Log("BTC_USDT historical condition orders:", historyConditionOrders);
  }
  

• 按时间范围查询历史条件单。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // 查询从指定时间戳开始的历史条件单
      var startTime = new Date("2024-01-01").getTime()
      var historyConditionOrders = exchange.GetHistoryConditionOrders(startTime, 50)
      Log("Historical condition orders since:", historyConditionOrders)
  }
  

  
      python
      
      
  def main():
      # 查询从指定时间戳开始的历史条件单
      import time
      startTime = int(time.mktime(time.strptime("2024-01-01", "%Y-%m-%d")) * 1000)
      historyConditionOrders = exchange.GetHistoryConditionOrders(startTime, 50)
      Log("Historical condition orders since:", historyConditionOrders)
  

  
      rust
      
      
  fn main() {
      // 查询从指定时间戳开始的历史条件单
      let startTime: i64 = 1704067200000;  // 2024-01-01的时间戳
      // Rust中symbol参数传None表示当前交易对
      let historyConditionOrders = exchange.GetHistoryConditionOrders(None, startTime, 50);
      Log!("Historical condition orders since:", historyConditionOrders);
  }
  

  
      c++
      
      
  void main() {
      // 查询从指定时间戳开始的历史条件单
      auto startTime = 1704067200000;  // 2024-01-01的时间戳
      // C++ 中 symbol 参数不可省略，传 "" 表示当前交易对
      auto historyConditionOrders = exchange.GetHistoryConditionOrders("", startTime, 50);
      Log("Historical condition orders since:", historyConditionOrders);
  }
  

返回值

参数

参考

备注

• 不指定symbol、since、limit参数时，默认查询当前交易对、合约的历史条件单，即查询距离当前时间最近的一定范围内的历史条件单，查询范围取决于交易所接口的单次查询范围。

• 指定symbol参数时，查询所设置交易品种的历史条件单。

• 指定since参数时，以since时间戳为起始时间，向当前时间方向查询。

• 指定limit参数时，在查询到足够条数后返回。

• 该函数仅支持提供历史条件单查询接口的交易所。

历史条件单包括：已触发（转为普通订单）、已取消、已过期等状态的条件单。

返回的历史条件单数组按订单创建时间（Time属性）升序排列，即时间最早的订单位于数组前面，时间最晚的订单位于数组后面。

对条件单功能的支持情况取决于具体的交易所，部分交易所可能不支持条件单功能或历史条件单查询功能。