[MONSA]

// interactive brokers

Your positions, without typing them twice.

Connect an IBKR account and Monsa reads what you hold, compares it to your book and shows you the difference. You decide what to accept. It reads statements and cannot place an order.

What it will never do

  • It cannot trade. The Flex Web Service serves statements and nothing else - there is no endpoint on it that places an order, moves cash or changes an account. That is why Monsa uses it instead of IBKR's full API: the credential you hand over cannot do anything to your account even in the worst case.
  • It writes nothing on its own. Every statement produces a proposal you look at and tick. Monsa never edits your book on a schedule, because a holding missing from one broker's statement has two meanings - you sold it, or you hold it somewhere else - and only you know which.
  • It leaves your own entries alone. Monsa only ever changes the holdings it created. Anything you typed in yourself is flagged for you to decide about and never overwritten, because it cannot tell which lot moved and guessing would delete a second account.

Setting it up

Five steps, all of them on IBKR's side except the last. Ten minutes, once.

  1. 01 Build a Flex Query In IBKR Client Portal, open Performance & Reports → Flex Queries and create an Activity Flex Query. Give it a name you will recognise.
  2. 02 Tick Open Positions In the sections list, enable Open Positions. This is the one section Monsa reads, and a query without it produces a statement that parses cleanly and contains nothing - which would look exactly like an account holding nothing at all. Monsa refuses that rather than guessing.
  3. 03 Set the format Format XML, period Last Business Day (or Today), and leave the date format alone. Save the query and note the Query ID beside it - a short number.
  4. 04 Generate a token Still under Performance & Reports, open Flex Web Service Configuration and generate a token. It is shown once and expires after a year, so put it somewhere you can find it again.
  5. 05 Paste both into Monsa Settings → Import holdings from Interactive Brokers. Then press Fetch statement and read what it proposes.

What the preview shows you

Every holding, including the ones that already agree. A row missing from a list of changes reads as a row about to be removed, and the question this screen exists to answer is whether Monsa understood your book. Each row says what it would do and why, and the ones it will not decide say that too:

new
IBKR has it, Monsa does not. It will be tracked and the lot added, unassigned.
changed
Both have it, the share count moved.
same
Nothing to do. Listed so the page accounts for everything.
not in statement
Monsa has it and this statement does not mention it. Proposed for removal, never automatic.
yours to decide
You entered this holding by hand. Monsa will not touch it.
needs a match
Two listings fit and Monsa will not pick. ASML in Amsterdam and its American depositary receipt are different securities with different prices.
not scored
An option, a future or a cash balance. Monsa scores companies against rules; these are not companies.

After the first import

Monsa reads the statement again each night and prepares a proposal without being asked. You get an e-mail only when something differs - a message every night saying your book still matches is a message that ends up in a folder, and then the one night it matters is in there too. Nothing is applied until you open Settings and accept it.

Imported holdings land unassigned. Which portfolio a holding belongs to is a judgement about your own strategy, and it is the one thing a brokerage statement contains no information about.

Open Settings and connect →

Typing a portfolio in by hand is the step people do once and then never again after a rebalance. This is that step, done by the broker that already knows.

Monsa is a portfolio analysis tool, not a broker or an investment adviser. It is not affiliated with Interactive Brokers. Nothing here is investment advice. See privacy for what leaves the product and where it goes.