mcpField
M
moomoo-sim-trading

moomoo-sim-trading

github.com/moomooopen其他2163 次安装2 天前更新
代码仓库

关于 moomoo-sim-trading

moomoo-sim-trading 是供 Agent 通过 moomoo CLI 进行模拟、纸面或演示证券交易的技能,仅限模拟交易。它将模拟命令与真实交易分开,并要求变更模拟账户前明确订单信息。

主要功能

  1. 01使用 moomoo sim 执行模拟命令
  2. 02明确识别模拟账户
  3. 03规范带市场前缀的股票代码
  4. 04区分模拟交易与真实交易
  5. 05订单变更前确认详细信息

适用场景

  1. 01查看模拟账户和订单
  2. 02提交或修改纸面交易订单
  3. 03练习交易且不影响真实资产

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/moomooopen/moomoo-agent-hub --skill moomoo-sim-trading

安装后在 Claude Code 中输入/moomoo-sim-trading确认已加载。

附带文件references/cli-parameters.mdreferences/dictionaries.md

详细介绍

moomoo 模拟交易

仅使用本地可用的 moomoo sim ... CLI 进行模拟、纸面或演示交易。默认使用用户的语言回答;命令、标志、JSON 字段、代码、账户 ID、订单 ID 和错误代码保持不变。

安装 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-sim-trading
npx skills update moomoo-sim-trading -g -y

与真实交易的界限

  • 仅当用户明确要求模拟交易、纸面交易、演示交易或 sim 命令时,才使用此技能。
  • 如果用户只说“买入”“卖出”“下单”“修改订单”或“取消订单”,但没有说明是模拟/纸面/演示交易,则不要假定为模拟交易。请询问用户指的是模拟交易还是真实交易。
  • 切勿在此技能中使用真实证券命令,例如 moomoo order ...、moomoo position 或 moomoo account funds。模拟交易的对应命令位于 moomoo sim ... 下。
  • 切勿在此技能中使用加密货币命令,例如 moomoo crypto ...。
  • 模拟订单不会影响真实资产,但仍会更改用户的模拟账户状态。在提交、修改或取消模拟订单前,必须明确账户、市场、代码、方向、数量、价格/订单类型和订单 ID。

规则

  • 执行模拟交易命令前,如果无法解析 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 表示服务端拒绝了权限,并不能证明缺少令牌标头。
  • 仅使用 moomoo sim ... 下合并后的高级命令;不要调用旧的扁平端点名称,例如 sim-trade-*。
  • 使用最少的必需参数构建命令:如果某个 CLI 标志已有默认值,且用户没有指定其他值,则省略该标志。
  • 优先使用 moomoo sim account list --format json 确定模拟账户,然后显式传入 --account <sim-account-id>。不要将真实证券账户 ID 当作模拟账户 ID。
  • 仅当 Agent 需要解析命令输出时,才添加 --format json。向用户展示的命令可以使用默认的表格输出。
  • 模拟交易代码使用 MARKET.CODE 格式,例如 US.AAPL 和 HK.00700。CLI 会将 HK.700 规范化为 HK.00700,并将市场/代码转换为大写。除非能先准确确定市场,否则不要传入旧后缀格式,例如 700.HK,或不带市场的代码,例如 AAPL。
  • 模拟历史订单分页使用 --next-key;请原样传入上一条响应中的 pagination.next_key。

参考资料

  • 构建模拟交易命令,或确定哪些标志为必填、可选或默认值时,请阅读 CLI 参数。
  • 选择或解读模拟市场、订单方向、订单类型、交易时段、订单状态或常见模拟交易错误时,请阅读 字典。
  • 实盘证券账户、实盘资金、实盘持仓和实盘证券订单请使用 moomoo-trading。加密货币交易请使用 moomoo-crypto。市场数据查询请使用 moomoo-quote。

评论

支持 Markdown