FxPro Trading APIを解説｜機能と連携方法

FxPro Trading APIの仕組み

FxProで利用可能なTrading APIは、取引プラットフォームや外部システムを接続し、 市場データの取得、口座情報の確認、注文の発注や管理を自動化するために使用されます。

APIを利用すると、取引プラットフォームを手動で操作する代わりに、 独自に作成したプログラムや取引システムから対応機能を実行できます。 ただし、利用できるAPI、接続方式、対応銘柄は、口座タイプやプラットフォームによって異なります。

FxProでは、cTraderと連携するAPIや、一定条件を満たす利用者向けの接続方式が案内される場合があります。 利用を開始する前に、FxPro Directまたはサポートを通じて、 自分の口座で使用できるAPIと申請条件を確認してください。

APIアクセスの設定方法

口座と利用条件を確認する

APIを利用するには、最初にFxProへ登録し、 対応する取引口座を作成する必要があります。 ライブ環境で利用する場合は、本人確認や口座認証の完了が求められることがあります。

すべての口座で同じAPIが自動的に利用できるとは限りません。 対応プラットフォーム、取引量、口座タイプ、技術的な利用目的などによって、 追加申請や承認が必要となる場合があります。

基本的な設定手順

1. FxProへ登録し、FxPro Directへログインします。
2. APIを利用したいデモ口座またはライブ口座を作成します。
3. 利用可能なAPIと申請条件をFxPro Directまたはサポートで確認します。
4. 必要な場合は、利用目的や技術情報を入力して申請します。
5. 発行された認証情報を安全な場所に保存します。
6. デモ環境で接続と注文処理をテストします。

認証情報の管理

APIキー、クライアントID、シークレット、アクセストークンなどの認証情報は、 第三者へ公開しないでください。 ウェブサイトの公開コードやGitHubなどの公開リポジトリへ直接保存することも避ける必要があります。

市場データの連携方法

対応するAPIでは、Bid価格、Ask価格、銘柄情報、 チャートデータなどを取得できる場合があります。 リアルタイムデータと過去データでは、使用する接続方式や取得方法が異なることがあります。

リアルタイム市場データ

リアルタイム価格を継続的に受信する場合は、 ストリーミング接続や対応するリアルタイム配信機能を使用します。 接続が切断された場合に備えて、再接続とデータ復旧の処理を実装することが重要です。

過去データ

過去の価格データは、チャート作成、指標計算、 Expert Advisorや取引アルゴリズムの検証に利用できます。 利用可能な期間、時間足、データ量はAPIによって異なります。

市場データ利用時の注意点

• 価格のタイムスタンプとタイムゾーンを統一する
• Bid価格とAsk価格を区別する
• 市場休場時間や銘柄ごとの取引時間を確認する
• データ欠損や重複データを処理する
• 接続回数やデータ取得回数の制限を確認する

注文管理と執行

APIから注文を発注する

対応するTrading APIでは、成行注文、指値注文、 逆指値注文などをプログラムから発注できる場合があります。

注文を送信する際は、銘柄、売買方向、取引数量、 注文タイプ、価格、Stop Loss、Take Profitなどの必要情報を指定します。

注文発注前に確認する項目

• 銘柄名がAPIの仕様と一致しているか
• 最小取引数量と数量単位
• 価格の小数点桁数
• Stop LossとTake Profitの最低距離
• 市場が取引時間内であるか
• 利用可能証拠金が十分にあるか

ポジションの監視と変更

保有ポジション、未決済注文、現在の損益、 必要証拠金などをAPIから確認できる場合があります。 また、対応する機能を使ってStop LossやTake Profitを変更したり、 ポジションの一部または全部を決済したりできます。

注文送信後は、注文ID、処理結果、約定価格、 拒否理由などの応答を記録してください。 通信エラーが発生した際に同じ注文を重複して送信しない仕組みも必要です。

口座情報と残高管理

APIを使って、取引口座の残高、純資産、 使用証拠金、余剰証拠金、証拠金維持率などを確認できる場合があります。

口座の状態を継続的に監視することで、 ポジションを追加できるか、証拠金が不足していないか、 損失が設定した範囲内に収まっているかを判断できます。

管理できる主な情報

• 口座残高
• 純資産
• 使用証拠金
• 余剰証拠金
• 証拠金維持率
• 保有ポジション
• 未決済注文
• 決済済み取引の履歴

