exchange.IO(mode, value)

切换交易所的交易模式，包括模拟盘/实盘、全仓/逐仓、双向/单向持仓、统一账户、杠杆模式及自成交预防等。

    
    
    
exchange.IO(mode)

    
    
    
exchange.IO(mode, value)

示例

• 切换模拟盘/实盘环境（以Futures_OKCoin（OKX期货）为例）。

  • javascript
  • python
  • rust

  
      javascript
      
      
  function main() {
      exchange.IO("simulate", true)    // Switch to demo trading environment
      // ... trading logic ...
      exchange.IO("simulate", false)   // Switch back to live trading environment
  }
  

  
      python
      
      
  def main():
      exchange.IO("simulate", True)
      # ... trading logic ...
      exchange.IO("simulate", False)
  

  
      rust
      
      
  fn main() {
      let _ = exchange.IO(("simulate", true));    // Switch to demo trading environment
      // ... trading logic ...
      let _ = exchange.IO(("simulate", false));   // Switch back to live trading environment
  }
  

• 切换合约的保证金模式和持仓模式（以币安期货为例）。

  • javascript
  • python
  • rust

  
      javascript
      
      
  function main() {
      exchange.IO("dual", true)    // Switch to hedge mode (dual position)
      exchange.IO("dual", false)   // Switch to one-way mode
  
      exchange.SetContractType("swap")
      exchange.IO("cross", true)    // Switch to cross margin
      exchange.IO("cross", false)   // Switch to isolated margin
  }
  

  
      python
      
      
  def main():
      exchange.IO("dual", True)
      exchange.IO("dual", False)
  
      exchange.SetContractType("swap")
      exchange.IO("cross", True)
      exchange.IO("cross", False)
  

  
      rust
      
      
  fn main() {
      let _ = exchange.IO(("dual", true));    // Switch to hedge mode (dual position)
      let _ = exchange.IO(("dual", false));   // Switch to one-way mode
  
      let _ = exchange.SetContractType("swap");
      let _ = exchange.IO(("cross", true));    // Switch to cross margin
      let _ = exchange.IO(("cross", false));   // Switch to isolated margin
  }
  

• 切换统一账户模式（以币安期货为例）。

  • javascript
  • python
  • rust

  
      javascript
      
      
  function main() {
      exchange.IO("unified", true)   // Switch to unified account mode
      exchange.IO("unified", false)  // Switch to normal mode
  }
  

  
      python
      
      
  def main():
      exchange.IO("unified", True)
      exchange.IO("unified", False)
  

  
      rust
      
      
  fn main() {
      let _ = exchange.IO(("unified", true));   // Switch to unified account mode
      let _ = exchange.IO(("unified", false));  // Switch to normal mode
  }
  

• 设置自成交预防（STP）模式（以币安为例）。

  • javascript
  • python
  • rust

  
      javascript
      
      
  function main() {
      // "NONE" means disable STP mode, other parameters: "EXPIRE_TAKER", "EXPIRE_MAKER", "EXPIRE_BOTH"
      exchange.IO("selfTradePreventionMode", "NONE")
  }
  

  
      python
      
      
  def main():
      exchange.IO("selfTradePreventionMode", "NONE")
  

  
      rust
      
      
  fn main() {
      // "NONE" means disable STP mode, other parameters: "EXPIRE_TAKER", "EXPIRE_MAKER", "EXPIRE_BOTH"
      let _ = exchange.IO(("selfTradePreventionMode", "NONE"));
  }
  

返回值

参数

参考

备注

通用交易模式指令

以下指令在多个交易所中通用。各交易所支持哪些指令见能力矩阵；取值含义、是否按合约生效以及返回值的差异，见各交易所页面。

模拟盘

支持模拟盘的交易所在添加时的配置中提供“模拟盘”勾选项。勾选后，该交易所对象自启动起即连接模拟盘（测试网），策略无需再切换。支持的交易所包括：币安现货与期货、Bybit现货与期货、OKX现货与期货、Bitget现货与期货、Gate.io现货与期货、Futures_DigiFinex、Hyperliquid现货与期货（测试网）、Futures_Lighter、富途（模拟交易账户）。

exchange.IO("simulate", true/false)仍可在运行中切换模拟盘/实盘，用于兼容旧策略（支持的交易所见下方各指令的支持表）；新策略应以添加交易所时的勾选为准。DigiFinex现货交易所本身不提供模拟环境。