← Blog 2 October 2026

What an options bot needs from Webull

Two things stop an options bot before it places a single order, and neither is software: the API keys, and the market‑data agreement behind them. Both take longer to arrange than installing the app.

You need two sets of keys, not one

In the Webull app, under Settings → API Management, you create an app key and an app secret. Request paper first. Then request live as well, even if you have no intention of trading real money yet.

That second part reads like a mistake and is not. Market‑data entitlement attaches to the live key. Quotes come from the live endpoint while orders route to paper, so with paper keys alone the session connects, reports a balance, and cannot price a single contract. The symptom is an app that looks fully working and never trades.

Real-time options data, and specifically the non-display kind

Options quotes are OPRA data and real‑time access is a paid entitlement on your account. There is a distinction inside that which matters more than it sounds: display use is data a human looks at on a screen, and non‑display use is data consumed by a program. An automated strategy is non‑display use, and it is a separate agreement.

Get the wrong tier and nothing announces it. Your keys authenticate, the app connects, quotes arrive — and they are delayed. The failure is silent and it is expensive, because a bot reading delayed quotes is placing orders against prices that have already gone.

Why delayed data cannot be worked around

A short‑dated options contract priced between ten cents and a dollar moves a meaningful fraction of its premium in seconds. A strategy that buys the first confirmed move off the opening low is making a decision inside that window. Fifteen minutes of delay does not degrade it; it inverts it — you are reacting to a reversal that already completed, and the limit price you calculate is attached to a quote that no longer exists.

No amount of smoothing, retrying or clever order placement recovers that. It is the one prerequisite with no software answer, which is why it is worth settling before you spend an evening on configuration.

What else the account has to allow

• Options approval at the right level. Buying calls and puts is the lowest tier, but it still has to be enabled, and short‑dated contracts are sometimes gated separately.
• Pattern day trader rules. Under the US $25,000 equity threshold you get a limited number of day trades in a rolling five sessions. A strategy that opens and closes inside one session consumes one each time. This catches people out in week two, not week one.
• A paper account that actually exists. Paper and live are separate accounts with separate keys, and the paper one has to be opened before its keys will work.

A sensible order to do it in

1. Open the paper account and request paper API keys.
2. Request live API keys in the same place.
3. Apply for real‑time options data, naming the non‑display or API agreement. Expect this to take a day or more.
4. Only then install and configure. Everything before this point is waiting on someone else.