Brokers
Webull
Connect Webull with one developer API key that covers every account, get a paper trading key, copy trade stocks and options, use it as an RSA fan-out target, and fix common connection problems.
Webull connects through its official developer API, not your Webull email and password. You generate an App key and App secret once on Webull’s developer portal, and that one pair connects every account under your Webull login. All of them are discovered and traded automatically from a single connection.
| What it trades | Supported |
|---|---|
| Stocks | Yes, in Copy Trading strategies and from the Trade page |
| Options (single-leg) | Yes, in Copy Trading strategies |
| Spreads | Yes, in Copy Trading strategies, on a margin account with $2,000 or more. See Spreads |
| RSA (reverse split arbitrage) | Yes |
| Crypto | No |
Because Webull uses a stable API connection instead of a browser, there is no captcha and no verification code to enter when you connect. You add one key pair and TradeLabs finds all your Webull accounts.
Before you start
- A funded Webull brokerage account under your own name.
- An App key and App secret from Webull’s Developer Console: a live key, a paper key, or both.
- The TradeLabs Companion installed and running.
Get a live API key
A live key trades your real Webull accounts. You apply for API access once, Webull reviews it, and then you make the key.
-
Go to webull.com and click Log in in the top right. Sign in with the login of the Webull account that you want to trade.
-
Click your avatar in the top right, then click Developer Console. Stay on the live side: if the top left shows paperTrade, switch back to live first.
-
In the left menu, click Access Credentials, then API Keys. Click Apply for API Service.
Webull reviews the application. This takes 1 to 2 business days, and you need an open Webull brokerage account to apply. Webull tells you by email when it is approved.
-
When it is approved, go back to API Keys and click Register an API Application. Fill in the form:
- Application Name: any name, for example “TradeLabs”.
- API Permissions: keep both, Market Data and Trading.
- Add More Address Segments: leave it empty. TradeLabs does not need an IP whitelist.
- Enable 2FA Verification: on by default. You can keep it on. See step 3 of Connect it in the app.
Click Submit.
-
On the application row, click Generate Key in the Operate column. Copy the App Key and the App Secret from the pop-up. The Key Status changes to Generated.
Webull shows the App Secret only once. Copy it before you close the pop-up. If you lose it, click Reset Key on the row: you get a new pair, and the old key stops working immediately.
The pages look the same as the paperTrade ones below, without the orange paperTrade banner.
Get a paper trading key
Webull’s paper trading has its own key pair. Orders on a paper key are simulated, and no real money moves. Each paper account starts with $1,000,000. A paper key does not work in Live mode, and a live key does not work in Paper mode.
-
Sign in to Webull’s Developer Console. In the top left, click paperTrade, then click Confirm Switch. An orange banner tells you that paperTrade does not touch your real account.
-
In the left menu, click API Keys. If you see Account Required, click Create Account to make your paper account first.
No paper account yet: click Create Account
- Click Apply for OpenAPI for PaperTrade. Webull approves it automatically, usually within a few minutes.
Apply once for paper API access
- Click Register an API Application. Type an Application Name, for example “TradeLabs PaperMode”. Keep both API Permissions, Market Data and Trading. Click Submit.
Register an application for the paper key
- On the application row, click Generate Key in the Operate column. Copy the App Key and the App Secret from the pop-up.
Click Generate Key. The Key Status changes from Not Generated when the key exists
Webull shows the App Secret only once. Copy it before you close the pop-up. If you lose it, click Reset Key on the row. The old key stops working immediately.
You do not need to add an IP under OpenAPI Whitelisted IPs for a paper key.
A Reset of your paper funds (avatar, then My Account) resets every paper account and gives each one a new account ID. TradeLabs reads the account list again when you sign in, so click Sign in on the account row after a reset.
Connect it in the app
- Open the Brokers page, find the Webull card, and click Add account.
- Fill in the connect form: an optional Label, the Mode, your App key, your App secret, and the Region (United States or Hong Kong). Set Mode to Live for a key from the live side of the Developer Console, or to Paper for a key from paperTrade. Then click Save account. Your credentials are encrypted on your device.

