exchange.GetTrades

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

    
    
    
exchange.GetTrades()

    
    
    
exchange.GetTrades(symbol)

示例

• 获取当前交易对的最近成交，打印第一条记录。

  • javascript
  • python
  • rust

  
      javascript
      
      
  function main(){
      var trades = exchange.GetTrades()
      if (!trades || trades.length == 0) return    // 获取失败时为null，没有成交时为空数组
      var t = trades[0]
      Log("Id:", t.Id, "Time:", t.Time, "Price:", t.Price, "Amount:", t.Amount, "Type:", t.Type)
  }
  

  
      python
      
      
  def main():
      trades = exchange.GetTrades()
      if not trades:
          return
      t = trades[0]
      Log("Id:", t["Id"], "Time:", t["Time"], "Price:", t["Price"],
          "Amount:", t["Amount"], "Type:", t["Type"])
  

  
      rust
      
      
  fn main() {
      let Ok(trades) = exchange.GetTrades(None) else { return };
      let Some(t) = trades.first() else { return };
      Log!("Id:", t.Id, "Time:", t.Time, "Price:", t.Price, "Amount:", t.Amount, "Type:", t.Type);
  }
  

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

  • javascript
  • python
  • rust

  
      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);
  }
  

返回值

参数

参考

备注

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

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

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

不支持的交易所：Futures_EdgeX、Pendle、KyberSwap、OneInch、Jupiter、Futures_IB、Web3。调用时报错并返回空值，所有交易所的对照见能力矩阵。