> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qfex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能体交易

> 使用 AI 智能体研究市场、管理持仓并在 QFEX 交易

# 智能体交易

AI 智能体可以直接在 QFEX 上交易。通过 [QFEX CLI](https://docs.qfex.com/cn/api-reference/cli.md)，智能体能够读取实时行情、查询账户状态和持仓，以及提交和管理订单。

CLI 专为智能体工作流设计：每条命令都返回 JSON，从调用方角度看命令是无状态的，底层 QFEX WebSocket 连接由后台守护进程管理。因此，智能体可以通过简单的 shell 命令与交易所交互，无需自行实现交易连接。

## 开始使用

安装 CLI：

```sh theme={null}
brew install QFEX-org/tap/qfex
```

随后为智能体配置：

```sh theme={null}
# Global setup for Claude Code and Codex
qfex agents init

# Or add agent instructions to the current project only
qfex agents init --local
```

`qfex agents init` 配置 Claude Code 和 Codex，使其可使用 QFEX CLI 而无需反复请求权限。本地模式只向当前项目写入智能体指令。

查询市场数据无需凭据。要允许智能体交易或访问私有账户数据，请先登录：

```sh theme={null}
qfex login
```

完整安装指南、命令参考、环境、身份认证及子账户控制见 [QFEX CLI 文档](https://docs.qfex.com/cn/api-reference/cli.md)。

## 智能体可以做什么

使用 CLI 的智能体可执行的操作包括：

* 查询最优买卖价、订单簿、成交、K 线、标记价格、资金费率及未平仓量；
* 提交、修改和取消订单；
* 查看当前委托、持仓、余额和杠杆；
* 监听实时行情、订单及成交数据流；
* 使用 QFEX 子账户隔离交易策略或风险。

例如：

```sh theme={null}
qfex market bbo AAPL-USD
qfex market orderbook AAPL-USD --depth 5
qfex position list
qfex account balance
qfex order place --symbol AAPL-USD --side BUY --type MARKET --tif IOC --qty 1
```

## 开发与测试智能体

QFEX 提供生产和 UAT 环境。UAT 与生产环境接口一致，但不使用真实资金，因此应先在 UAT 中测试智能体行为及订单流程，再将策略部署至生产环境。

> [!WARNING]
>
> 生产环境交易使用真实资金。具有已认证交易权限的智能体可以代表您提交或取消订单。授予生产访问权限前，请先在 UAT 中仔细测试其行为。

## 构建智能体交易产品

开发者还可以为其他 QFEX 用户构建交易智能体或应用。[Builder Codes](https://docs.qfex.com/cn/qfex/builder-code.md)用于将交易活动归因给集成应用，并使开发者获得应用所产生的部分交易手续费。

Builder Codes 与推荐计划不同：推荐码在用户注册时进行归因，Builder Codes 则对通过集成产生的交易活动进行归因。

对于需要更底层控制的开发者，QFEX API 参考文档还介绍了 CLI 底层使用的 REST 与 WebSocket 接口。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.