入门指南¶
cTrader Open API 是一项服务，您可以使用它来开发连接到 cTrader 后端的自定义应用程序。 本文档提供了您需要了解的所有信息，包括有关 SDK、结构化教程、代码片段等的信息。
什么是 Open API？ ¶
cTrader Open API 是一项允许任何拥有 cTrader ID (cTID) 的人创建应用程序以发送和接收来自 cTrader 后端信息的服务。 您可以使用此 API 开发面向交易的应用程序或服务，或将 cTrader 后端与您可能拥有的任何现有解决方案集成。
使用此 API 涉及向 cTrader 后端发送和接收消息。 这是通过发送和接收 JSON 对象或 Google Protocol Buffers (Protobufs) 来完成的。 这两种数据序列化和反序列化的方式都是语言中立的，这意味着您可以使用任何编程语言与 API 进行交互。
消息名称
当本文档引用特定消息时（例如 ProtoOAApplicationAuthReq），它使用 Protobuf 表示法，消息名称以 ProtoOA... 开头。
cTrader Open API 可供任何注册了 cTrader 关联经纪商的人使用。
用例
以下是一些您在与 cTrader Open API 交互时可能创建的应用程序：
- 一个自定义交易应用程序，引导新用户与特定经纪商创建新账户。
- 一个 Telegram 机器人，自动通知您的关注者您可能进行的任何新交易。
- 一个可穿戴设备应用程序，显示用户最近打开的五个头寸的当前盈亏。
- 一个使用生成式 AI 服务提供市场概览的移动应用程序。
如您所见，cTrader Open API 非常适合希望社交并与关注者互动的专业交易者。
基本功能 ¶
以下是 cTrader Open API 允许您的代码执行的非详尽列表：
- 访问实时市场数据.
- 执行官方 cTrader 应用程序中允许的所有类型的交易操作。
- 检索和处理有关过去、当前和待处理操作（包括交易、订单和头寸）的信息。
如我们的 使用条款 所示，任何拥有 cTID 的人都可以访问该 API，并且默认情况下，它受到所有 cTrader 关联经纪商的交易账户的支持。
速率限制
请注意，某些请求的频率存在限制。
- 对于任何非历史数据请求，每个连接每秒最多可以执行 50 次请求。
- 对于任何历史数据请求，每个连接每秒最多可以执行 5 次请求。
模拟和实盘交易 ¶
您可以使用 cTrader Open API 代表模拟和实盘账户进行交易。
我们建议在开发和测试阶段使用模拟账户，在确保与 cTrader Open API 的集成按预期工作后，再切换到实盘账户。 不过，并没有严格的限制，您可以自由选择在实盘账户下开始开发和测试。
SDKs ¶
在与 Open API 集成时，您可以使用 JSON 或 Protobufs 进行数据序列化和反序列化。
您可以使用任何语言来实现 cTrader Open API。 不过，如果您打算使用 Protobufs，我们强烈建议使用 Spotware 官方支持的 SDK 的语言。 到目前为止，这些语言如下。
上面列出的每个官方 SDK 都包含帮助方法和类，使 cTrader Open API 的实现尽可能顺畅。
如果您打算使用 JSON，则不需要使用我们的 SDK，因为在这种情况下处理序列化和反序列化相对简单。