cTrader CLI¶
cTrader CLI 是一款命令行工具,可直接在终端中管理账户、执行交易及处理算法交易相关操作,无需打开 cTrader 桌面应用程序。你可以输入命令来登录、查看市场数据、下单和管理交易,还可以运行 cBot、进行回测并优化 cBot。
一分钟了解 cTrader CLI!
cTrader CLI 主要有两种使用方式。你可以自行输入命令或编写脚本,也可以让 AI 智能体根据自然语言请求生成 cTrader CLI 命令,供你审核后运行。无论采用哪种方式,你都可以:
注意
cTrader CLI 在你的电脑或服务器上运行 cBot。这与在云端运行 cBot不同:后者由 cTrader 在其服务器上托管 cBot,因此无需在你自己的设备或服务器上持续运行程序。
cTrader CLI 使用场景 ¶
cTrader CLI 支持两种主要使用场景。这两种场景都通过输入命令而非图形界面进行操作,但适用于不同的目标。
| 对比项目 | AI 智能体,无需界面 | 自行在 VPS 或云端托管 |
|---|---|---|
| 目标 | 通过 AI 助手操作 cTrader,无需终端或图形用户界面。 | 在自己管理的服务器上全天候运行 cBot,无需打开桌面应用程序。 |
| 典型用户 | 通过自然语言描述目标的用户;AI 助手生成命令,供用户审核后运行。 | 熟悉终端操作、可以自行输入命令或编写脚本的交易者或运维人员。 |
| 命令来源 | 由 AI 根据自然语言请求或脚本驱动的智能体工作流程生成。 | 在终端中输入,或通过脚本、cron 任务或 docker run 执行。 |
| 输出处理 | AI 解析 JSON,并据此生成回复或下一条提示。 | 将 JSON 输出到 stdout,也可以重定向到文件或通过管道传递给其他工具。 |
| 长时间运行的命令 | AI 智能体不应自行启动 run。 AI 智能体可以安全地监控 cbots 并读取 price 输出的实时价格,但任何用于启动、配置或停止 cBot 的命令,都必须先经过审核才能运行。 | run 会启动一个长时间运行的进程,需要使用 systemd、Docker 等进程管理工具或 --exit-on-stop 选项进行管理;其他 CLI 命令均为一次性调用,返回结果后即退出。 |
注意
无论采用哪种场景,都需要由你自行提供和管理服务器或工作站。 cTrader CLI 不提供由平台管理的托管服务。
设置 cTrader CLI ¶
cTrader CLI 与 cTrader MCP 服务器对比 ¶
cTrader CLI 和cTrader MCP 服务器都能让你无需手动操作界面即可使用 cTrader,但两者的工作方式不同。请参考下表,选择最适合自己工作流程的方式。
| cTrader CLI | cTrader MCP 服务器 | |
|---|---|---|
| 交互方式 | 你可以在终端中输入命令,也可以让 AI 生成命令,供你审核后运行。 | 你只需用自然语言描述想要执行的操作,AI 智能体就会代你完成。 |
| 是否需要运行 cTrader 应用程序 | 不需要。可独立通过终端、VPS 或容器运行。 | 必须在后台保持 cTrader 运行:本地使用时需在 Windows 或 macOS 上运行桌面应用程序;远程使用时需保持 cTrader Web 会话处于活动状态。 |
| 操作结果的显示位置 | 仅在终端中以文本和 JSON 格式显示,不会出现在 cTrader 界面中。 | 在 cTrader 界面中,与常规平台视图一起显示。 |
| 最适合的用途 | 通过脚本实现可重复执行的自动化操作,以及在服务器上托管 cBot。 | 通过 AI 助手进行对话式交易、分析和临时查询。 |
提示
如果你最看重操作的可重复性和精确控制,请选择 cTrader CLI。如果你更重视与 AI 智能体进行自然语言对话,请选择cTrader MCP 服务器。
探索 cTrader CLI ¶
-
使用 AI 助手帮你编写 cTrader CLI 命令。
-
在终端中运行、停止 cBot 并进行回测。
-
构建并导出供 cTrader CLI 运行的
.algo文件。 -
查看原始命令和代码。
操作 ¶
cTrader CLI 按任务对命令进行分组。下表列出了支持的操作。有关各项命令的详细语法、选项和示例,请参阅CLI 参考文档。
| 操作 | cTrader CLI |
|---|---|
| 列出账户并查看账户统计数据 | ✅ |
| 列出可用的交易品种,并查看其交易时段和交易条件 | ✅ |
| 查看实时价格和历史 K 线 | ✅ |
| 下达设有固定止损和止盈水平的市价单、限价单、止损单和止损限价单,修改或取消挂单,并列出已有订单 | ✅ |
| 修改固定止损和止盈水平,全部或部分平仓,并列出未平仓头寸 | ✅ |
| 获取交易记录、已完成订单的历史记录和当前风险敞口数据 | ✅ |
| 计算指标的当前值和历史值,并列出可用指标 | ✅ |
| 创建、删除和列出价格提醒 | ✅ |
| 运行和停止 cBot、进行回测,并查看 cBot 的元数据 | ✅ |
| 优化 cBot | ✅ |
| 创建 cBot、指标和插件项目的初始结构并进行构建 | ✅ |
警告
cTrader CLI 是一款用于交易和自动化操作的工具。它不提供财务、投资、法律或税务建议。用于下单或修改订单的命令可能触发真实交易并造成损失。运行每条命令前请先核对, 先在模拟账户中测试, 并妥善保护登录凭据。