futu-sim-trading

Futu シミュレーション取引

ペーパートレードには、ローカルで利用可能な futu sim ... CLI を使用してください。特に指定がない限り、ユーザーの言語で回答してください。コマンド、フラグ、JSON フィールド、シンボル、エラーコードは元の形式のままにしてください。

Futu CLI の実行環境

このスキルには公式の futu CLI が必要です。macOS と Linux では $HOME/.futu/bin/futu にインストールされます。Windows では %LOCALAPPDATA%\FutuCLI\bin に futu.exe がインストールされます。futu-cli のインストールガイドを参照してください。

業務コマンドを実行する前に futu の動作を確認してください。

macOS / Linux：

if command -v futu >/dev/null 2>&1; then futu auth status --format json; elif [ -x "$HOME/.futu/bin/futu" ]; then "$HOME/.futu/bin/futu" auth status --format json; else echo '__FUTU_CLI_MISSING__'; fi

Windows（Git Bash を含む）では、上記の bash ブロックや install.sh を使用しないでください。install.sh は Windows では実行できません。代わりに、次の PowerShell 呼び出しを使用してください。

$exe = Join-Path $env:LOCALAPPDATA 'FutuCLI\bin\futu.exe'
if (Get-Command futu -ErrorAction SilentlyContinue) { futu auth status --format json } elseif (Test-Path $exe) { & $exe auth status --format json } else { Write-Output '__FUTU_CLI_MISSING__' }

__FUTU_CLI_MISSING__ が表示された場合は、停止してください。まだペーパートレードのコマンドを実行しないでください。インストールする前にユーザーに確認してください。同意を得た後：

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/FutunnOpen/futu-cli/main/scripts/install.sh | sh

Windows PowerShell。公式の Windows インストーラーは amd64 に対応しています。

iwr -UseBasicParsing https://raw.githubusercontent.com/FutunnOpen/futu-cli/main/scripts/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1

Windows インストーラーで未対応のアーキテクチャが報告された場合は、停止してそのメッセージを伝えてください。明示的な同意なしに、いずれのインストーラーも実行しないでください。その後、futu version を実行してください。現在のシェルで引き続き futu を認識できない場合は、$HOME/.futu/bin/futu または %LOCALAPPDATA%\FutuCLI\bin\futu.exe を直接呼び出してください。

インストール済みの futu CLI を更新するには、futu update --check を使用し、ユーザーの同意を得てから futu update を実行してください。

使用上のルール

• ペーパートレードのコマンドを実行する前に、Futu CLI の実行環境に従ってください。確認時に __FUTU_CLI_MISSING__ が表示された場合は、futu がインストールされるまで停止してください。
• 確認に成功した場合、業務用の出力は futu auth status --format json です。これが not logged in を返した場合は、ユーザーに futu auth login の実行を伝え、ログイン後にのみ続行してください。業務コマンドを直接実行しないでください。
• このスキルでの呼び出し規約：Bash から futu CLI を呼び出す場合は、コマンドの末尾に非表示の内部マーカー --source skill を必ず追加してください。--source skill を指定すると、CLI は Codex や Claude Code などのホストを自動検出し、agent_name を報告します。自動検出に失敗し、CLI が対応していることを確認できた場合に限り、--agent codex または --agent claude_code を追加してください。ユーザーに提示するコマンドには、これらの内部マーカーを含めないでください。
• トークンファイルの内容を読み取ったり表示したりしないでください。CLI が OAuth Bearer トークンを自動的に付加します。PERMISSION_DENIED はサーバー側の権限拒否です。トークンが不足していると説明しないでください。
• 常に高レベルの futu sim ... コマンドを使用してください。sim-trade-* はレガシーのエンドポイントメタデータとしてのみ扱ってください。これらのコマンドを直接呼び出さないでください。
• コマンドを生成する際は、必要最小限のパラメーターを使用してください。CLI にデフォルト値があり、ユーザーが値を指定していない場合は、そのフラグを明示的に渡さないでください。
• ペーパー口座を特定するため、まず futu sim account list --format json を呼び出すことを推奨します。その後のコマンドには明示的に --account を指定してください。最初のペーパー口座に暗黙的に依存しないでください。
• 出力をプログラムで解析する必要がある場合に限り、--format json を追加してください。ユーザーがコピーして実行するコマンドでは、デフォルトのテーブル形式を使用できます。
• 過去のペーパー注文は --next-key でページネーションされます。次のページ、追加の結果、または過去の注文すべてを求められた場合は、--format json を使用して pagination.next_key を読み取ってください。
• 過去のデータを照会する時間パラメーター --start と --end は、マイクロ秒単位のタイムスタンプを使用します。秒、ミリ秒、日付文字列は渡さないでください。
• ペーパー注文は実口座に影響しませんが、ペーパー口座の状態は変更します。ユーザーの意図が明確であれば実行してください。対象口座、シンボル、売買区分、数量、価格、注文 ID が不明確な場合は、先に照会するかユーザーに確認してください。
• シンボルは HK.00700 や US.AAPL のような MARKET.CODE 形式でなければなりません。ユーザーがコードのみ、または旧形式を指定した場合、市場を特定できるときに限り市場を補ってください。特定できない場合は先に確認してください。
• 実際の証券取引には futu-trading、暗号資産取引には futu-crypto、市場データの照会には futu-quote を使用してください。

参照

• 特定のペーパートレードコマンドを作成する場合や、必須、デフォルト、任意、列挙型のパラメーターを確認する場合は、CLI parameters をお読みください。
• ペーパートレードの市場、注文サイド、注文タイプ、取引セッション、注文ステータス、サーバーから返される列挙型について選択または説明する場合は、trading naming dictionary をお読みください。
• 次のページ、さらに多くの結果、またはすべての過去の注文を扱う場合や、--next-key、--page-size、--start、--end を使用する場合は、paper-trading pagination をお読みください。