moomoo-trading

moomoo Trading

使用本地可用的 moomoo CLI 进行证券交易。默认使用用户的语言回答；命令、标志、JSON 字段、错误代码和代码不变。

安装 moomoo CLI

此技能需要 moomoo CLI。从 PATH、~/.moomoo/bin/moomoo 或 Windows 上的 %LOCALAPPDATA%\MoomooCLI\bin\moomoo.exe 查找二进制文件。

如果找不到二进制文件，请先询问用户，然后再安装。未经明确同意，不要运行安装程序。

macOS / Linux：

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

Windows PowerShell：

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

要更新现有 CLI，请运行 moomoo update。

使用 npx 添加或更新此技能：

npx skills add -y -g MoomooOpen/moomoo-agent-hub --skill moomoo-trading
npx skills update moomoo-trading -g -y

规则

• 在运行账户或交易命令之前，如果无法解析 moomoo，请按照安装 moomoo CLI 中的说明操作。
• 对于身份验证状态，优先使用 moomoo auth status --format json；对于网络连通性，使用 moomoo check --format json。
• 按照此技能的调用约定，通过 Bash 调用 moomoo 时，始终在命令末尾附加隐藏的内部标记 --source skill。在 --source skill 模式下，CLI 会自动检测 Codex/Claude Code 并报告 agent_name；仅在自动检测不足且已确认 CLI 支持时，才附加 --agent codex 或 --agent claude_code。不要在向用户展示的命令中包含这些内部标记。
• 切勿读取或打印令牌文件的内容。CLI 会自动附加 OAuth Bearer 身份验证。PERMISSION_DENIED 表示服务端拒绝了权限，并不能证明令牌标头缺失。
• 使用最少的必需参数构建命令：如果 CLI 标志已有默认值，且用户未指定其他值，则省略该标志。
• 不要假定存在默认账户。只有在本次会话通过 moomoo auth status 或配置确认已设置默认账户后，才可省略 --account；否则列出账户或询问用户选择一个，然后明确传入 --account。
• 仅当 Agent 需要解析命令输出时，才添加 --format json。向用户展示的命令可以使用默认的表格输出。
• 证券代码参数是采用 MARKET.CODE 格式的 symbol 值，例如 US.AAPL 和 HK.00700。HK.700 会规范化为 HK.00700，小写市场代码/证券代码会转换为大写。不要传入 700.HK 这类旧后缀格式或 AAPL 这类不带市场代码的证券代码。
• 历史 --start / --end 筛选条件使用微秒 Unix 时间戳。表格时间列以 UTC+8 显示；JSON 输出保留原始 API 字段。
• 订单和成交列表命令会自动分页。面向用户的 CLI 对证券订单/成交列表仅提供 --page-size，不提供 --page-flag。
• 每次调用 account cash-logs 只会返回一页。使用 --format json，然后传入上一条响应中的 --page-flag，直至 completed 为 true。
• order fees 需要具体的 order_id。Open API 目前不支持外汇订单费用。
• margin-ratio 需要 --security-firm 和 --codes（最多 10 个代码）。优先使用 account list --format json 返回的 security_firm。
• 修改真实账户需要先获得用户明确确认：order buy、order sell、order place、order modify 和 order cancel。
• 不要虚构券商确认。如果 CLI 因 API 返回 need_order_confirm=true / confirm_id 而报告需要券商确认，请转达提示并等待用户明确批准后再发送 y。

参考资料

• 构建命令或判断哪些标志是必需、可选或有默认值时，请阅读CLI 参数。
• 选择或解读市场、方向、订单类型、状态或账户市场值时，请阅读字典。
• 加密货币交易所交易请使用 moomoo-crypto。