exchange.GetDepth

获取当前设置的交易对、合约代码所对应的现货或合约的Depth结构，即订单簿数据。

    
    
    
exchange.GetDepth()

    
    
    
exchange.GetDepth(symbol)

示例

• 测试exchange.GetDepth()函数：

  • javascript
  • python
  • rust
  • cpp

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

  
      python
      
      
  def main():
      depth = exchange.GetDepth()
      price = depth["Asks"][1]["Price"]
      Log("Second ask price:", price)
  

  
      rust
      
      
  fn main() {
      let depth = exchange.GetDepth(None).unwrap();
      let price = depth.Asks[1].Price;
      Log!("Second ask price:", price);
  }
  

  
      c++
      
      
  void main() {
      auto depth = exchange.GetDepth();
      auto price = depth.Asks[1].Price;
      Log("Second ask price:", price);
  }
  

• 当配置的exchange对象为期货交易所对象时，使用symbol参数请求指定品种（期货品种）的订单簿数据。

  • javascript
  • python
  • rust
  • cpp

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

  
      python
      
      
  def main():
      depth = exchange.GetDepth("BTC_USDT.swap")
      Log(depth)
  

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

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

返回值

参数

参考

备注

回测系统中，使用模拟级 Tick回测时，exchange.GetDepth()函数返回数据的各档位均为模拟值。

回测系统中，使用实盘级 Tick回测时，exchange.GetDepth()函数返回的数据为秒级别的深度快照。