跳转至

cTrader Algo API 更新日志

5.6

2025 年 11 月

新功能
  • 新的 ChartTemplates API 允许您检索、创建、更新、删除和应用图表模板。
  • 新的 Symbol[] 参数类型允许您向算法传递多个交易品种，具有多交易品种选择器 UI 表示。
  • 新的 Enum[] 参数类型允许您向算法传递枚举类型的多个值，具有多枚举值选择器 UI 表示。
  • 新的 TimeFrame[] 参数类型允许您向算法传递多个 TimeFrame 值，具有多时间周期选择器 UI 表示。
  • 新的 MultiSelect 算法控件允许您让算法用户选择多个唯一字符串值。
  • WebView 控件的新 OpenDevToolsWindow 方法允许您为 WebView 控件实例打开开发者工具。
  • 交易品种点数的新 SwapCalculationType。
改进
  • TimeFrame 参数类型升级以支持插件中的自定义时间周期。
  • DateTime 参数类型更改为使用新的硬编码默认值 31/10/2025 00:00:00（如果算法未设置），而不是 DateTime.MinValue。
  • DateOnly 参数类型更改为使用新的硬编码默认值 31/10/2025（如果算法未设置），而不是 DateOnly.MinValue。
  • TimeSpan 参数类型更改为使用新的默认值 00:00:00（如果算法未设置），而不是 TimeSpan.MinValue。
  • TimeSpan 参数类型更改为使用新的最小值 00:00:00 和最大值 23:59:59（如果算法未设置），而不是 TimeSpan.MinValue 和 TimeSpan.MaxValue。
  • 一些内置算法样本添加到 C# 和 Python 算法模板列表和 GitHub 算法样本存储库中。
  • 所有内置指标的源代码添加到 C# 和 Python 算法样本 GitHub 存储库中。
  • 图表视口数据传输到算法的方式从急切改为惰性。 这一变化防止了在算法不使用图表视口 API 成员的情况下不必要的资源使用。
错误修复
  • 与图表对象一起使用时，具有坐标的图表控件导致问题。
  • 切换插件的交易账户时，账户相关数据（如头寸、挂单等）未更新。
  • 当算法设置值时，DateTimePicker 控件的 ValueChanged 事件未触发。

5.5

2025年9月

新功能
  • 新的 Symbol 参数类型允许您从账户交易品种列表中选择一个交易品种并将其传递给算法。
  • 新的 TimeSpan 参数类型允许您将类型化的时间间隔或一天中的时间传递给算法，并具有时间选择器 UI 表示。
  • 新的 DateTime 参数类型允许您在算法的时区内传递类型化的日期和时间，并具有日期时间选择器 UI 表示。
  • 新的 DateOnly 参数类型允许您将类型化的日期传递给算法，并具有日期选择器 UI 表示。
  • 新的 Parameters 集合属性，添加到 PluginType（类似于 IndicatorType 和 RobotType），允许您在代码中访问插件参数。
  • 新的 DateTimePicker 算法控件允许您轻松从算法用户那里获取日期和时间值。
改进
  • 将账户存款资产的加载从急切模式更改为惰性模式，以防止在算法启动期间出现存款资产未找到的错误。
错误修复
  • 在插件中调用 LoadMoreHistory 后，新加载的柱形图未添加到图表中。
  • 在插件中切换图表交易品种或时间周期后，图表柱形图未更新。
  • 在位置开仓事件处理程序中访问 Positions.Count 时返回的位置数量不正确

5.4

2025年7月

新功能
  • 插件热键 API：新的插件 API 对象允许您添加全局热键。 这些热键的行为类似于内置的 cTrader 热键，并在任何地方都可以使用。
  • 参数和输出描述：参数和输出属性中的新 Description 属性在用户悬停时在 UI 中显示工具提示。
  • 图表柱形图切换：图表显示设置中的新 Bars 标志允许您隐藏图表柱形图。 该标志消除了使用透明颜色的需求，并通过不绘制柱形图来防止缩放问题。
  • 设置活动框架：Frame 类中的新 Activate 方法允许插件设置活动图表或框架。
  • 柱形图输出：指标现在可以输出带有成交量的 OHLC 柱形图，而不是单一数据系列。 该输出允许在面板或主图表上显示自定义柱状图，并可以被其他指标重复使用。
  • 插件的数据系列：新的 CreateDataSeries 方法允许插件创建数据系列。 创建的系列可以作为输入传递给内部指标。
  • 面板子属性：新的 Children、HasChild 和 ChildrenCount 属性让您可以访问和处理面板内容。
  • 网格面板位置信息：新的 GridChildPositionInfo 方法返回子元素在网格中的位置。
  • 插件的主菜单 API：新的 API 允许您向主菜单添加带有 SVG 图标的菜单项。 顶部菜单项可以显示自定义控件。 底部菜单项可以触发插件处理程序。
  • 插件参数：插件现在可以像指标和 cBot 一样使用参数。 这些参数在插件设置中可见和可编辑。
改进
  • Assets API 进行了重构以减少资源使用。
  • 改进了 Sleep API，以防止在市场关闭时 cBot 和指标冻结。
错误修复
  • 在 5.4 版本中未发现或修复任何 API 错误。

5.3

2025年6月

新功能
  • 自定义时间周期 API：新的 API 允许插件定义自定义时间周期并为其提供数据。
  • 自定义交易品种 API：新的 API 允许插件创建自定义交易品种。 创建的交易品种可以基于现有交易品种或从头定义，并表现得像经纪商交易品种。
  • 自定义回测数据源：新的 API 允许插件提供回测和优化数据。 该 API 支持外部 tick 数据和第三方数据源。
  • 通知弹窗：算法现在可以显示类似于内置 cTrader 通知的弹出警报。
  • 交易品种情绪访问：算法现在可以读取交易品种的情绪数据。
改进
  • 跨时间周期回测：改进了回测和优化中不兼容时间周期使用的错误消息。
  • 更新了默认算法模板中的帮助中心链接。
  • 使 Account.UserId 和 Account.Nickname 可用于 Cloud cBot 实例。
  • CID 断开连接处理：当 CID 断开连接时，算法继续运行并返回最后已知的账户数据。
  • 消息超时：超时处理防止算法在等待 cTrader 响应时卡住。
  • 帮助中心 API 更新：在帮助中心参考中添加了受保护的 API 方法。
错误修复
  • Account.BrokerName 在控制台中返回空值。
  • 加载所有账户交易时算法冻结。
  • 回测中的 RiskReward 工具错误地下了实盘交易。
  • ChartObject.IsLocked 属性文档中的拼写错误。
  • 在渲染之前设置选定项后触发了 ComboBox.SelectionChanged。

Image title