The Webull connect form. Pick Live or Paper to match the key
-
Click Sign in on the account row. TradeLabs verifies the key pair with Webull and discovers every account under your login at once.
If Enable 2FA Verification is on for your live key, Webull asks you to approve the sign-in. Approve it in the Webull app within 5 minutes, then click Sign in again. You do this once: the approval stays good as long as TradeLabs uses the key at least once every 15 days. Paper keys do not ask.
When the key pair checks out you see a Webull signed in confirmation. You do not add each account separately: one key pair connects them all.
To use both, add the live key and the paper key as two accounts on the Webull card, one in each Mode. A paper account shows paper next to its key on the account row.
Add Webull to your strategy, or signals do not go to it.
Copy trading
Pick Webull on the Brokers tab of a Stocks, Options or Spreads strategy. One key pair finds every account under your login. To trade one account only, pick it with the strategy’s account choice.
Order types
- Stocks get Market or Limit. A limit posts at the Bid, Mid or Ask, or at the price in the alert (From alert), plus your Buy limit offset or Sell limit offset.
- Options are limit only, because Webull’s API takes no market order for an option. The editor hides Market. A market entry goes out as a limit at the ask.
- Allow extended hours (Stocks only): pre-market and after-hours orders go out as a limit. The app uses the extended session only when the regular session is closed. A market exit outside regular hours goes out as a limit at the bid.
- Fractional shares: if your Webull account cannot trade fractions, Webull refuses the order. The app then buys whole shares instead.
Entries
- Reprice entry until filled: an unfilled limit buy moves up to the ask, never more than your cap above the first limit. Set Re-price every and Most re-prices to choose how often and how many times. Webull cannot change an order, so the app cancels it, waits until Webull confirms the cancel, and places the rest again.
- Wait for the break: the buy waits at the broker until the price breaks your level. Regular session only. On options it uses the contract price. A break on the stock price is refused on Webull options, so nothing is bought early.
- Wait for the price to come back: when the price is past your Slippage cap at the alert, the app waits for it to come back inside the cap, up to your Cancellation timer. See Wait for the price to come back.
- Cancellation timer: cancels a buy that is not filled in time.
- Automatic quantity: “Buying 300 shares” buys 300 shares, not the strategy size.
Stop loss, take profit, and trailing
Webull has no bracket order in its API, so the app watches the price for you, as on Robinhood. The app has to be running for these exits to fire.
- Stop loss, Take profit and Trailing stop, with every trailing mode: Arm at profit, Breakeven flip, Replace take profit and Partial TP.
- Sell in stages: each level sells its share of the original position. The rest stays on your stop loss or trailing stop.
- Move stop after a trim, and a stop move after each Sell in stages level.
- Reprice exit until filled: an unfilled limit exit from an alert moves down one step at a time, never below your Max drop. The app cancels the order, checks what filled, and places the rest at the new price.
- The app sells only this strategy’s shares. It never sells shares that another strategy or you bought.
- The app never stacks sells. It cancels its own working buy or sell for the ticker first, and waits until Webull confirms the cancel.
- A full close, such as “All out”, sells the whole amount the strategy holds, also after adds.
The price the app checks for these levels comes from your exit setting. See Which price the exits check.
Protections
Double-down protection works with a limit by value, by quantity or by count. Daily loss limit and Profit giveback limit work as on the other brokers. See Protections.
Spreads
Webull copy trading takes spreads: verticals (debit and credit), iron condors and other multi-leg orders Webull has a strategy for. The app sends each spread as one Webull order, priced from the legs, and closes it as one order.
- You need a margin account with $2,000 or more of equity. Webull refuses any order with a short leg below that, and a cash or IRA account cannot hold spreads at all. The app shows Webull’s refusal on the trade.
- Stop loss, take profit and trailing stop run in the app and close the whole spread as one order.
- Wait for the break, Reprice entry until filled, Reprice exit until filled, Move stop after a trim, the stop moves per Sell in stages level and Wait for the price to come back work on Webull spreads. Wait for the break waits on the stock price or on the net price of the spread. See Wait for the break on a spread.
- Smart expiration detection does not run on Webull spreads yet. The legs go out at the expiration the alert names.
- Allow extended hours does not apply: Webull takes spread orders in the regular session only.
- Smart price override is for single options only. A spread is priced from its legs. For every setting on Webull spreads, see What each broker supports.
- Ratio spreads (such as 1x2) are refused, because Webull has no strategy for them.
How low-priced stocks are handled
This section is about RSA strategies. Reverse-split arbitrage often involves stocks trading well under a dollar, and Webull rejects a plain 1-share order on those. TradeLabs handles this for you, so nothing changes on your end:
- Under $1.00: it buys 100 shares, then sells 99, leaving you holding 1 share.
- Under $0.10: it buys 1000, then sells 999, again leaving 1 share.
- $1.00 or above: a normal order is placed.
This works best during regular market hours, when the buy fills quickly and the trim sells cleanly. Outside market hours the orders can sit unfilled, so run low-priced Webull names during regular hours.
Buying 100 and selling 99 crosses the bid/ask spread two times. On a wide book, that can cost more than the RSA trade makes. Turn on Max spread on the strategy’s Protections tab to skip buys on a wide book. Webull is the only broker that reads it. See Max spread.
Fixing common problems
- Connection fails right after saving: double-check the App key and App secret. They are long strings and easy to mis-paste, and a bad pair is reported as rejected credentials. Confirm the Region matches your account.
- A paper key is rejected: check that Mode is Paper. A key from paperTrade only works in Paper mode, and a live key only works in Live mode. Paper keys are for United States accounts.
- Orders go to the wrong place: check the Mode on the account row. Live and Paper use separate keys and separate accounts. Add the Webull account that you want to the strategy.
- No accounts show after connecting: confirm the account under your Webull login is funded and active, then sign in again. The account list is fetched live from Webull. You can also run Check connection from the account row’s menu.
- Minimum order size rejections: you should not see these, since TradeLabs handles the low-priced rules for you. A rejection during off-hours usually means a market order could not fill while the market was closed. Trade during regular hours.
Using Webull with RSA
Once Webull is connected, add it to an RSA strategy and make sure the strategy is active. See RSA setup for the full walkthrough, and broker limits for the per-account caps. The one key pair covers every account under your Webull login.