mcpField
M
moomoo-quote

moomoo-quote

github.com/moomooopenData & databases2174 installsUpdated 4d ago
Repository

About moomoo-quote

moomoo-quote is a skill that uses the locally available `moomoo` CLI to query market data and quotes. It guides command selection, symbol formatting, authentication checks, and pagination while distinguishing one-off queries from live streaming.

Key features

  1. 01Query market data through `moomoo` CLI
  2. 02Normalize market and ticker symbols
  3. 03Check authentication and connectivity
  4. 04Follow quote pagination tokens
  5. 05Direct live-stream requests to WebSocket push

Use cases

  1. 01Retrieve a quote for a specified market symbol
  2. 02Fetch paginated historical quote data
  3. 03Identify the right route for live quote updates

Install

Copy the command and run it in a terminal.

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

After installing, type/moomoo-quotein Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
cli-parameters.md
dictionaries.md
pagination.md
websocket-push.md

Details

From the project README

moomoo Quote

Use the locally available moomoo CLI for market data and quote queries. Answer in the user's language by default; keep commands, flags, JSON fields, symbols, enum values, and error codes unchanged.

Install the moomoo CLI

This skill requires the moomoo CLI. Resolve the binary from PATH, ~/.moomoo/bin/moomoo, or %LOCALAPPDATA%\MoomooCLI\bin\moomoo.exe on Windows.

If the binary is missing, ask the user, then install it. Do not run the installer without explicit consent.

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

To update an existing CLI, run moomoo update.

Add or update this skill with npx:

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

Rules

  • Before quote commands, if moomoo cannot be resolved, follow Install the moomoo CLI.
  • Before any authenticated market data command, prefer moomoo auth status --format json; for network reachability, use moomoo check --format json.
  • As this skill's invocation convention, always append the hidden internal marker --source skill to the end of the command when invoking moomoo from Bash. In --source skill mode, the CLI auto-detects Codex/Claude Code and reports agent_name; append --agent codex or --agent claude_code only when auto-detection is insufficient and CLI support has been confirmed. Do not include these internal markers in commands shown to the user.
  • Never read or print token file contents. The CLI attaches OAuth Bearer auth automatically. PERMISSION_DENIED is a server-side permission or market data entitlement denial, not proof that the token header is missing.
  • Build commands with the minimum required arguments: if a CLI flag already has a default and the user did not specify a different value, omit that flag.
  • Add --format json only when the agent needs to parse command output. Commands shown for the user to run may use default table output.
  • Quote symbols use MARKET.CODE, such as US.AAPL, HK.00700, SH.600519, SZ.000001, and CC.BTCUSD. The CLI normalizes HK.700 to HK.00700 and uppercases markets/tickers. Do not pass old suffix format like 700.HK or bare tickers like AAPL unless the market can be confidently resolved first.
  • User mentions of old REST endpoint command names must be mapped to the current aggregate command and selector flag. Do not call unregistered flat endpoint commands.
  • For paginated quote interfaces, use --format json and follow pagination.has_more / pagination.next_key exactly. next_key is opaque and must not be parsed or constructed.
  • history-kline and capital --view history use --next-time, not --next-key.
  • watchlist --action add/delete/move-out mutates the user's watchlist. Confirm target group and symbols unless the user has already explicitly requested that mutation.
  • Do not execute securities, crypto, or simulated trading orders. Use moomoo-trading for securities trading, moomoo-crypto for cryptocurrency trading, and the simulation trading skill for simulated trading.
  • For live streaming (subscribe, push quote/order book/ticker/K-line, real-time broker queue), the CLI does not replace OpenD. Direct the user to Open API Quote Push WebSocket (wss://webapi-quote.moomoo.com/ws): auth, subscribe, broker queue as BROKER_QUEUE. Read WebSocket push reference and websocket-quote-push.md. Do not use OpenD or removed moomooapi subscribe scripts.

References

  • Read CLI parameters when constructing quote commands, selecting aggregate command variants, or checking required/default flags.
  • Read dictionaries when mapping user language to markets, security types, K-line types, adjustment types, sessions, plate classes, option filters, or interpreting quote enum fields.
  • Read pagination when fetching multiple pages or explaining how quote pagination works.
  • Read websocket-push when the user needs live push or broker queue instead of one-off REST quotes.

Comments

Markdown supported