Financial platforms are increasingly usable outside a mobile app or desktop window. Market data and brokerage tools now show up inside developer environments, automated workflows, software applications, and AI assistants.

Webull CLI extends Webull into the command line. If you already work in a terminal, you can pull quotes, run screens, check positions, and place supported orders without switching to another interface — and you can wire any of it into something larger.

Key Takeaways 

• One interface, five asset classes. Stocks and ETFs, options, futures, crypto, and event contracts — market data and trading in a single command-line tool.

• Agent-first by design. Structured output, a quiet mode, machine-readable errors, and explicit exit codes — built to be called by software, not just by people.

• Different from MCP. Cloud MCP and Local MCP are built around AI assistants. The CLI works with or without one.

• Alpha Preview. Commands, flags, and output formats may continue to change between releases.

Why Webull Built a CLI

Webull's mobile and desktop platforms are built around direct interaction. You open the app, research a stock, check your portfolio, place a trade.

For developers and technical users, those same tasks are often one step inside a bigger process. You might pull market data into an application, feed positions into a recurring portfolio report, or run a screen on a schedule without opening a brokerage platform at all.

The CLI gives you a direct, programmable path to Webull. Run a command by hand, or drop that same command into a script, an application, or a scheduled job. This makes it especially useful for developers, active traders, power users who want to work directly from the terminal, and AI builders wiring Webull into agents and software.

What You Can Do With Webull CLI

Market data and research. Pull snapshots, historical OHLCV bars, order book depth, and tick-by-tick trade data, with coverage varying by asset class. Research commands reach company profiles, income statements, balance sheets, cash flow statements, analyst ratings and target prices, earnings and dividend calendars, SEC filings, and capital flow. Screeners cover gainers and losers, most actives, sector rankings, high-dividend names, and 52-week highs and lows. Real-time quotes require an active market data subscription.

Account information. Review accounts, balances, and positions, then feed any of it into a dashboard, a report, or a process that pairs your holdings against current market data.

Trading across five asset classes. Submit, preview, replace, and cancel orders in stocks and ETFs, options, futures, event contracts and crypto (no preview/replace), subject to account eligibility, region, and product availability. Multi-leg option strategies and combo orders are supported where available.

Watchlists and market monitoring. Create, update, and reorder watchlists, query supported instruments, and review broader market or sector activity — useful for a quick check or as the data layer under a larger monitoring system.

Capabilities worth calling out

A few areas go deeper than a typical quote-and-trade tool:

Deeper data

• Fund and ETF data. Nine commands covering briefs, performance returns, NAV history, top holdings, asset allocation, ratings, dividend history, splits, and regulatory filings.

• NOII. NASDAQ opening and closing auction imbalance data — paired shares, imbalance side, and reference, near, and far prices — available as bars and as a real-time snapshot.

• Batch bars. OHLCV candlestick history for multiple symbols in a single call.

• Footprint. Large-order flow aggregated by time interval, including buy and sell totals, delta, and size breakdown, for stocks and futures.

• Financial indicators. Key ratios such as ROA, ROE, and EPS across multiple quarterly or annual periods.

• Financial alert. Upcoming earnings release estimates compared against prior-year actuals.

More control over execution

• Algo orders. TWAP, VWAP, and POV execution for stock orders, with configurable participation rates and time windows.

• Fractional shares. Cash-amount orders (entrust-type=AMOUNT) for dollar-based fractional purchases.

• Option contract filtering. Query by underlying, strike range, call or put, American or European style, expiration window, and penny-program eligibility.

Easier setup

• doctor. A one-pass diagnostic of your config file, active profile, credentials, and network connectivity.

From Commands to Workflows

The value of a CLI isn't that a click becomes a keystroke. It's that a command becomes a component.

Output is structured and pipe-friendly, with CSV export available and errors returned in a machine-readable form that scripts can act on. A trader collects market and account data into a recurring portfolio report. A developer feeds Webull data into an analysis pipeline. A scheduled script checks a watchlist every morning and produces exactly the summary you need before the open. For continuous integration and automation, credentials can come from environment variables instead of an interactive login.[WZ6] [IJ7] 

The CLI handles the Webull portion. What you build around it is up to you.

Where Webull CLI Fits With Cloud MCP and Local MCP

The CLI joins Webull's growing AI and Model Context Protocol (MCP) ecosystem. The simplest way to tell them apart is to ask who or what is doing the interacting, and how much access you want to grant.

None of these replace the others. If you want an assistant to review an account, Cloud MCP is the shortest path. If you're building an AI coding workflow that needs to act, Local MCP fits. If you already know exactly which operation needs to run — and want it to run repeatedly — the CLI is the more direct building block.

Staying in Control as Trading Becomes More Programmable

Programmable brokerage tools make workflows more efficient. They also make visibility more important.

Order submission, cancellation, and replacement prompt for confirmation when run interactively. A dry-run mode lets you validate parameters without submitting anything, and order preview commands estimate cost before a live order goes out. App Key, App Secret, and two-factor tokens are stored in your operating system's credential store — Keychain on macOS, Credential Manager on Windows, Secret Service on Linux — rather than plaintext configuration files. Webull also recommends running new workflows against the test environment before pointing them at production.

These controls matter most once commands are running inside scripts and automated systems. Automation should reduce repetitive work, not reduce visibility. You remain responsible for reviewing order details, monitoring positions, understanding the behavior of connected tools, and confirming that your workflows operate as intended.

Getting Started

Webull CLI is a single Go binary. Install it with go install, or download a pre-built binary from the GitHub repository. You'll need Webull API credentials first plus a market data subscription if you want real-time quotes. Full setup steps and the complete command reference live in the Webull CLI documentation.

The project is currently in Alpha Preview, so commands, flags, capabilities, and output formats may continue to evolve.

Webull CLI gives developers, traders, and technical users direct terminal access to market data, account information, and trading across five asset classes. It's built for the workflows that already live outside a brokerage app. If that's where your work already happens, the CLI is another way to bring Webull to it.

Disclaimer:
The Webull OpenAPI and MCP Server are provided "as is" without warranty of any kind and do not constitute investment advice. All trading involves a substantial risk of loss. By utilizing these tools, you acknowledge that Al-driven agents may misinterpret instructions, act on delayed data, or perform poorly under certain market conditions. Webull assumes no liability for losses resulting from automated or Al-directed decisions. You are solely responsible for verifying all order details prior to execution, actively monitoring your positions, and ensuring that any connected agents, algorithms, or tools operate exactly as intended.

Webull Financial LLC, Member SIPC, FINRA. Investing involves risk. More info at webull.com/disclosures