Portfolios and watchlists (PF, AP, AW, RP, RW)
PF shows what you own (positions, cost, profit and loss) and what you follow (watchlists) with live prices, and AP, AW, RP and RW add or remove tickers from anywhere.
- 5 min
- 3 questions
- Lesson 1 of 8
Why you would care
How are your positions doing today, and since you bought them? What is moving among the names you watch?
PFanswers both, and alerts, risk and news start from these lists.
The idea from scratch
- A portfolio is a list of positions: for each ticker, how many shares you hold and your average cost (what you paid per share, on average).
- A watchlist is a list of tickers you follow, with no quantities.
From a position, three numbers follow:
- Market value = shares x current price.
- Unrealized P&L (profit and loss) = market value - what you paid. "Unrealized" because you have not sold: it is profit on paper.
- Weight = this position's market value / the whole portfolio's market value.
Day change is how much the portfolio moved since yesterday's close. P&L is since you bought. Do not confuse them.
Two ways to fill a portfolio
Manual
you type tickers, shares and costs (
AP NVDAasks for them).Broker
positions sync from your brokerage account (lesson: Account and brokers); you cannot delete them by hand.
See it in Gloom

Open ittype PF. Tabs on top switch between your portfolios and watchlists (h / l).
- Header
Val 157,954: the total market value, in dollars. Day +194.30 (+0.12%) PM vs Thu 12 Nov close: the change since the previous close, here with pre-market prints (PM; after the close,AH).P&L +57,717 (+57.58%): unrealized profit since purchase. The cost was about 100,200 (157,954 - 57,717).- Row
AAPL PM 356.75 +0.53% 150 189.20 53.5k: the price the row is valued at (a pre-market print), its change, shares, average cost and value. DAYandP&Lper row:MSFT -750.00is 60 shares x 12.50 dollars lower.
The + ticker box, or a, adds a ticker to the open list. d removes the selected one after a confirmation (or type RW or RP). s switches to a grid view.
Targets and rebalancing
A target weight is the share of the book you want a position to be. Drift is how far its weight has moved from the target, in percentage points (pp); rebalancing is trading back to the targets. Press t on a row to set its target, Shift+T to clear it; CASH takes one too.

AAPL 41.8% 25.0% +16.8pp -60 -21.5k: over target; selling 60 shares (about 21,500 dollars) brings it back.XOM 10.6% 20.0% -9.4pp +70: under target by 70 shares.TOTAL ... 0.00: with targets adding up to 100%, the trades net to zero.
Adding and removing from anywhere
| Command | Does |
|---|---|
AW NVDA | Add to the active watchlist |
AP NVDA | Add to a manual portfolio, with optional shares, average cost and currency |
RW NVDA / RP NVDA | Remove from the watchlist / portfolio |
From the shell, gloom watchlist add <watchlist> <tickers> adds many at once (--file reads a pasted grid). A ticker that stopped trading is not added on a guess:
$ gloom watchlist add Watchlist RAD SEAS AAPL
Added AAPL:NASDAQ (Apple Inc.)
Needs a choice, not added (2):
RAD stopped trading 2023-10-17, now RADCQ
United Parks & Resorts (SEAS) stopped trading 2024-02-13, now PRKS
Add what they trade as now: gloom watchlist add Watchlist RADCQ PRKSIn the shell, gloom portfolio show Book prints the same book and ends on Day's move: +$194.30 (+0.12%) pre-market vs Thu 12 Nov close.
Practice and recap
Try it3 tasks
- In the first screenshot, which position moved most in percent? (MSFT, -2.39%.)
- Compute the market value of the TSLA row: 35 shares x 399.31. (About 13,976 dollars.)
- In the app:
AW SPY, thenPF, then find the Watchlist tab.
Common mistakes4 mistakes
- Reading total P&L as today's gain. Day and P&L are different numbers.
- Forgetting that unrealized P&L is on paper until you sell.
- Deleting a broker position and waiting for it to vanish. Change it at the broker.
- Reading
TRADEas orders. It is the arithmetic back to target; nothing is sent.
Check yourself3 questions
- What is the difference between a portfolio and a watchlist?
- You hold 20 shares bought at 50, now 45. What is your unrealized P&L?
- Which command removes NVDA from your watchlist?
Answers
- A portfolio holds quantities and costs; a watchlist is just tickers to follow.
- 20 x (45 - 50) = -100 dollars, or -10%.
RW NVDA.
Words in this lesson10 words
- portfolio
- A list of positions with quantities and costs.
- watchlist
- A list of tickers you follow, with no quantities.
- position
- What you hold of one ticker.
- average cost
- What you paid per share, on average.
- market value
- Shares x current price.
- unrealized P&L
- Profit or loss on positions not yet sold.
- weight
- One position's share of the portfolio's value.
- target weight
- The share you want a position to be.
- drift
- A weight minus its target, in percentage points.
- rebalancing
- Trading back to the target weights.
Educational material about reading market data, not investment advice.