How to use IBKR TWS for options trading.

Quick answer

Trader Workstation (TWS) is Interactive Brokers’ desktop platform and the execution gateway behind most IBKR-connected options tools. To trade options in it you need three things in place: options trading permissions on the account, real-time options market data, and a working order ticket such as OptionTrader. If you use a third-party front end, TWS or IB Gateway must also have its API enabled.

This guide walks through each step in order, then covers order types, placing a spread, combining TWS with TradingView charts and fixing the errors traders hit most often.

Step 1: enable options trading permissions

Options are not enabled on a new IBKR account by default. Request them in the Client Portal before you debug anything else; most “no trading permission” rejections start here.

1. Log in to the IBKR Client Portal and open Settings.
2. Find Trading Permissions and add Options for the markets you trade, for example US equity options.
3. Review the financial profile and trading experience IBKR asks for. Eligibility for each options level depends on it.
4. Submit the request and wait for approval, which usually takes a business day or two.

IRAs and cash accounts restrict which strategies you can use. Buying calls and puts is usually allowed; spreads and uncovered positions need a margin account and a higher options level.

Step 2: subscribe to options market data

Without a real-time subscription, option quotes are delayed or missing, chains look empty and API tools may refuse to trade. For US listed options the key feed is OPRA (Options Price Reporting Authority); you also need data for the underlying stock.

Subscribe under Settings → Market Data Subscriptions in the Client Portal. Most individual traders qualify for non-professional pricing; check the current fees there, because they change.

A paper account does not get its own subscriptions. In the paper-trading settings you can share the live account’s market data with the paper account; until you do, paper quotes are delayed.

Step 3: install TWS and choose Live or Paper

1. Download Trader Workstation from Interactive Brokers and install it. The “latest” build gets features first; the “stable” build changes less often.
2. Log in with your IBKR username. On the login screen choose Live Trading or Paper Trading.
3. Complete two-factor authentication. Plan for this before the market opens, not in the middle of a trade.

Start in Paper. The order tickets, API settings and error messages are the same, and mistakes cost nothing.

Step 4: enable the API for third-party tools

Skip this step if you only click orders inside TWS. Any external tool, including OptionTrigger, talks to TWS or IB Gateway through its socket API, which is off by default.

1. In TWS open File → Global Configuration (Edit → Global Configuration on some versions), then API → Settings.
2. Check Enable ActiveX and Socket Clients.
3. Uncheck Read-Only API if the tool needs to place orders.
4. Note the Socket port, or change it to match your tool.
5. Keep Allow connections from localhost only checked so nothing outside your computer can reach the port.
6. Click Apply and OK. Re-check these settings after a TWS update.

Defaults can be changed, so the rule is simple: the port configured in TWS or IB Gateway must be the port your tool connects to. Never forward the API port to the internet.

The TWS options toolkit

TWS has more options tools than most traders use. These are the ones worth learning first.

Start with OptionTrader. The other tools pay off once you trade spreads or manage several positions at once.

Placing a single-leg option order in TWS

1. Open OptionTrader for the underlying and pick the expiry.
2. Click the ask of the call or put you want to buy. TWS creates a buy ticket at that price.
3. Set the quantity and use a limit price, typically between the bid and the ask.
4. Check the account selector, especially if you have both live and paper sessions open.
5. Click Transmit and watch the order turn from working to filled.

Placing an options spread step by step

A vertical spread is two legs on the same underlying and expiry, sent as a single combo so both legs fill together.

1. In OptionTrader open the Strategy Builder for the underlying.
2. Click the price of the first leg, for example buy the 450 call, then the second leg, sell the 455 call. Each click adds a leg.
3. Review the combo: legs, ratio, expiry and the combined net debit or credit.
4. Enter a limit price for the whole spread rather than for each leg.
5. Create the order, check the account and transmit it as one combo order.

Spreads need the right options level and usually a margin account. Tools that only send single-leg orders, including OptionTrigger, leave spreads to the TWS combo ticket.

Order types for options

Options spreads are wider than stock spreads, so order type matters more.

A market order on an option quoted $0.10 × $0.50 can fill at $0.50 when the fair middle is $0.30, which is two-thirds worse than the mid. Use limits.

Combining TWS with TradingView

Many traders analyze the stock on TradingView and execute in TWS. Done by hand, every trade means translating a level on the stock chart into an option ticket in another window, and exits have to be watched or set as option-price orders.

OptionTrigger is built for that split. You draw the take-profit and stop-loss levels on the TradingView stock chart, pick a call or put, and click Buy explicitly. A local engine connected to TWS or IB Gateway then sells the filled option position when the stock reaches your levels. Read how to trade options on TradingView with IBKR for the full workflow.

• TradingView: charting, levels and analysis on the underlying.
• OptionTrigger: single-leg calls and puts, explicit entry, stock-price exits, health and replay.
• TWS: spreads, account tools and a manual fallback for any open order or position.

Keep TWS available even when another tool trades for you. If anything disconnects, TWS is where you see and manage the real orders.

Common TWS problems and fixes

Option chain shows no data

• Check the OPRA and underlying subscriptions in the Client Portal.
• On a paper account, share the live account’s market data.
• Outside regular trading hours, many option quotes are not updated.

API connection refused

• Enable socket clients in Global Configuration → API → Settings.
• Match the port in your tool to the port in TWS or IB Gateway.
• Wait until TWS has finished loading, then reconnect.
• Give each connected tool its own client ID; two clients with the same ID disconnect each other.

Order rejected: no trading permission

• Confirm options permissions for that market and strategy level.
• Check which account is selected: live or paper, individual or IRA.

Connection drops during the day

• TWS and IB Gateway restart or log off daily and require a fresh login at least weekly. Set the time under Lock and Exit so it falls outside your trading session.
• Do not let the computer sleep while a tool is managing positions.
• Check the IBKR system status page during outages.

Next steps

• IBKR + TradingView for options traders: the full charting-to-execution workflow.
• Connect IBKR TWS or IB Gateway to OptionTrigger.
• Paper trade options from TradingView with DEMO and an IBKR Paper account.
• Download OptionTrigger and practice free.

IBKR menus, permissions and data fees change. Verify current details with Interactive Brokers. Options involve substantial risk of loss.