Skip to content

03 · 跑通第一个组合 ​

先创建组合和账户,手动执行一次调仓,确认结果后再设置自动执行。

截图中的账户

截图中的登录信息仅为示例,不能用于连接。天勤本地模拟也需要有效的天勤账号和密码。

1. 创建组合 ​

点击侧栏“新建组合”,输入名称并选择市场。本例选择“期货”,命名为“双品种目标”。创建后进入函数编辑器。

填写组合名称并选择期货市场

市场创建后固定。选好市场后,编辑器会提供对应的初始代码。

2. 写入最小目标函数 ​

先使用固定权重,确认返回值含义:

python
from axile.server.context import Context


def calculate_portfolio(context: Context) -> dict[str, float]:
    return {"rb2701": 0.4, "ag2612": -0.25}

选择“样例数据”,点击“试跑并保存”。结果中会列出两个品种,权重分别为 0.4000 和 -0.2500,对应目标多头和目标空头。

固定目标函数的样例试跑结果

这个函数没有读取 context,编辑器会提示参数未使用。函数是否运行成功,看“试跑结果”。

目标权重与下单数量

0.4 表示原始目标权重,不是买 0.4 手,也不是“在现有仓位上加 40%”。账户还会应用杠杆、精度和数量规则,详见目标与持仓。

3. 选择账户渠道 ​

点击“新建账户”,选择自己的渠道。本文使用天勤。

公共核心的渠道选择页

图中只安装了天勤依赖,CTP 与掘金显示暂不可用。安装方式见[渠道参考](/reference/channels)。

4. 填写连接信息 ​

为账户命名,选择运行模式,再填写对应凭据。天勤有实盘账户、快期模拟和本地模拟三种表单;本地模拟还要填写初始资金。

天勤本地模拟连接表单

本例初始资金为 1,000,000。连接时填写自己的有效天勤账号和密码,不能照抄图中的登录信息。

本地模拟的资金和持仓保存在当前 Worker 中,日盘或夜盘 Worker 重建后会重置。需要保留连续的模拟账户状态时,要留意它与快期模拟的区别。

5. 绑定刚创建的组合 ​

选择“双品种目标”。账户随后使用这个组合计算目标。

将账户绑定到双品种组合

同一组合可以供多个账户跟随,账户之间的资金和执行设置仍各自独立。

6. 查看交易方式 ​

天勤期货默认使用“期货目标持仓”算法。检查报价方式、平仓规则和最大等待时间。其他算法见执行算法参考。

期货目标持仓的交易方式设置

算法等待到期不保证目标全部完成。实际结果需要在执行详情中确认。

7. 先关闭自动执行,再创建账户 ​

在定时步骤先关闭“自动调仓”,然后进入确认页。点击“计算目标”查看返回值,核对账户、组合和算法,再创建账户。

创建账户前确认目标和运行状态

本例在向导中将多空杠杆均设为 1,后文的数量计算也按一倍杠杆说明。

8. 确认账户连接 ​

创建后在账户概览确认连接状态。尚未连接时,点击账户连接开关,等待连接完成。点击状态旁的详情入口,查看连接进度、核对结果和失败原因。

账户连接详情及核对状态

连接后会核对资产和委托,交易任务需另行执行。连接失败时,按详情中的提示检查凭据、渠道环境或连接设置;历史失败记录只用于排查,不能据此判断当前连接仍有故障。

9. 核对目标后手动执行 ​

进入账户“杠杆设置”,把多空杠杆都设为 1 并保存。回到账户概览,刷新账户资产,重新计算目标,然后检查“持仓 vs 目标”。

执行前的持仓与目标对照

确认实际账户配置后,点击“立即执行”。这个按钮会直接触发执行。执行结束后,点击结果行进入详情。

完整示例执行的各品种结果与执行链路

目标与持仓说明图中的目标手数如何计算。

Axile 公共核心使用文档