portfolio_rs/docs/quotes.md
Markus Zoppelt 0cc6ae1e5e fix(quotes): previous close is the last close before today
The previous close was the second-to-last bar of a 7-day chart. quotes()
drops all-null bars, so on a day whose bar was still empty that was the
close from two trading days ago, and the day change and day P&L were
measured against the wrong day.

It is now the newest bar with a positive close dated before today in the
exchange's time zone (the same dating yahoo_daily_bars uses, now shared as
exchange_date). Document how the latest price and previous close are
chosen in docs/quotes.md.
2026-11-01 20:29:21 +01:00

2.4 KiB

Quotes, currencies and returns

Quote sources

Quotes come from Yahoo Finance by default. Set PORTFOLIO_RS_QUOTES to choose another source: offline makes no network calls (nothing gets a price), and fixture:<path> serves prices from a JSON file with the shape of tests/fixtures/quotes_example.json. An invalid value prints a warning and uses offline quotes; it never falls back to the network.

PORTFOLIO_RS_QUOTES=fixture:tests/fixtures/quotes_example.json portfolio_rs context example_data.json

From Yahoo, the latest price is the newest daily bar with a positive close. On thinly traded venues the day's trade often appears only in the chart's regularMarketPrice while today's bar is still empty; that price is used when its regularMarketTime is newer than the bar. The previous close (for the day change) is the newest close dated before today in the exchange's time zone.

The MCP server and HTTP API also keep a last-known-price cache next to the positions file; see MCP server.

Base currency

currency in the config file (default EUR) is the base currency for totals. Quotes in another currency (as reported by Yahoo) are converted with one FX quote per currency, e.g. EURUSD=X; only the ticker symbol is sent. Prices and average cost are shown in the quote currency (e.g. 512.30 USD); values, invested amounts, and totals are in the base currency.

Purchase prices are treated as quote-currency prices and converted at the current FX rate, so cost basis ignores past FX moves (MCP responses flag this as cost_basis_current_fx). If an FX quote, or the quote currency itself, is unknown, the affected positions are flagged, their invested amount is null, and they are excluded from totals rather than mixed in unconverted.

performance returns

performance period returns (1W, 1M, 3M, 6M, YTD, 1Y) are the market return of the ticker positions you hold now, at current quantities, compared like for like: cash, ticker-less holdings, unpriced positions, and positions without a price at the period start are left out of both sides. Deposits, withdrawals, and trades during the period are not accounted for. 1D and "Since" compare total portfolio values (including cash).

For contribution-aware figures from stored snapshots, see get_performance in the MCP server docs.