Webull OpenAPI Skill

AI agent skill for Webull OpenAPI — enables AI assistants to trade stocks, options, futures, crypto, and event contracts, query market data, and manage accounts via CLI.

Built on the official webull-openapi-python-sdk. Supports US, HK, JP, SG, MY, UK, MX, BR, and ZA regions with configurable risk controls.

---

⚠️ Disclaimer

The information provided by this tool is for reference only and does not constitute investment advice. Trading involves risk; please make decisions carefully.

See DISCLAIMER.md for the full disclaimer.

---

Features

• Multi-Region Support — US, HK, JP, SG, MY, UK, MX, BR, and ZA regions with region-specific order types, trading sessions, and validation
• Market Data — Real-time snapshots, tick data, quotes (depth), footprint, and OHLCV bars for stocks, options, futures, crypto, and event contracts
• Trading — Place, modify, cancel orders for stocks, options, futures, crypto, and event contracts
• Combo Orders — OTO, OCO, OTOCO combo orders (US only)
• Option Strategies — Multi-leg option strategies: vertical, straddle, strangle, butterfly, condor, etc. (US only)
• Option Leg In/Out — Leg into or out of an existing multi-leg position on single-leg orders — both option (option-place) and equity (place, e.g. the stock leg of a covered-stock strategy) (US only)
• Algo Orders — TWAP, VWAP, POV algorithmic orders (US only)
• Risk Controls — Market-specific notional limits (USD/HKD/CNH), quantity limits, symbol whitelist
• Auto Account Resolution — Automatically selects the correct account based on asset type
• Audit Logging — All order operations are logged for compliance
• 2FA Support — Interactive authentication flow for accounts with Two-Factor Authentication
• Region-Aware Disclaimer — Output includes region-appropriate disclaimer (English for US/JP/SG/MY/UK/MX/BR/ZA, trilingual for HK)

---

Example Prompts

Here are some prompts you can use with your AI assistant:

Market Data

• Show me AAPL’s daily bars for the last 5 days
• Get a real-time snapshot for AAPL, MSFT, and GOOGL
• What’s the current bid/ask for TSLA?

Account & Portfolio

• What’s my account balance and buying power?
• Show me all my current positions
• List all my linked accounts

Stock Trading

• Place a limit order to buy 100 shares of AAPL at $250
• Place a market order to sell 50 shares of TSLA
• Short 10 shares of NVDA at $120

Options Trading

• Buy 1 AAPL call option, strike $250, expiring 2026-04-17, limit price $5.00

Order Management

• Show me my order history for the last 7 days
• Cancel order with ID abc123