moomoo Trading

Use this skill when the user wants market data or stock trading through moomoo/Futu OpenAPI and a local OpenD gateway.

Read This First

• Read references/setup-guide.md for installation, package choice (futu-api vs moomoo-api), OpenD login, and troubleshooting.
• Read references/api-reference.md when you need exact method names, return shapes, or trade-query semantics.
• All bundled scripts lazy-load the SDK, so --help works even if neither Python package is installed yet.

Safety Rules

• Default to simulated trading unless the user explicitly asks for live trading.
• Live order placement, modification, and cancellation require --env real --confirm.
• scripts/trade.py also requires a live-trading unlock password via MOOMOO_UNLOCK_PASSWORD by default, or another env var name passed with --unlock-password-env. The script unlocks for the requested action and then re-locks.
• For cancel/modify actions, pass --market unless you also provide a ticker so the script can infer the correct trade context.
• Do not put a raw trading password directly on the command line. Use an environment variable.

Scripts

Setup check

python3 scripts/setup_check.py
python3 scripts/setup_check.py --market HK --account-index 1

Checks quote connectivity, lists discovered trading accounts, and verifies simulated account access.

Quotes and K-lines

python3 scripts/quote.py US.AAPL HK.00700
python3 scripts/quote.py US.TSLA --snapshot
python3 scripts/quote.py US.NVDA --kline --ktype K_DAY --count 10
python3 scripts/quote.py US.NVDA --kline --start 2026-03-01 --end 2026-04-01 --extended-time

Trading

python3 scripts/trade.py --ticker US.AAPL --action buy --qty 10 --price 150 --type limit --env sim
python3 scripts/trade.py --ticker US.AAPL --action sell --qty 5 --type market --env sim
export MOOMOO_UNLOCK_PASSWORD='your-trading-password'
python3 scripts/trade.py --ticker US.AAPL --action buy --qty 10 --type market --env real --confirm
python3 scripts/trade.py --cancel --order-id 12345 --market US --env sim
python3 scripts/trade.py --modify --order-id 12345 --market US --price 155 --qty 10 --env sim

Useful extras:

• --remark adds an order remark.
• --account-id / --account-index let you target a specific trading account.

Portfolio, orders, and deals

python3 scripts/portfolio.py --env sim
python3 scripts/portfolio.py --env sim --account
python3 scripts/portfolio.py --env sim --orders
python3 scripts/portfolio.py --env real --history-orders --start 2026-04-01 --end 2026-04-02
python3 scripts/portfolio.py --env real --deals

--orders shows open orders. --history-orders shows historical orders. --deals shows today's deals, or historical deals when paired with --start / --end.

Price alerts

python3 scripts/watchlist.py --tickers US.AAPL,US.TSLA --above 200 --below 150
python3 scripts/watchlist.py --tickers US.NVDA --above 950 --quit-on-alert
python3 scripts/watchlist.py --tickers HK.00700 --below 320 --once

Alerts trigger once per threshold crossing by default. Use --repeat-alerts to spam every polling cycle instead.