exchange.GetTrades

获取当前设置的交易对、合约代码所对应的现货或合约的Trade结构数组，即市场的成交数据。

    
    
    
exchange.GetTrades()

    
    
    
exchange.GetTrades(symbol)

示例

• 测试exchange.GetTrades()函数：

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main(){
      var trades = exchange.GetTrades()
      /*
          可能由于网络原因，访问不到交易所接口（即使托管者程序所在设备能打开交易所网站，但是API接口也可能访问不通）
          此时trades为null，当访问trades[0].Id时，会导致错误，所以在测试该代码时，确保可以访问到交易所接口
      */
      Log("id:", trades[0].Id, "time:", trades[0].Time, "Price:", trades[0].Price, "Amount:", trades[0].Amount, "type:", trades[0].Type)
  }
  

  
      python
      
      
  def main():
      trades = exchange.GetTrades()
      Log("id:", trades[0]["Id"], "time:", trades[0]["Time"], "Price:", trades[0]["Price"], "Amount:", trades[0]["Amount"], "type:", trades[0]["Type"])
  

  
      rust
      
      
  fn main() {
      let trades = exchange.GetTrades(None).unwrap();
      Log!("id:", trades[0].Id, "time:", trades[0].Time, "Price:", trades[0].Price, "Amount:", trades[0].Amount, "type:", trades[0].Type);
  }
  

  
      c++
      
      
  void main() {
      auto trades = exchange.GetTrades();
      Log("id:", trades[0].Id, "time:", trades[0].Time, "Price:", trades[0].Price, "Amount:", trades[0].Amount, "type:", trades[0].Type);
  }
  

• 当配置的exchange对象为期货交易所对象时，使用symbol参数请求具体品种（期货品种）的市场成交记录数据。

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // BTC的U本位永续合约
      var trades = exchange.GetTrades("BTC_USDT.swap")
      Log(trades)
  }
  

  
      python
      
      
  def main():
      trades = exchange.GetTrades("BTC_USDT.swap")
      Log(trades)
  

  
      rust
      
      
  fn main() {
      // BTC的U本位永续合约
      let trades = exchange.GetTrades("BTC_USDT.swap").unwrap();
      Log!(trades);
  }
  

  
      c++
      
      
  void main() {
      auto trades = exchange.GetTrades("BTC_USDT.swap");
      Log(trades);
  }
  

返回值

参数

参考

备注

exchange.GetTrades()函数用于获取当前交易对、合约所对应市场的成交历史（非自身成交）。部分交易所不支持该函数，且具体返回的成交记录范围因交易所而异，需要根据实际情况处理。返回数据为一个数组，其中每个元素的时间顺序与exchange.GetRecords()函数的返回数据顺序一致，即数组的最后一个元素为距离当前时间最近的数据。

在回测系统中，使用模拟级 Tick回测时，exchange.GetTrades()函数返回空数组。

在回测系统中，使用**实盘级 Tick**回测时，exchange.GetTrades()函数返回的数据为订单流快照数据，即Trade结构数组。

不支持exchange.GetTrades()函数的交易所：