Your account and your broker (ACM, BR, IBKR)
ACM manages your Gloom account, and BR connects a brokerage account so your real positions appear in a portfolio and stay in sync.
- 5 min
- 3 questions
- Lesson 7 of 8
Why you would care
How do you get your real holdings into Gloom, safely? Typing 30 positions by hand is slow and goes stale the day you trade. Connecting your broker keeps the portfolio true on its own. And knowing what a connection can and cannot do (read your positions, or also trade) is basic hygiene.
The idea from scratch
Your Gloom account
A Gloom account (also called Gloom Cloud) is free. It syncs your layouts, lists, notes and alerts across devices and unlocks chat and phone alerts. You sign in with an email and a password, or by scanning a QR code with the Gloom mobile app (the command Log In with QR Code).
ACM opens its settings, in tabs: profile (and whether it is public), emails, your Pro plan, your teams, your password. Ctrl+S saves. UPGRADE opens the Pro checkout.
Brokers
A broker holds your real account and executes your trades (chapter 01, Orders, long, short and margin). A broker connection lets Gloom read that account.
- Read-only connections import your accounts and positions. They cannot place orders.
- Positions sync into a broker portfolio. A later sync updates it and removes positions the broker no longer reports. That is why you cannot delete a broker position by hand in
PF. - Tokens and keys you enter in the app are saved on your device only, never synced to your Gloom account. SnapTrade's browser sign-in is kept with your Gloom account instead.
SnapTrade is built in and connects the brokerages it supports. Link them in your free SnapTrade account first, then in BR add SnapTrade and sign in with SnapTrade. Every other broker is a plugin you install first. The app's documentation lists:
| Broker | How it connects |
|---|---|
| Interactive Brokers | Browser sign-in, or a statement token (Flex); a separate Gateway plugin adds live data and a trading console |
| Public | An API secret from that broker's settings; read-only |
| Robinhood | A browser sign-in; read-only account and stock positions |
| SimpleFIN | A one-time setup token; imports accounts that hold investments, read-only |
| SnapTrade | A browser sign-in to SnapTrade; reads the accounts, balances, positions and orders of the brokerages you linked there, and can place stock and ETF orders where the brokerage allows |
See it in Gloom

Open ittype BR.
PROFILE: the name you give a connection (you can have several).STATUS: connected or not, or what is missing.BROKERandMODE: which broker, and how it connects (for example a statement token or a live gateway).ACCOUNTSandSYNCED: how many accounts were found, and when they were last read.No broker profiles.: nothing connected yet. Pressato add one.
Keys: a add, c connect, s sync, e edit.
An Interactive Brokers browser sign-in ends after seven days; STATUS shows when, and c starts seven more.
A broker Gloom does not sync: import its file
Many brokers and retirement-plan sites (Fidelity, Schwab, Vanguard, E*TRADE, Merrill, 401(k) sites) have no connection, but their positions page downloads as a CSV file. In PF, open the pane menu (.) and choose Import Positions…; the terminal asks for the file's path. A preview lists what will be added, and each row left out with its reason, before anything is saved. In a shell, --dry-run prints the same preview (illustrative file):
$ gloom portfolio import positions.csv --dry-run (trimmed)
Would create portfolio "Fidelity" with 3 positions from the Fidelity ... export.
Ticker Name Shares Avg Cost Status
AAPL:NASDAQ Apple Inc. 20 $180.00 new
MSFT:NASDAQ Microsoft Corporation 10 $350.00 new
SPY:ARCA State Street SPDR S&P 500 ETF Trust 8 $550.00 new
Skipped 2 rows:
Line Row Reason
2 SPAXX** cash or money market
6 -AAPL261218C300 option
Dry run: nothing saved.Each symbol becomes a position with its shares, its average cost and, when the file has one, its purchase date. Cash sweeps, options, bonds and pending activity are skipped. The result is an ordinary manual portfolio, not a connection: it does not change when you trade. Download a new file and import it again with --merge (update that portfolio) or --replace (make it hold only the file's positions).
IBKR: the trading console
With the Interactive Brokers Gateway plugin installed and a gateway running on your computer, IBKR opens a trading console for that account. This Academy does not teach order entry: follow the plugin's own instructions, and remember that the research panes in these lessons only read data.
Practice and recap
Try it3 tasks
- Which connections in the table are read-only? (Public, Robinhood, SimpleFIN; Interactive Brokers Flex reads statements.)
- You sold a stock at your broker. What happens to it in your broker portfolio? (The next sync removes it.)
- Where are the tokens you enter in the app stored? (On your device only. SnapTrade's browser sign-in stays with your Gloom account.)
Common mistakes5 mistakes
- Deleting a broker position in
PFand expecting it to stay gone. - Expecting broker credentials to follow you to a new computer. Connect again there.
- Assuming Gloom can trade on every connection. Read-only connections never send orders.
- Mixing manual and broker portfolios and double-counting a position.
- Treating an imported file as a connection. It is a snapshot: import again after you trade.
Check yourself3 questions
- What does a read-only connection let Gloom do?
- Why is a broker position not deletable in
PF? - Which command opens your account settings?
Answers
- Read your accounts and positions, not place orders.
- Because the next sync would bring it back: the broker is the source of truth.
ACM.
Words in this lesson6 words
- Gloom account (Gloom Cloud)
- Your free account: sync, chat, phone alerts.
- broker connection
- A link that lets Gloom read your brokerage account.
- read-only
- Can read data but cannot change anything or trade.
- broker portfolio
- A portfolio filled and updated by a broker sync.
- sync
- Reading the broker again and updating the portfolio.
- token
- A secret code that lets an app access an account; keep it private.
Educational material about reading market data, not investment advice.