futu-crypto

Futu Crypto

暗号資産の取引には、ローカルで利用可能な futu 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 はサーバー側の権限拒否です。トークンがないためだと説明しないでください。
• コマンドを作成するときは、必要最小限のパラメーターを使用してください。CLI にデフォルト値があり、ユーザーが値を指定していない場合は、そのフラグを明示的に渡さないでください。
• デフォルトの口座が設定されていると決めつけないでください。このターンですでに futu auth status または設定でデフォルトの口座を確認できている場合に限り、--account を省略してください。それ以外の場合は、暗号資産の口座一覧を表示するか、ユーザーに口座を選んでもらい、--account を明示的に指定してください。
• 出力を解析する場合、口座、注文、約定のフィールドを抽出する場合、または後続の操作が結果に依存する場合は、--format json を追加してください。ユーザーがコピーして実行することだけを目的とするコマンドでは、デフォルトのテーブル形式を使用できます。
• 一覧および履歴のクエリでは、自動的にページ分割されません。JSON レスポンスの completed=false と page_flag が返された場合は、その値を --page-flag として渡し、次のページを取得してください。
• 暗号資産の注文は、実際の資産に影響します。実行前に、口座、ペア、売買の別、数量、価格、または金額を確認してください。
• ヘルプにそのフラグが表示されていても、売り注文で --cash-qty を使用しないでください。
• CLI またはサーバーに代わって、二度目の確認を推測して入力しないでください。CLI が確認を求めた場合は、その内容をそのまま伝え、ユーザーが明示的に同意して y を入力するまで待ってください。

参考資料

• 特定のコマンドを作成する場合、必須・デフォルト・オプションのパラメーターを確認する場合、ページネーションを処理する場合、またはフィールドをマッピングする場合は、CLI パラメーターをお読みください。
• 通貨ペア、通貨、注文タイプ、注文ステータス、約定または注文のフィールド、エラーを選択または説明する場合は、辞書をお読みください。
• 証券口座の資金、ポジション、証券注文、証券の約定には、futu-tradingを使用してください。