exchange.GetTicker

Retrieves the Ticker structure (i.e., the market data) corresponding to the spot or contract of the currently configured trading pair and contract code. The GetTicker() function is a member function of the exchange object exchange. The purpose of the member functions (methods) of the exchange object is related only to exchange, which will not be repeated in the subsequent documentation.

    
    
    
exchange.GetTicker()

    
    
    
exchange.GetTicker(symbol)

Examples

• For a futures exchange object (i.e., exchange or exchanges[0]), you need to first use the exchange.SetContractType() function to set the contract code before calling the market data functions, which will not be repeated in the subsequent documentation.

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main(){
      // If it is a futures exchange object, first set the contract code, for example, set it to a perpetual contract
      // exchange.SetContractType("swap")
  
      var ticker = exchange.GetTicker()
      /*
          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, ticker is null, and accessing ticker.High will cause an error, so when testing this code, make sure the exchange interface is accessible
      */
      Log("Symbol:", ticker.Symbol, "High:", ticker.High, "Low:", ticker.Low, "Sell:", ticker.Sell, "Buy:", ticker.Buy, "Last:", ticker.Last, "Open:", ticker.Open, "Volume:", ticker.Volume)
  }
  

  
      python
      
      
  def main():
      ticker = exchange.GetTicker()
      Log("Symbol:", ticker["Symbol"], "High:", ticker["High"], "Low:", ticker["Low"], "Sell:", ticker["Sell"], "Buy:", ticker["Buy"], "Last:", ticker["Last"], "Open:", ticker["Open"], "Volume:", ticker["Volume"])
  

  
      rust
      
      
  fn main() {
      // If it is a futures exchange object, first set the contract code, for example, set it to a perpetual contract
      // exchange.SetContractType("swap").unwrap();
  
      let ticker = exchange.GetTicker(None).unwrap();
      Log!("Symbol:", ticker.Symbol, "High:", ticker.High, "Low:", ticker.Low, "Sell:", ticker.Sell, "Buy:", ticker.Buy, "Last:", ticker.Last, "Open:", ticker.Open, "Volume:", ticker.Volume);
  }
  

  
      c++
      
      
  void main() {
      auto ticker = exchange.GetTicker();
      Log("Symbol:", ticker.Symbol, "High:", ticker.High, "Low:", ticker.Low, "Sell:", ticker.Sell, "Buy:", ticker.Buy, "Last:", ticker.Last, "Open:", ticker.Open, "Volume:", ticker.Volume);
  }
  

• Use the symbol parameter to request market data of a specific instrument (spot instrument).

  • javascript
  • python
  • rust
  • cpp

  
      javascript
      
      
  function main() {
      var ticker = exchange.GetTicker("BTC_USDT")
      Log(ticker)
  }
  

  
      python
      
      
  def main():
      ticker = exchange.GetTicker("BTC_USDT")
      Log(ticker)
  

  
      rust
      
      
  fn main() {
      let ticker = exchange.GetTicker("BTC_USDT").unwrap();
      Log!(ticker);
  }
  

  
      c++
      
      
  void main() {
      auto ticker = exchange.GetTicker("BTC_USDT");
      Log(ticker);
  }
  

Returns

Arguments

See Also

Remarks

In the backtesting system, in the Ticker data returned by the exchange.GetTicker() function, High and Low are simulated values, taken from the best ask price and best bid price of the order book at that time.

In live trading, in the Ticker data returned by the exchange.GetTicker() function, the values of High and Low are determined based on the data returned by the wrapped exchange's Tick interface. This data contains the highest price and lowest price within a certain period (usually a 24-hour period).

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