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.
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.