2. The terminal and your workspace

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? PF answers 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 NVDA asks for them).

  • Broker

    positions sync from your brokerage account (lesson: Account and brokers); you cannot delete them by hand.

Diagram: AP NVDA: shares, cost leads to Portfolio; Broker sync leads to Portfolio; AW NVDA leads to Watchlist; Portfolio leads to PF pane: value, day, P&L, weights; Watchlist leads to PF pane: value, day, P&L, weights; PF pane: value, day, P&L, weights leads to Used by alerts, PORT risk, news, theses.
Wide diagram: scroll sideways to see all of it.

See it in Gloom

Gloom screenshot: A demo portfolio in PF before the US open, captured 2026-11-13 (illustrative positions)
A demo portfolio in PF before the US open, captured 2026-11-13 (illustrative positions).

Open ittype PF. Tabs on top switch between your portfolios and watchlists (h / l).

  1. Header Val 157,954: the total market value, in dollars.
  2. 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).
  3. P&L +57,717 (+57.58%): unrealized profit since purchase. The cost was about 100,200 (157,954 - 57,717).
  4. 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.
  5. DAY and P&L per row: MSFT -750.00 is 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.

Gloom screenshot: PF on a demo book with targets, captured 2026-11-13
PF on a demo book with targets, captured 2026-11-13.
  1. AAPL 41.8% 25.0% +16.8pp -60 -21.5k: over target; selling 60 shares (about 21,500 dollars) brings it back.
  2. XOM 10.6% 20.0% -9.4pp +70: under target by 70 shares.
  3. TOTAL ... 0.00: with targets adding up to 100%, the trades net to zero.

Adding and removing from anywhere

CommandDoes
AW NVDAAdd to the active watchlist
AP NVDAAdd to a manual portfolio, with optional shares, average cost and currency
RW NVDA / RP NVDARemove 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 PRKS

In 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
  1. In the first screenshot, which position moved most in percent? (MSFT, -2.39%.)
  2. Compute the market value of the TSLA row: 35 shares x 399.31. (About 13,976 dollars.)
  3. In the app: AW SPY, then PF, 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 TRADE as orders. It is the arithmetic back to target; nothing is sent.
Check yourself3 questions
  1. What is the difference between a portfolio and a watchlist?
  2. You hold 20 shares bought at 50, now 45. What is your unrealized P&L?
  3. Which command removes NVDA from your watchlist?
Answers
  1. A portfolio holds quantities and costs; a watchlist is just tickers to follow.
  2. 20 x (45 - 50) = -100 dollars, or -10%.
  3. 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.