取得した口座データを外部システムへ保存する場合は、 個人情報や取引情報を適切に保護してください。 不要な情報を長期間保存せず、アクセス権限も限定することが重要です。

リスク管理と監視ツール

自動リスク管理

自動売買システムでは、注文ロジックだけでなく、 損失を制限するためのリスク管理機能を組み込む必要があります。

• 1回の取引に使用する最大数量
• 同時に保有できるポジション数
• 1日あたりの最大損失額
• 銘柄ごとの最大エクスポージャー
• 証拠金維持率の最低水準
• 異常な価格変動時の新規注文停止

接続状態の監視

API接続、価格配信、注文応答が正常に動作しているかを監視します。 一定時間データが更新されない場合や、注文応答が返らない場合は、 自動的に新規注文を停止する設計が有効です。

エラー処理

注文拒否、認証エラー、通信切断、 取引時間外、証拠金不足などのエラーを区別して処理します。 エラー内容を記録し、同じ処理が無限に繰り返されないようにしてください。

API連携とコード実装

Trading APIとの連携には、Python、JavaScript、Java、C#など、 HTTP通信やストリーミング接続を扱えるプログラミング言語を使用できます。

FxProまたは対応プラットフォームから提供される公式ドキュメントを確認し、 認証、接続、データ取得、注文処理の順に実装してください。 非公式ライブラリを使用する場合は、更新状況や安全性も確認する必要があります。

基本的な開発手順

1. 公式ドキュメントで利用可能な機能を確認します。
2. デモ口座とAPIアクセスを準備します。
3. 認証と接続処理を実装します。
4. 市場データの取得をテストします。
5. 最小数量で注文処理をテストします。
6. 注文変更、取消、決済を確認します。
7. エラー処理と再接続機能を追加します。
8. リスク制限と監視機能を実装します。

技術資料とサポート

API連携を始める際は、FxProまたは対応プラットフォームが提供する 最新の技術資料を使用してください。 古いサンプルコードや非公式なエンドポイントは、 現在の仕様と一致しない場合があります。

確認する資料

• 認証方法
• 利用可能なエンドポイントまたは接続方式
• 注文タイプと必須パラメータ
• 銘柄名と取引仕様
• 利用回数や接続数の制限
• エラーコード
• デモ環境とライブ環境の違い

接続できない場合や利用条件が分からない場合は、 FxPro Directのライブチャットまたはカスタマーサポートへ問い合わせてください。 問い合わせ時には、利用している口座タイプ、プラットフォーム、 エラーメッセージ、発生時刻などを伝えると確認しやすくなります。

よくある質問

FxProでAPIを利用するにはどうすればよいですか？

FxProへ登録して対応する口座を作成し、 FxPro Directまたはサポートで利用できるAPIと申請条件を確認します。 APIによっては追加の申請や承認が必要です。

FxPro APIはデモ口座でテストできますか？

対応するAPIでは、デモ口座を使って接続や注文機能をテストできる場合があります。 ライブ口座で使用する前に、デモ環境で十分に検証してください。

どのプログラミング言語を使用できますか？

APIの仕様に対応していれば、Python、JavaScript、Java、C#などを使用できます。 cTrader関連の自動売買ではC#が使用される場合があります。

APIでリアルタイム価格を取得できますか？

対応するAPIでは、リアルタイムまたは定期更新の市場データを取得できる場合があります。 対応銘柄、更新方法、利用制限は公式資料で確認してください。

APIから注文を発注できますか？

注文機能に対応したAPIでは、成行注文、指値注文、 逆指値注文などをプログラムから発注できる場合があります。

APIキーをウェブサイトのJavaScriptへ直接記載してもよいですか？

推奨されません。ブラウザ側のコードへAPIキーやシークレットを記載すると、 第三者に取得される可能性があります。 認証情報は安全なサーバー側で管理してください。

APIの利用回数に制限はありますか？

APIによって、一定時間内のリクエスト数、同時接続数、 購読できる銘柄数などに制限が設定される場合があります。 最新の制限は公式ドキュメントで確認してください。

自動売買を利用すれば利益を得られますか？

自動売買やAPIの利用は利益を保証しません。 市場変動、スプレッド、スリッページ、通信障害、 プログラムの不具合などによって損失が発生する可能性があります。