Three related tools live under the Settings & Windows (gear icon) → Accounts submenu:
Accounts List (name your accounts, set per-symbol-type fees, link them to the raw IB account
IDs TWS reports), IB Accounts (live Account Summary, Account Updates, Positions, and Family
Codes straight from the IB API), and Financial Advisor (aliases, allocation groups, and
allocation profiles for IB Financial Advisor / managed-account logins).
Accounts List and IB Accounts are available on every edition.Financial Advisor is
Premium-tier (Free Trial, Premium, WhiteLabel, or Developer mode) — see
Financial Advisor below and the
Licensing & Editions guide.
Click the Settings & Windows (gear icon) on the main toolbar.
Go to Accounts — a submenu opens with three items: Accounts List,
Financial Advisor, and IB Accounts.
Each opens its own window. Closing that window (the X, or its own Hide button) just hides it —
your account data and any unsaved list changes are preserved for next time you open it.
Accounts List
This is where SOAP2's own account records live — the account Name you'll see everywhere
else in the app (main toolbar, Trade Log, Orders, allocations), separate from the raw account ID TWS uses
internally.
Grid columns:
Name — the label used throughout SOAP2. Rename freely; a Demo Account
is always available and cannot be removed.
Currency, Type (DEMO / LIVE / TEST).
IB — the raw IB account ID this row is linked to. Hidden by default; click
IB Show/Hide to reveal it and to manually (re)link a row: select the row, pick the
correct raw ID from the dropdown next to that button, then click it again.
Default / Active — only one row can be Default at a time.
Toolbar buttons: New Account, Delete Account, Save List
(writes to disk — do this after any edit), Reset List (reloads from the saved file,
discarding unsaved changes).
Automatic managed-account matching
Every time SOAP2 connects to TWS, it asks TWS which account(s) your login manages and reconciles the
answer into the Accounts List automatically — you don't need to link anything by hand for the common case:
Single account: if you already have a LIVE row with no IB link yet, that raw ID is
attached to it. Otherwise a new row is created automatically, named after the raw ID (rename it
whenever you like).
Multiple accounts (Financial Advisor / managed-account logins): each account TWS
reports gets matched to its own row the same way — an existing empty LIVE row if one is available, or
a freshly auto-created row otherwise. No two accounts are ever collapsed onto the same row.
This is additive only — reconciliation never removes or unlinks an existing row, even
if TWS momentarily fails to report an account on a given connect.
See Limitations for the one edge case where the automatic matching can pair the
wrong pre-existing row with the wrong account, and how to fix it by hand.
IB Accounts
A live view straight from the IB API, with four tabs:
Account Summary — key metrics (Net Liquidation, Buying Power, margin figures, etc.)
for every account TWS reports, one row per tag per account. Populates automatically on connect; the
Request button toggles it on/off manually if needed.
Account Updates — live portfolio positions and account values for a single account at
a time. This automatically follows whichever account is currently selected in the main
toolbar's account dropdown — switching accounts there switches what's shown here, with no
extra steps. The Subscribe/Unsubscribe button lets you detach it manually if you don't want live
updates streaming.
Positions (all accounts) — every open position across every account TWS reports, in
one grid.
Family Codes — Request/Clear buttons for IB's family/group code data (relevant mainly
to Financial Advisor account structures).
Financial Advisor (Premium)
Free Trial, Premium, WhiteLabel, or Developer mode only. On Freeware/Regular, the
Financial Advisor menu item is visible but disabled, with a tooltip explaining why — see
Licensing & Editions to upgrade.
This is only useful if you actually manage multiple accounts through an IB Financial Advisor login — it
reads and writes the same underlying configuration as TWS's own Configure → Advisor Setup
panel, so changes made in either place are visible in the other.
Aliases — account aliases configured in TWS. Click Load to fetch the
current list. Read-only from SOAP2 (edit aliases in TWS itself).
Groups — allocation groups (name, default allocation method, member accounts).
Load fetches from TWS; Save pushes your edits back.
Profiles — allocation profiles (name, type, allocation breakdown).
Load / Save work the same way as Groups.
Save is a real write back to TWS's FA configuration — double-check an edit before saving
it, the same way you would in TWS itself.
Availability
Tool
Editions
Accounts List
All editions
IB Accounts
All editions
Financial Advisor
Free Trial, Premium, WhiteLabel, Developer mode
All three require an active IB connection to fetch or push live data; Accounts List itself can still be
viewed and edited offline.
Limitations
Automatic matching can mis-pair in one edge case: if you already had two or more
empty, unlinked LIVE rows in Accounts List before connecting, and TWS reports two or more new
accounts at once, they're matched in list order — which might not be the pairing you intended. Fix it
by hand with IB Show/Hide in Accounts List (see above); this doesn't affect the common
case of zero or one pre-existing unlinked row.
Positions and Family Codes grids don't prune stale rows — a position that's since
closed to zero, or a family code that's no longer current, stays in the grid until you clear it or
re-request.
Financial Advisor and multi-account reconciliation are new — they haven't yet been exercised against a
real multi-account TWS session by the developer. If something looks off, please report it via
Send Feedback under the SOAP menu.
