跳转到主要内容
QFEX CLI 为人工操作员和 AI 智能体提供仅返回 JSON 的 QFEX 命令行接口。 后台守护进程管理底层 QFEX WebSocket 连接；从调用方角度看，CLI 命令保持无状态。 使用 CLI 配合 AI 智能体的概览指南见智能体交易。

​
安装

​
快速开始

​
为什么使用 CLI

  • 所有命令均输出 JSON，方便通过管道传给 jq 或在代码中解析。
  • 守护进程与行情和交易 WebSocket 保持持久连接，因此脚本无需直接管理订阅、认证或连接生命周期。
  • 行情命令无需凭据。
  • 交易命令使用 API 密钥页面介绍的密钥。

​
常用命令

​
环境

CLI 支持 QFEX 生产和 UAT 环境：
  • prod：连接 qfex.com，使用真实资金。
  • uat：连接 qfex.io，无需真实资金即可测试策略和集成。
可在 qfex login 时选择环境，也可修改 ~/.config/qfex/config.yaml 后重启守护进程。

​
子账户

如果您有子账户，qfex login 会要求选择默认使用的账户。选择结果以 selected_subaccount 保存到 ~/.config/qfex/config.yaml。 之后可用以下命令查看或修改：
选择另一个子账户会更新配置并重启守护进程，使已认证的交易及账户请求使用新的账户上下文。 也可在子账户间转账：
该命令接受 --from、--to 和 --amount（美元金额）。可将 --from 或 --to 之一设为 "primary"，表示主账户；另一方应为 qfex account subaccounts list 返回的账户 UUID。

​
相关链接