证券与期货

富途证券

支持富途牛牛的实盘交易和模拟交易，需要在托管者所在的机器上运行FutuOpenD。配置交易所对象、运行FutuOpenD等操作参看富途证券配置说明文档。

使用FutuOpenD接入模拟交易时，有些股票代码不支持，因而无法交易（富途牛牛手机App上可以模拟交易）。

• 接口调用频率
  GetOrder、GetOrders、GetPositions、GetAccount默认使用缓存数据，不限制调用频率；FutuOpenD收到新数据时会自动更新缓存。
  调用exchange.IO("refresh", true)可以禁用缓存，禁用后的调用频率为每30秒内最多10次查询，超过会报错。

• 股票代码
  格式为代码.市场，例如600519.SH。市场后缀：

  • HK：港股
  • US：美股
  • SH：沪市
  • SZ：深市
  • SG：新加坡期货
  • JP：日本期货

  在策略中用exchange.SetContractType()设置股票代码，例如：

  • Javascript
  • Python
  • Rust

  
              javascript
              
              
  function main() {
      var info = exchange.SetContractType("600519.SH")    // 设置为股票600519.SH（贵州茅台），账户切换到A股市场
      Log(info)
      Log(exchange.GetAccount())                          // 当前股票是茅台，GetAccount返回A股市场的账户资产
      Log(exchange.GetTicker())                           // 获取茅台的当前行情
  }
  

  
              python
              
              
  def main():
      info = exchange.SetContractType("600519.SH")
      Log(info)
      Log(exchange.GetAccount())
      Log(exchange.GetTicker())
  

  
              rust
              
              
  fn main() {
      let info = exchange.SetContractType("600519.SH");    // 设置为股票600519.SH（贵州茅台），账户切换到A股市场
      Log!(info);
      Log!(exchange.GetAccount());                          // 当前股票是茅台，GetAccount返回A股市场的账户资产
      Log!(exchange.GetTicker(None));                       // 获取茅台的当前行情
  }
  

  设置交易方向的exchange.SetDirection、下单的exchange.Buy/exchange.Sell、撤单的exchange.CancelOrder、查询订单的exchange.GetOrder等函数，用法与期货市场相同。

• 账户信息
  富途用TrdMarket区分香港市场、美国市场、大陆市场等。以下摘自Futu API文档：

  
              mylang
              
              
  const (
      TrdMarket_TrdMarket_Unknown TrdMarket = 0 // 未知市场
      TrdMarket_TrdMarket_HK      TrdMarket = 1 // 香港市场
      TrdMarket_TrdMarket_US      TrdMarket = 2 // 美国市场
      TrdMarket_TrdMarket_CN      TrdMarket = 3 // 大陆市场
      TrdMarket_TrdMarket_HKCC    TrdMarket = 4 // 香港A股通市场
      TrdMarket_TrdMarket_Futures TrdMarket = 5 // 期货市场
  )
  

  exchange.GetAccount()返回的数据：

  
              json
              
              
  {
      "Info": [{
          "Header": {
              ...                 // 省略
              "TrdMarket": 1      // Info原始数据中的市场ID，表示香港市场的账户资产
          },
          "Funds": {              // 该市场的账户资产信息
              ...
          }
      }, ...],
      "Stocks": 0,
      "FrozenStocks": 0,
      "Balance": 1000000,         // 当前市场的资产
      "FrozenBalance": 0
  }
  

• FutuOpenD按登录的IP地址区分地区，非大陆IP登录的账户获取行情时有所限制，具体查阅FutuOpenD（富途）官方文档。

盈透证券（Interactive Brokers）

• 配置交易所
  需要在托管者所在的机器上运行「IB Gateway」或「TWS（Trader Workstation）」。以TWS为例：登录后点击右上角的配置按钮，选择「配置」→「API」→「设置」，不要勾选「只读API」，勾选「启用ActiveX和套接字客户端」，并记下「套接字端口」（TWS默认实盘7496、模拟盘7497；IB Gateway默认实盘4001、模拟盘4002）。
  然后在平台的交易所添加页面选择盈透证券（Interactive Brokers）：

  • 服务器地址：TWS或IB Gateway的地址和端口，例如localhost:7496。
  • 行情类型：实时数据、冻结数据、延迟数据、延迟冻结数据之一。没有订阅实时行情的账户可以选择延迟数据。运行中也可以用exchange.IO("marketDataType", n)切换（n为1到4，顺序同上）。

• 合约代码
  用exchange.SetContractType()设置，格式为代码.货币[.类型[.交易所]]，类型缺省为股票STK，交易所缺省为SMART：

  • 美股：AAPL.US、TSLA.US（US表示美元计价）。
  • 港股：代码.HK（HK表示港币计价）。
  • 期货（FUT）：代码-到期月份[-乘数].货币.FUT.交易所，到期月份写成YYYYMM，交易所为IB的交易所代码。
  • 期权（OPT）与期货期权（FOP）：代码-到期-C或P-行权价×100[-乘数].货币.OPT或FOP.交易所，行权价乘以100后写成整数。
  • 纯数字：直接作为IB的合约ID（conId）。

• 其它说明

  • 托管者以实盘ID作为连接TWS的客户端号（clientId），实盘重启后客户端号不变，仍可撤销、修改此前挂出的订单。TWS只允许订单的原始客户端号（或主客户端）修改、撤销订单。
  • 持仓、订单的Symbol是简写形式（如Z74.SGD），exchange.GetPositions()、exchange.GetOrders()传入简写或下单时用的完整代码（如Z74.SGD.STK.SGX）都可以。
  • 订单被网关拒绝时，订单Info中的Reject字段记录拒单原因。
  • exchange.IO("debug", true)开启后，与TWS收发的每一帧按TWS API日志的格式输出到日志，便于与网关日志对照排查。

加密货币

• Futures_Binance
  支持币安的中文交易对：

  
              javascript
              
              
  function main() {
      let ticker = exchange.GetTicker("币安人生_USDT.swap")
      Log("ticker:", ticker)   // {"Info":{...},"Symbol":"币安人生_USDT.swap","Open":0.29622,"High":0.31661, ...}
  }
  

  币安期货的exchange.IO()切换功能（双向持仓、逐仓/全仓、统一账户、STP模式等）见exchange.IO。

• Futures_HuobiDM
  使用exchange.IO("base", "https://xxx.xxx.xxx")或exchange.SetBase("https://xxx.xxx.xxx")切换交易所接口的基地址。

  火币期货的exchange.IO()切换功能（signHost、逐仓/全仓、单向/双向持仓、统一账户等）见exchange.IO。

  条件单不支持OCO类型（ORDER_CONDITION_TYPE_OCO）；多资产保证金模式下同样可以使用条件单。

• Huobi
  支持火币的中文交易对：

  
              javascript
              
              
  function main() {
      let ticker = exchange.GetTicker("币安人生_USDT")
      Log("ticker:", ticker)   // {"Info":{...},"Symbol":"币安人生_USDT","Open":0.29622,"High":0.31661, ...}
  }
  

• Bitfinex
  现货市价买单的下单量是交易币数，不是金额。

• AscendEx
  现货市价买单的下单量是交易币数，不是金额。

• Futures_Hyperliquid
  参考Hyperliquid 使用指南。

  Hyperliquid期货的exchange.IO()切换功能（逐仓/全仓、主网/测试网、vaultAddress、walletAddress、expiresAfter等）见exchange.IO。

• Futures_Lighter
  测试环境可以在配置交易所对象时勾选，也可以用exchange.SetBase()修改REST API端点切换到测试环境。

  Futures_Lighter的exchange.IO()切换功能（逐仓/全仓、订单过期时间等）见exchange.IO。

  exchange.GetTickers()返回的Buy、Sell是各品种的最新成交价（交易所没有批量盘口接口）；需要买一、卖一价时用exchange.GetTicker()或exchange.GetDepth()。

• Futures_edgeX
  edgeX的永续合约都以USDC计价，交易对写作BTC_USDC等，完整代码形如BTC_USDC.swap；写成BTC_USDT、BTC_USD会提示合约不存在。

• Poloniex
  现货条件单只支持止损（ORDER_CONDITION_TYPE_SL）：买单在价格涨到触发价时触发，卖单在价格跌到触发价时触发。止盈（ORDER_CONDITION_TYPE_TP）和OCO条件单会直接报错，不会下单。

一键租用托管者

在托管者部署页面点击一键租用托管者标签，根据配置、服务器机房地区等需求选择需要部署的服务器。

点击「立即购买」并输入当前发明者量化交易平台的账号密码进行验证，验证通过后将自动进行托管者程序部署。整个部署过程需要几分钟时间，系统会自动安装常用的Python库。

点击「立即购买」后租用的服务器由于是通过平台代为租用，仅具有有限的系统权限，不支持远程登录。如果需要使用未预装的第三方Python库，建议使用私有服务器进行手动部署。

通过一键租用托管者功能租用的服务器采用独立计费方式，与实盘计费相互独立。

点击「重新部署」按钮不会删除托管者目录下logs目录中的实盘日志和数据文件。

手动部署托管者

可以把托管者部署在个人电脑、服务器、树莓派（64位系统）等设备上。托管者只发布64位版本：

• Linux命令行版：x86_64（amd64）、ARM64（aarch64）
• macOS命令行版：Intel、Apple Silicon
• Windows：x64、ARM64，各有命令行版和界面版

在托管者部署页面点击手动部署托管者，按系统下载对应的托管者程序并解压，可执行文件robot即托管者程序。同一页面还显示部署需要的两项信息：

1. 通信地址：包含账号UID，形如node.fmz.com/123456。
2. 密码：UID对应的发明者量化交易平台账号的密码。

Windows界面版
运行robot.exe，在界面上填写通信地址和密码，点击启动。

命令行版

            bash
            
            
chmod +x robot                      # Linux/macOS 首次运行前加上执行权限
./robot -s node.fmz.com/123456      # 启动后提示输入密码，输入时不回显

123456只是示例，实际的通信地址在托管者部署页面查看。不要用-p在命令行里写明文密码，它会留在shell历史和进程列表里；需要无人值守启动时，把地址和密码写进只有自己可读的配置文件robot.conf：

            bash
            
            
cat > robot.conf <<'EOF'
s=node.fmz.com/123456
p=你的密码
EOF
chmod 600 robot.conf
./robot -c robot.conf               # 启动目录下有robot.conf时，直接 ./robot 也会自动加载

全部参数和配置文件格式见命令行参数。

在后台运行
托管者忽略终端挂断信号：在SSH里前台启动后直接断开连接，托管者会继续运行，运行日志同时写在logs/docker.log。需要开机自启或崩溃后自动拉起时，可以用systemd等服务管理器运行，例如/etc/systemd/system/robot.service：

            ini
            
            
[Unit]
Description=FMZ robot
After=network-online.target
Wants=network-online.target

[Service]
WorkingDirectory=/opt/robot
ExecStart=/opt/robot/robot -c /opt/robot/robot.conf
Restart=on-failure
TimeoutStopSec=90

[Install]
WantedBy=multi-user.target

            bash
            
            
sudo systemctl daemon-reload
sudo systemctl enable --now robot

systemctl stop robot发送的SIGTERM会让托管者优雅退出：先停止其上的所有实盘、上报状态，再从平台下线。TimeoutStopSec留出足够的时间，避免收尾未完成就被强制结束。

**升级托管者**
策略运行时和交易所连接器由平台按需下发，不需要手动更新。升级托管者程序本身：先停止托管者（见托管者操作注意事项），用新版本替换robot可执行文件，再在同一工作目录启动。工作目录下的logs目录保留了托管者身份和实盘数据，启动后沿用原来的托管者ID。

**用Docker容器隔离策略进程**
Linux和macOS的命令行版可以用-i参数让每个策略进程运行在独立的Docker容器里（需要本机已安装并运行Docker）。这是策略进程的隔离方式，不是托管者本身的Docker镜像，参数见命令行参数。

托管者操作注意事项

先停实盘，再停托管者
删除托管者或停止托管者进程前，先确认它上面没有运行中的实盘。

正常停止托管者

• 命令行版：在终端按一次Ctrl+C，或向进程发送SIGTERM（kill <PID>、systemctl stop）。
• Windows界面版：点击界面上的停止按钮。

托管者收到停止指令后会优雅退出：先停止其上的所有实盘、上报最终状态，再从平台下线。收尾期间再按一次Ctrl+C会跳过状态上报和下线，直接退出，一般不要这样做。

避免强制结束
不要用kill -9结束托管者进程，也不要直接断电或强制关机。这样托管者来不及下线，平台上的实盘可能仍显示为运行中并继续计费；出现这种情况，需要先删除已离线的托管者，才能停止这些实盘。重启服务器前先停止托管者；用systemd等服务管理器运行时，系统关机会自动发送SIGTERM。

策略分享

• 公开分享
  点击「分享」按钮后会弹出对话框，可以选择「公开分享」。策略将完整地分享到平台的策略广场，任何用户都可以复制该策略。

• 内部分享
  点击「分享」按钮后会弹出对话框，可以选择「内部分享」。选择分享有效期、分享次数后会生成该策略的复制页面地址和复制码。可以分发给指定的FMZ平台用户，需要该策略的用户只需使用复制页面地址链接，登录复制页面后输入复制码即可获取该策略，获取后策略会自动出现在策略库中。

策略出租

• 公开出售
  点击「出租」按钮后会弹出对话框，可以选择「公开出售」。策略即可申请上架（需要通过审核）。

• 内部出售
  点击「出租」按钮后会弹出对话框，可以选择「内部出售」。选择使用天数、最大并发数、注册码数量后，系统会生成该策略的注册页面地址和注册码。您可以将其分发给指定的FMZ平台用户，需要该策略的用户只需访问注册页面地址链接，登录注册页面后输入注册码即可获取策略的使用权。策略也会出现在策略库中，但用户只有回测和实盘使用权限，无法查看策略源码等信息。并发实盘个数设置为0时表示不限制并发数量，允许无限制地创建实盘。