はじめに¶

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）を参照する場合、メッセージ名の先頭にProtoOA...が付いたProtobuf表記を使用します。

cTrader Open APIは、cTrader関連のブローカーに登録されている誰でも利用できます。

ユースケース

cTrader Open APIとやり取りする際に作成できる可能性のあるアプリケーションの一部を以下に示します：

特定のブローカーで新しいアカウントを作成するために新しいユーザーを誘導するカスタム取引アプリケーション。
あなたが行った新しい取引を自動的にフォロワーに通知するTelegramボット。
ユーザーが開いた最新の5つのポジションの現在のP&Lを表示するウェアラブルデバイス用アプリ。
生成AIサービスを使用して市場の概要を提供するモバイルアプリ。

ご覧の通り、cTrader Open APIは、ソーシャルに参加し、フォロワーと交流したいプロのトレーダーに最適です。

必須機能 ¶

cTrader Open APIがコードに許可する機能の非網羅的なリストを以下に示します：

リアルタイムの市場データにアクセス。
公式のcTraderアプリケーションで許可されているすべての種類の取引操作を実行する。
過去、現在、および保留中の操作（取引、注文、ポジションを含む）に関する情報を取得および処理する。

利用規約に示されているように、APIはcTIDを持つ誰でもアクセスでき、デフォルトではcTrader関連のブローカーのすべての取引口座でサポートされています。

レート制限

cTraderバックエンドに対して特定のリクエストを実行できる頻度にいくつかの制限があることに注意してください。

非履歴データリクエストの場合、接続ごとに1秒あたり最大50リクエストを実行できます。
履歴データリクエストの場合、接続ごとに1秒あたり最大5リクエストを実行できます。

デモとライブ取引 ¶

cTrader Open APIを使用して、デモ口座とライブ口座の両方で取引を行うことができます。

開発とテストにはデモ口座の使用を推奨し、cTrader Open APIとの統合が意図した通りに動作することを確認した後にライブ口座に切り替えることをお勧めします。ただし、厳しい制限はなく、ライブ口座での開発とテストを自由に選択することもできます。

SDKs ¶

Open APIとの統合では、データのシリアライゼーションとデシリアライゼーションにJSONまたはProtobufsを使用できます。

cTrader Open APIの実装には任意の言語を使用できます。ただし、Protobufsを使用する場合は、Spotwareが公式にサポートするSDKを持つ言語を使用することを強くお勧めします。現在、これらの言語は以下の通りです。

上記のすべての公式SDKには、cTrader Open APIの実装を可能な限りスムーズにするためのヘルパーメソッドとクラスが含まれています。

JSONを使用する場合、シリアライゼーションとデシリアライゼーションの処理が比較的簡単であるため、当社のSDKを使用する必要はありません。