exchange.GetTrades

Gets the Trade structure array of the spot or futures corresponding to the currently set trading pair and contract code, i.e. the market's trade (tick) data.

    
    
    
exchange.GetTrades()

    
    
    
exchange.GetTrades(symbol)

Examples

• Test the exchange.GetTrades() function:

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main(){
      var trades = exchange.GetTrades()
      /*
          Due to network reasons, the exchange interface may be inaccessible (even if the device where the docker program is located can open the exchange website, the API interface may still be unreachable)
          In this case trades is null, and accessing trades[0].Id will cause an error, so when testing this code, make sure the exchange interface is accessible
      */
      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);
  }
  

• When the configured exchange object is a futures exchange object, use the symbol parameter to request the market trade record data of a specific instrument (futures instrument).

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      // BTC's USDT-margined perpetual contract
      var trades = exchange.GetTrades("BTC_USDT.swap")
      Log(trades)
  }
  

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

  
      rust
      
      
  fn main() {
      // BTC's USDT-margined perpetual contract
      let trades = exchange.GetTrades("BTC_USDT.swap").unwrap();
      Log!(trades);
  }
  

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

Returns

Arguments

See Also

Remarks

The exchange.GetTrades() function is used to get the trade history (not your own trades) of the market corresponding to the current trading pair and contract. Some exchanges do not support this function, and the specific range of trade records returned varies from exchange to exchange, which needs to be handled according to the actual situation. The returned data is an array, in which the time order of each element is consistent with the order of the data returned by the exchange.GetRecords() function, i.e. the last element of the array is the data closest to the current time.

In the backtesting system, when backtesting with simulation-level Tick, the exchange.GetTrades() function returns an empty array.

In the backtesting system, when backtesting with **live-trading-level Tick**, the data returned by the exchange.GetTrades() function is order flow snapshot data, i.e. the Trade structure array.

Exchanges that do not support the exchange.GetTrades() function: