futu-crypto

Futu Crypto

使用本地可用的 futu CLI 进行加密货币交易。默认使用用户所用的语言作答。命令、标志、JSON 字段、交易对和错误代码均保持原样。

Futu CLI 运行环境

此技能需要官方 futu CLI。macOS 和 Linux 会将其安装到 $HOME/.futu/bin/futu。Windows 会将 futu.exe 安装到 %LOCALAPPDATA%\FutuCLI\bin。请参阅 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。如果当前 shell 仍无法找到 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。