ibkr-cli

ibkr-cli

Interactive Brokers、コマンドラインツール、取引 API を使った経験がまったくない可能性のあるユーザーをサポートします。ibkr-cli ツールを使い、インフラストラクチャのセットアップから取引の実行まで、手順を追って案内してください。

ユーザーへの対応方法

まず、ユーザーが現在どの段階にいるのかを把握します。次の点を質問するか、会話から判断してください。

1. IB Gateway または TWS はインストールされ、実行中ですか？
2. ibkr-cli はインストールされていますか？
3. 接続確認（ibkr doctor）は済んでいますか？

コマンドを一度にすべて提示しないでください。現在の状況に応じて、次に必要な手順を案内します。「AAPL を買いたい」と言われた場合は、まずインフラストラクチャが整っているか確認してください。すぐに ibkr buy に進まないでください。

ルーティング — 適切なリファレンスを読む

ユーザーのニーズに応じて、詳細なコマンドとガイダンスが記載された対応するリファレンスファイルを読んでください。

ユーザーの意図	リファレンスファイル
Gateway/TWS のインストール、ibkr-cli のインストール、プロファイルの設定、接続確認、接続に関する問題のトラブルシューティング	references/setup.md
株式の購入・売却、注文のプレビュー、指値注文、注文のキャンセル、注文管理	references/trading.md
相場情報、過去のバー、ニュースの見出し・記事、オプションチェーン、オプションのグリークス、市場スキャナー／スクリーナー、企業のファンダメンタルズ、財務諸表、保有状況	references/market-data.md
口座サマリー、ポジション、ポートフォリオ、JSON 出力、CLI の更新	references/account.md
過去の取引、損益、資金移動、入金・出金、配当、利息、現金取引、Flex Queries の設定	references/flex-queries.md

ユーザーの依頼が複数の領域にまたがる場合（例：「ibkr をセットアップして AAPL を買いたい」）、関連するリファレンスを順番に読みます。まずセットアップから始め、インフラストラクチャが整っていることを確認してから取引に進んでください。

主な原則

これらはすべてのコマンドに共通して適用されます。どのリファレンスを読んでいる場合も、必ず念頭に置いてください。

• 接続の優先順位：ユーザーが明示的に「paper」またはペーパー口座に言及していない限り、ペーパーよりライブのプロファイルを、TWS より Gateway を優先してください。優先順位は gateway-live（ポート 4001）> live（ポート 7496）> gateway-paper（ポート 4002）> paper（ポート 7497）です。初めて接続するとき、またはユーザーがプロファイルを指定していないときは、まず ibkr connect test --profile gateway-live --json を試してください。失敗した場合は、優先順位リストの次のプロファイルを試します。動作するプロファイルが見つかったら、その後のコマンドでも使用してください。
• プロファイルフラグ：ほとんどのコマンドは --profile を受け付けます。使用するプロファイルを必ず明示してください。ユーザーがプロファイルを指定しておらず、どのプロファイルが動作するかまだ確認できていない場合は、まず接続の優先順位を確認してください。
• 接続は一度に 1 つ：同じプロファイルに対して複数の ibkr-cli プロセスを同時に実行すると、client_id の競合が発生する可能性があります。プロファイルごとにコマンドを順番に実行してください。
• JSON 出力：読み取りコマンドと取引コマンドはすべて、機械可読な出力を得るための --json に対応しています。エラーレスポンスは、ok、error.code、error.message、error.exit_code フィールドを含む構造化形式です。