TWS virtual FX positions versus actual cash balances

Quick answer

A virtual FX position is a tracking view. It may not be your cash balance in that currency. TWS can include this view in API portfolio updates. Check which field the app uses before you treat a line on screen as cash you hold or a trade you must close.

Educational software guidance. Trading involves risk. Read the financial and information disclaimers.

Step by step

1 Locate the currency values in TWS and note whether they are cash balances or virtual FX positions.
2 Open API → Settings and check Include virtual FX positions when sending portfolio.
3 Compare the external app’s field names and documentation with that setting.
4 Use actual account balances when checking currency holdings.
5 Ask support to clarify a field before treating a virtual position as an instruction to trade.

A practical example

You changed cash from one currency to another and later see a pair in the virtual FX view. Do not assume that line is a second cash balance that must be closed. Read the actual currency balances in the account view. The virtual view tracks a different idea. If an app shows both, ask which field it uses for its decisions. Hiding a tracking line does not sell currency, and a currency trade should not be used just to tidy a display you do not yet understand.

Illustrative scenario, not a record of a trade placed during this review.

Screen reference

Start in Mosaic with File → Global Configuration. Then choose the panel named in the steps.

TWS API Settings showing socket clients, read-only access, port and logging — Find the named control in API → Settings. The displayed values belong to a paper session and are examples, not universal recommendations. Captured in TWS paper mode on 3 October 2026. Open the image for full size.

Market Value - Real FX Balance heading with cash and P&L column labels — This capture shows only the section heading and column labels. Actual currency balances and account totals are excluded. Captured in TWS paper mode on 3 October 2026. Open the image for full size.

How to confirm the result You should know whether each displayed currency value is a cash balance or a tracking position.

Mistake to avoid

Do not place a currency trade merely to make a virtual display match a cash balance.

Common questions

Can changing the API display option convert currency?

No. It affects reported details, not a currency execution.

Why does another app show an extra FX line?

Check whether it includes virtual FX portfolio entries.

Find an instrument’s full contract details in TWS Wrong stock listing in TWS: check primary exchange TradingView and TWS show different futures expiries IBKR order quantity differs from the TradingView alert

Financial and information disclaimers

Financial disclaimer

These guides explain software. They are for education, not financial, investment, tax, or legal advice. No example is a suggestion to buy or sell a product or use a trading strategy. Trading can lose money, including all funds you put at risk. With margin, futures, short sales, or some options, losses can exceed your starting funds. Automation can fail, send duplicate orders, or act late. Stops do not guarantee a fill or a price. Review your orders and positions, and seek advice from a qualified professional for your own needs. Paper trades, examples, and past results do not predict live results or promise a profit.

Information disclaimer

This is general help based on the sources and check date shown on the page. Screens, settings, fees, data access, and product support can change or differ by app version, account, country, and broker. The content may contain errors or become out of date; accuracy, completeness, and continuous service are not guaranteed. Check current broker and app instructions before acting. Screenshots show where controls are; they do not prove that an order test passed. This guide does not replace broker terms or risk notices. References to IBKR and TradingView identify their products and do not imply their endorsement of this guide.