gloomberb 0.18.1 → 0.18.2

package/src/cli/commands/news-search.ts

@@ -2,6 +2,9 @@ import { apiClient } from "../../api-client";
 import type { NewsArticle } from "../../news/types";
 import { mapCloudNewsArticle } from "../../sources/gloomberb-cloud/news";
 import { cliStyles } from "../../utils/cli-output";
+import { logFailure } from "../../utils/log-failure";
+import { commodityNamedIn, commoditySearchName, isCommodityName } from "../../market-data/commodity-names";
+import type { FuturesContract } from "../../market-data/futures-board";
 
 /** What the service accepts of a search: two characters to two hundred, with a letter or a number in them. */
 const MIN_TEXT_LENGTH = 2;
@@ -60,8 +63,8 @@ export function newsSearchTextProblem(text: string): string | null {
 
 /**
  * The word a symbol lookup found no stories for, as text to search stories for.
- * Null under three characters, where the fuzzy match finds names that merely
- * contain it (ZN, Telomir-Zn) and the lookup's own answer is the better one.
+ * Null under three characters, where the word is mostly a piece of other
+ * names (ZN in Telomir-Zn) and the lookup's own answer is the better one.
  */
 export function newsFallbackText(symbol: string): string | null {
   const text = symbol.trim().replace(/^\$/, "");
@@ -69,15 +72,39 @@ export function newsFallbackText(symbol: string): string | null {
 }
 
 /**
- * The stories matching the text, newest first. The service answers best match
- * first and holds stories back from an account without real-time access, as
- * every other news request.
+ * The stories matching the text, in the service's order: stories with every
+ * word in the headline first, then the ones with some only in the summary,
+ * newest first within each. The service holds stories back from an account
+ * without real-time access, as every other news request.
  */
 export async function searchNewsStories(text: string, limit: number): Promise<NewsArticle[]> {
   const response = await apiClient.searchCloudNews(text, limit);
-  return response.items
-    .map((item) => mapCloudNewsArticle(item))
-    .sort((a, b) => b.publishedAt.getTime() - a.publishedAt.getTime());
+  return response.items.map((item) => mapCloudNewsArticle(item));
+}
+
+/** The futures news route a search offers when no story matches it: `gloomberb news KC=F` for "arabica". */
+export interface CommodityNewsRoute {
+  contract: FuturesContract;
+  command: string;
+}
+
+/**
+ * The future of the commodity a search names, offered when no story matched:
+ * `news KC=F` searches the stories of coffee, so it is offered only when
+ * those are not what just found nothing and they have a story to show.
+ */
+export async function commodityNewsRoute(text: string): Promise<CommodityNewsRoute | null> {
+  const contract = commodityNamedIn(text);
+  const name = contract ? commoditySearchName(contract) : null;
+  if (!contract || !name || isCommodityName(text, name)) return null;
+  const stories = await searchNewsStories(name, 1).catch(logFailure("cli.news-search", "Search a commodity's stories failed", []));
+  return stories.length > 0 ? { contract, command: `gloomberb news ${contract.symbol}` } : null;
+}
+
+/** What a search that matched no story says: never a near miss, and the commodity's futures news where it has some. */
+export function noStoriesMessage(text: string, route: CommodityNewsRoute | null): string {
+  const none = `No stories match "${text}".`;
+  return route ? `${none} For the ${route.contract.name} future, try: ${route.command}` : none;
 }
 
 /** The line above the stories: "Stories matching "european gas"", with why a word typed as a symbol is searched. */

package/src/cli/commands/system.ts

@@ -5,6 +5,7 @@ import { saveConfig } from "../../data/config/store";
 import { builtinPluginGroupMembers } from "../../plugins/ownership";
 import type { AppConfig, TelemetryConfig } from "../../types/config";
 import { canonicalTimeZone } from "../../utils/utc-time";
+import { readBaseCurrency } from "../../utils/base-currency";
 import { NIGHTLY_CHANNEL_SUMMARY, parseUpdateChannel, withUpdateChannel } from "../../updater/channel";
 import type { CliCommandDef } from "../../types/plugin";
 import { resolveCliDataDir, withCliServices, withConfigData } from "../context";
@@ -65,6 +66,32 @@ function parseTimezoneSetting(value: string): string | null {
   );
 }
 
+/**
+ * The code `config set baseCurrency` stores (`cad` is CAD); fails on a name
+ * or sign, naming the code it stands for, and on anything that is no code.
+ */
+function parseBaseCurrencySetting(value: string): string {
+  const reading = readBaseCurrency(value);
+  if ("code" in reading) return reading.code;
+  const [first] = reading.suggestions;
+  return fail(reading.error, first
+    ? `baseCurrency takes an ISO 4217 code: gloomberb config set baseCurrency ${first}`
+    : "baseCurrency takes an ISO 4217 code such as USD, EUR or CAD.");
+}
+
+/** A saved base currency that is no code (an older version stored names), with what to set instead; null for a code. */
+function baseCurrencyProblem(value: unknown): string | null {
+  const reading = readBaseCurrency(typeof value === "string" ? value : "");
+  if ("code" in reading) return null;
+  const [first] = reading.suggestions;
+  return `${reading.error} Set one: gloomberb config set baseCurrency ${first ?? "<code>"}`;
+}
+
+function describeBaseCurrency(value: unknown): string {
+  const problem = baseCurrencyProblem(value);
+  return problem ? `${String(value)} ${cliStyles.warning(`(${problem})`)}` : String(value);
+}
+
 function describeTimezone(value: unknown): string {
   return typeof value === "string" && value ? value : "not set, times print in UTC alone";
 }
@@ -189,6 +216,9 @@ export function createSystemCliCommands(): CliCommandDef[] {
           checks.push({ check: "database", status: "ok", detail: join(services.dataDir, ".gloomberb-cache.db") });
           checks.push({ check: "plugins", status: "ok", detail: String(services.services.pluginRegistry.allPlugins.size) });
           checks.push({ check: "capabilities", status: "ok", detail: String(services.services.pluginRegistry.capabilities.manifests().length) });
+          // Only a saved value no conversion can price is worth a line.
+          const baseCurrencyIssue = baseCurrencyProblem(services.config.baseCurrency);
+          if (baseCurrencyIssue) checks.push({ check: "baseCurrency", status: "warn", detail: baseCurrencyIssue });
           const theme = services.config.theme;
           checks.push({
             check: "theme",
@@ -311,6 +341,7 @@ export function createSystemCliCommands(): CliCommandDef[] {
               ...(key === KEYBINDINGS_CONFIG_KEY ? { format: summarizeKeybindings } : {}),
               ...(key === "theme" ? { format: (value: unknown) => describeThemeId(String(value)) } : {}),
               ...(key === TIMEZONE_CONFIG_KEY ? { format: describeTimezone } : {}),
+              ...(key === "baseCurrency" ? { format: describeBaseCurrency } : {}),
             })),
           });
           return;
@@ -329,7 +360,8 @@ export function createSystemCliCommands(): CliCommandDef[] {
           }
           ctx.printResult({ data: { key, value: safeConfig[key] } }, {
             text: (data) => key === KEYBINDINGS_CONFIG_KEY ? renderKeybindings(data.value)
-              : key === TIMEZONE_CONFIG_KEY ? describeTimezone(data.value) : describeConfigValue(data.value),
+              : key === TIMEZONE_CONFIG_KEY ? describeTimezone(data.value)
+                : key === "baseCurrency" ? describeBaseCurrency(data.value) : describeConfigValue(data.value),
           });
           return;
         }
@@ -367,6 +399,8 @@ export function createSystemCliCommands(): CliCommandDef[] {
           // A display name may come unquoted: config set theme White Phosphor.
           const parsedValue = key === "theme"
             ? requireThemeId(args.slice(2).join(" "))
+            : key === "baseCurrency"
+              ? parseBaseCurrencySetting(args.slice(2).join(" "))
             : key === TIMEZONE_CONFIG_KEY
               ? parseTimezoneSetting(value)
               : key === UPDATE_CHANNEL_CONFIG_KEY

package/src/cli/commands/ticker.ts

@@ -8,11 +8,12 @@ import { describeFundamentalMarketCap, marketCapShareBasisNote, selectMarketCapi
 import {
   formatCompact,
   formatCurrency,
+  formatCurrencyCode,
   formatNumber,
   formatPercent,
   formatPercentRaw,
 } from "../../utils/format";
-import { formatMarketCostWithCurrency, formatMarketPriceWithCurrency, formatMarketQuantity, formatMarketChangeWithCurrency, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../market-data/market/format";
+import { formatMarketCostWithCurrency, formatMarketPriceWithCurrency, formatMarketQuantity, quoteFormatOptions, withCurrencyMinorDigits, type MarketFormatOptions } from "../../market-data/market/format";
 import {
   cliStyles,
   cliTerminalWidth,
@@ -28,14 +29,16 @@ import {
   getExtendedSessionDisplay,
   getQuoteSessionFields,
   getRegularSessionDisplay,
+  quoteBookSessionLabel,
   quoteHeadlineTime,
   quoteMarketStateLabel,
 } from "../../market-data/market/status";
 import type { FuturesContractTermsPayload } from "../../api-client/futures-curve";
-import { futuresContractLines, futuresSettleText, isFuturesInstrument, loadFuturesContractTerms } from "../../market-data/futures-contract";
+import { changeBasisJson, quoteChangeBasis, quotePreviousCloseDate } from "../../market-data/market/change-basis";
+import { futuresContractLines, futuresSettleText, isFuturesInstrument, loadFuturesContractTerms, minorUnitPricePer } from "../../market-data/futures-contract";
+import { currencyCodeLabel } from "../../utils/currency-units";
 import type { AppConfig } from "../../types/config";
 import type { DeclaredDividendAction, FinancialStatement, Quote, TickerFinancials } from "../../types/financials";
-import { quoteTradingDay } from "../../market-data/quotes/day-range";
 import { atRegularSessionPrice, regularSessionValuationPrice } from "../../market-data/quotes/regular-session-valuation";
 import { computeTickerPriceReturns } from "../../market-data/ticker-price-returns";
 import { instrumentTypeLabel, resolveTickerInstrumentKind } from "../../tickers/instrument-kind";
@@ -46,7 +49,8 @@ import type { TickerRecord } from "../../types/ticker";
 import type { CliCommandContext } from "../../types/plugin";
 import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, lotCostFxRate, resolvePortfolioMarketValue, resolvePortfolioPositionPnl } from "../../portfolio/position-metrics";
 import { isFuturesTicker } from "../../portfolio/futures-positions";
-import { createBaseConverter } from "../base-converter";
+import { createBaseConverter, type BaseConversion } from "../base-converter";
+import { formatFxRate } from "../fx-pair";
 import { initMarketData, withMarketData } from "../context";
 import { fail } from "../errors";
 import type { MarketContext } from "../types";
@@ -58,6 +62,7 @@ import {
   formatSignedCurrency,
   formatTimestamp,
   formatWatchlistNames,
+  quoteChangeText,
 } from "../helpers";
 import { NotesFiles } from "../../plugins/builtin/notes/files";
 import { isKnownNonUsListing, secFilingItemCodes } from "../../utils/sec";
@@ -106,10 +111,6 @@ async function loadRecentSecFilings(
 // Prose such as a company description stays readable on wide terminals.
 const MAX_PROSE_WIDTH = 100;
 const METADATA_SEPARATOR = "  ·  ";
-const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
-const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
-/** The states the header reads as CLOSED: the venue is between sessions, so nobody is quoting. */
-const CLOSED_MARKET_STATES = new Set<string>(["CLOSED", "PREPRE", "POSTPOST"]);
 
 interface TickerCommandDependencies {
   /** `--exchange`: the listing, for a symbol that trades in several places. */
@@ -149,25 +150,22 @@ function appendMetricSection(lines: string[], title: string, metrics: Array<[str
 }
 
 /**
- * A closed market's bid and ask are the last quote of its session, not an open book (ITA's $202.00 against
- * $208.74 around a $206.65 close): say so, with the day the quote is from.
+ * Out of the regular session the bid and ask say whose book they are: the pre-market or after-hours book beside
+ * Last and the extended print, or a closed market's last quote with its day (ITA's $202.00 against $208.74
+ * around a $206.65 close is no open book).
  */
 function bidAskText(quote: Quote, options: MarketFormatOptions): string {
   const text = formatBidAsk(quote.bid, quote.ask, quote.bidSize, quote.askSize, quote.currency, options);
-  if (text === "—" || !quote.marketState || !CLOSED_MARKET_STATES.has(quote.marketState)) return text;
-  const day = quoteTradingDay(quote);
-  const date = day ? new Date(`${day}T00:00:00Z`) : null;
-  const label = date && Number.isFinite(date.getTime())
-    ? `, ${WEEKDAYS[date.getUTCDay()]} ${date.getUTCDate()} ${MONTHS[date.getUTCMonth()]}` : "";
-  return `${text}  ${cliStyles.muted(`(last quote${label})`)}`;
+  const label = text === "—" ? null : quoteBookSessionLabel(quote);
+  return label ? `${text}  ${cliStyles.muted(`(${label})`)}` : text;
 }
 
 function wrapProse(text: string): string {
   return wrapText(text, Math.min(cliTerminalWidth() ?? MAX_PROSE_WIDTH, MAX_PROSE_WIDTH)).join("\n");
 }
 
-function buildStatementMetrics(statement: FinancialStatement, currency?: string): Array<[string, string]> {
-  const money = (value: number | undefined, perShare = false) => formatReportedMoney(value, currency, perShare);
+function buildStatementMetrics(statement: FinancialStatement, currency?: string, codes = false): Array<[string, string]> {
+  const money = (value: number | undefined, perShare = false) => formatReportedMoney(value, currency, perShare, codes);
   return [
     ["Revenue", money(statement.totalRevenue)],
     ["Gross Profit", money(statement.grossProfit)],
@@ -303,8 +301,11 @@ function shouldFetchSecFilings(
 }
 
 async function appendTickerPositions(lines: string[], tickerFile: TickerRecord | null, quote: TickerFinancials["quote"],
-  config: AppConfig, toBase: (value: number, currency: string) => Promise<number>): Promise<void> {
+  config: AppConfig, toBase: ReportBaseConverter): Promise<void> {
   const quoteCurrency = quote?.currency?.trim() || tickerFile?.metadata.currency?.trim() || "";
+  const codes = writesCurrencyCodes(config);
+  const money = codes ? formatCurrencyCode : formatCurrency;
+  const converted = new Set<string>();
   if (tickerFile && tickerFile.metadata.positions.length > 0) {
     lines.push("");
     lines.push(renderSection("Positions"));
@@ -319,6 +320,8 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
       const currentPrice = getPortfolioQuoteDisplay(metrics, quote)?.price ?? null;
       const currentPriceBase = currentPrice != null && quoteCurrency ? await toBase(currentPrice, quoteCurrency) : null;
       const positionRate = positionCurrency ? await toBase(1, positionCurrency) : Number.NaN;
+      if (positionCurrency) converted.add(positionCurrency.toUpperCase());
+      if (quoteCurrency && currentPrice != null) converted.add(quoteCurrency.toUpperCase());
       const baseMetrics = getPortfolioPositionMetrics({ ...tickerFile, metadata: { ...tickerFile.metadata, positions: [position] } }, undefined, quoteCurrency,
         { currency: config.baseCurrency, convert: value => value * positionRate }, quote);
       // A cost bought at an entered rate into the base currency converts at it, as its P&L does; any other at today's.
@@ -334,26 +337,51 @@ async function appendTickerPositions(lines: string[], tickerFile: TickerRecord |
       const stats: CliStatEntry[] = [
         [
           "Position",
-          `${formatMarketQuantity(metrics.totalShares, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, quantityCurrency: positionCurrency })} ${metrics.priceBasis === "percent-of-par" ? "@" : `${tickerFile.metadata.assetCategory === "BOND" ? "units" : contracts ? "contracts" : "shares"} @`} ${positionCurrency ? formatMarketCostWithCurrency(position.avgCost, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis }) : "—"}`,
+          `${formatMarketQuantity(metrics.totalShares, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, quantityCurrency: positionCurrency })} ${metrics.priceBasis === "percent-of-par" ? "@" : `${tickerFile.metadata.assetCategory === "BOND" ? "units" : contracts ? "contracts" : "shares"} @`} ${positionCurrency ? formatMarketCostWithCurrency(position.avgCost, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, currencyCode: codes }) : "—"}`,
         ],
-        ["Cost Basis", formatCurrency(costBasisBase, config.baseCurrency)],
-        ["Market Value", formatCurrency(marketValueBase, config.baseCurrency)],
+        ["Cost Basis", money(costBasisBase, config.baseCurrency)],
+        ["Market Value", money(marketValueBase, config.baseCurrency)],
         [
           selectedPnl.basis === "broker-snapshot" ? "Broker P&L" : "P&L",
-          pnl === null ? "—" : colorBySign(formatSignedCurrency(pnl, config.baseCurrency), pnl),
+          pnl === null ? "—" : colorBySign(formatSignedCurrency(pnl, config.baseCurrency, codes), pnl),
         ],
       ];
       if (position.markPrice != null) {
-        stats.push(["Broker Mark", positionCurrency ? formatMarketPriceWithCurrency(position.markPrice, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis }) : "—"]);
+        stats.push(["Broker Mark", positionCurrency ? formatMarketPriceWithCurrency(position.markPrice, positionCurrency, { assetCategory: tickerFile.metadata.assetCategory, multiplier: position.multiplier, priceBasis: metrics.priceBasis, currencyCode: codes }) : "—"]);
       }
       lines.push(renderStats(stats));
       if (index < positions.length - 1) {
         lines.push("");
       }
     }
+    for (const note of conversionNotes(toBase, converted)) lines.push(cliStyles.muted(note));
   }
 }
 
+/** The ticker report's converter: what `createBaseConverter` makes, whose rates a report states; a plain function in tests. */
+type ReportBaseConverter = ((value: number, fromCurrency: string) => Promise<number>) & { conversions?(): BaseConversion[] };
+
+/**
+ * A base currency other than USD reads every amount with its code (259.36
+ * USD, 878.15B CAD): $ alone is also the Canadian, Australian and other
+ * dollars. A USD base keeps the signs it always had.
+ */
+export function writesCurrencyCodes(config: Pick<AppConfig, "baseCurrency"> | undefined): boolean {
+  const base = config?.baseCurrency?.trim().toUpperCase();
+  return !!base && base !== "USD";
+}
+
+/**
+ * "CAD at USD/CAD 1.40623, as of 2026-10-21 04:46 UTC.": the rate and its
+ * date for each currency in `currencies` the report converted into the base
+ * currency, so a converted figure is never without what it was converted at.
+ */
+function conversionNotes(toBase: ReportBaseConverter, currencies: ReadonlySet<string>): string[] {
+  return (toBase.conversions?.() ?? [])
+    .filter((conversion) => currencies.has(conversion.currency) && conversion.currency !== conversion.baseCurrency)
+    .map(({ currency, baseCurrency, rate, asOf }) => `${baseCurrency} figures at ${currency}/${baseCurrency} ${formatFxRate(rate)}${asOf != null ? `, as of ${formatTimestamp(asOf)}` : ""}.`);
+}
+
 /** A source's enterprise value is in the units of the capitalization it reports beside it,
  * which without a declared unit is the listing's quote currency (as the overview labels it). */
 function enterpriseValueCurrency(
@@ -378,9 +406,9 @@ interface FundamentalsMetric {
 
 type MetricFigure = Omit<FundamentalsMetric, "label">;
 
-/** An amount in the currency the source reported it in; `ccy?` when it named none, as the text says. */
-function reportedMoney(value: number | undefined, currency: string | undefined, perShare = false): MetricFigure {
-  return { text: formatReportedMoney(value, currency, perShare), value, unit: currency?.trim() || "ccy?" };
+/** An amount in the currency the source reported it in; `ccy?` when it named none, as the text says. `codes`: per share too (6.54 USD). */
+function reportedMoney(value: number | undefined, currency: string | undefined, perShare = false, codes = false): MetricFigure {
+  return { text: formatReportedMoney(value, currency, perShare, codes), value, unit: currency?.trim() || "ccy?" };
 }
 
 /** The EV line: labelled "(provider)" when it is more than 5% from market cap + debt - cash, "unavailable" when withdrawn. */
@@ -570,6 +598,7 @@ function fundamentalsMetrics(
   enterpriseValue = reportedMoney(reportedEnterpriseValue(fundamentals), enterpriseValueCurrency(quote, fundamentals)),
   distributions: DividendDistributions | null = null,
   bond: FundBondFacts | null = null,
+  codes = false,
 ): FundamentalsMetric[] {
   const signed = (value: number) => colorBySign(formatPercent(value), value);
   const receipt = fundamentals?.sharesOutstanding != null && sharesOutstandingInReceipts(quote, fundamentals, profile?.description);
@@ -581,7 +610,7 @@ function fundamentalsMetrics(
     { label: "Forward P/E", ...multipleFigure(priceEarningsOnEarnings(fundamentals?.forwardPE, fundamentals?.forwardEps)) },
     { label: "PEG", ...multipleFigure(fundamentals?.pegRatio) },
     // The flows and EPS are one trailing-twelve-month block, the same twelve months for each line.
-    { label: "EPS (TTM)", ...reportedMoney(fundamentals?.eps, fundamentals?.epsCurrency?.trim() || reportingCurrency, true) },
+    { label: "EPS (TTM)", ...reportedMoney(fundamentals?.eps, fundamentals?.epsCurrency?.trim() || reportingCurrency, true, codes) },
     {
       label: dividendYieldLabel(fundamentals?.dividendYieldBasis, bond),
       ...forwardYieldFigure(fundamentals, distributions),
@@ -684,6 +713,8 @@ type FundamentalsReportData = TickerFinancials & {
   bank?: BankFiguresPayload | null;
   /** In place of `bank`, for a bank whose figures could not be read. */
   bankNote?: string | null;
+  /** A base currency other than USD: every amount reads with its code (`writesCurrencyCodes`). */
+  currencyCodes?: boolean;
 };
 
 /** "Latest quarter 2026-06-30, 10-Q filed 2026-08-06." and the newer quarter's results release, for the lines under a report's figures. */
@@ -723,7 +754,10 @@ function valuationPriceMetrics(financials: FundamentalsReportData): Fundamentals
   const quote = financials.quote;
   const session = getRegularSessionDisplay(quote);
   if (!quote || !session) return [];
-  const options = withCurrencyMinorDigits(quoteFormatOptions(quote, undefined, financials.quoteMetadata?.instrumentType), quote.currency);
+  const options = withCurrencyMinorDigits({
+    ...quoteFormatOptions(quote, undefined, financials.quoteMetadata?.instrumentType),
+    ...financials.currencyCodes ? { currencyCode: true } : {},
+  }, quote.currency);
   const price = (value: number) => formatMarketPriceWithCurrency(value, quote.currency, options);
   const extended = getExtendedSessionDisplay(quote);
   const extendedLabel = extended ? EXTENDED_SESSION_LABELS[extended.session] : "";
@@ -732,7 +766,8 @@ function valuationPriceMetrics(financials: FundamentalsReportData): Fundamentals
     session.changePercent != null && Number.isFinite(session.changePercent)
       ? {
         label: "Change",
-        text: colorBySign(`${formatMarketChangeWithCurrency(session.change, quote.currency, options, session.price)} (${formatPercentRaw(session.changePercent)})`, session.change),
+        // With what the move is measured from, as `ticker` and `quote` say it: "vs Fri 16 Oct close".
+        text: quoteChangeText(quote, session, options),
         value: session.changePercent,
         unit: "%",
       }
@@ -767,7 +802,7 @@ function fundamentalsReportMetrics(snapshot: FundamentalsReportData, view: "fund
     ? { text: `${formatCompact(capitalization.value)} ${capitalization.currency}`, value: capitalization.value, unit: capitalization.currency }
     : { text: "—" };
   const metrics = fundamentalsMetrics(quote, fundamentals, financials.profile, marketCap, computeTickerPriceReturns(financials), fundamentalsCurrency(financials),
-    undefined, snapshot.distributions ?? null, snapshot.bondFund ?? null);
+    undefined, snapshot.distributions ?? null, snapshot.bondFund ?? null, snapshot.currencyCodes === true);
   if (view === "fundamentals") {
     return [...metrics, ...floatAndShortInterestMetrics(quote, fundamentals, financials.profile)]
       .filter((metric) => metric.text !== "—");
@@ -927,7 +962,7 @@ export async function buildTickerReport({
   tickerFile: TickerRecord | null;
   financials: TickerFinancials;
   config: AppConfig;
-  toBase: (value: number, fromCurrency: string) => Promise<number>;
+  toBase: ReportBaseConverter;
   notes?: string;
   /** Why there is no quote, when a source said; "Quote unavailable." otherwise. */
   quoteNote?: string;
@@ -944,8 +979,10 @@ export async function buildTickerReport({
   const profile = financials.profile;
   const name = quote?.name || tickerFile?.metadata.name || symbol;
   const baseQuoteOptions = quoteFormatOptions(quote, tickerFile?.metadata.assetCategory, financials.quoteMetadata?.instrumentType);
+  const baseCurrency = config.baseCurrency.trim().toUpperCase();
+  const codes = writesCurrencyCodes(config);
   // Pad money prices to the currency's minor unit so a range reads £35.10 - £35.485, never past it (JPY has none).
-  const quoteOptions = withCurrencyMinorDigits(baseQuoteOptions, quote?.currency);
+  const quoteOptions = withCurrencyMinorDigits(codes ? { ...baseQuoteOptions, currencyCode: true } : baseQuoteOptions, quote?.currency);
   const lines: string[] = [];
 
   lines.push(`${cliStyles.accent(quote?.symbol ?? symbol)} ${cliStyles.bold(name)}`);
@@ -956,9 +993,10 @@ export async function buildTickerReport({
   const indexLevel = isIndexLevel(quote?.instrumentType?.trim() || financials.quoteMetadata?.instrumentType?.trim() || tickerFile?.metadata.assetCategory);
   const summaryParts = [
     listingVenueLabel(listingExchange, quote, financials, tickerFile) || undefined,
-    indexLevel ? INDEX_POINTS_LABEL : quoteCurrency ? `Currency ${quoteCurrency}` : undefined,
+    indexLevel ? INDEX_POINTS_LABEL : quoteCurrency ? `Currency ${currencyCodeLabel(quoteCurrency)}` : undefined,
     quoteMarketStateLabel(quote) ?? undefined,
-    quote?.dataSource ? `Source ${quote.dataSource.toUpperCase()}` : undefined,
+    // A listing that no longer trades has no delay to speak of: its quote is its last session's close.
+    quote?.dataSource && !quote.delisting ? `Source ${quote.dataSource.toUpperCase()}` : undefined,
   ].filter((part): part is string => !!part);
   if (summaryParts.length > 0) {
     lines.push(cliStyles.muted(summaryParts.join(METADATA_SEPARATOR)));
@@ -994,21 +1032,25 @@ export async function buildTickerReport({
   // Market cap and the multiples are measured at the regular session price the Quote section heads with.
   const priced = atRegularSessionPrice(financials);
   const capitalization = selectMarketCapitalization(priced.quote, priced.fundamentals);
-  const convertedMarketCap = capitalization ? await toBase(capitalization.value, capitalization.currency) : Number.NaN;
+  // Market cap and EV read in the currency they are reported in, as the revenue and income beside them do,
+  // with the base currency's figure after them when it differs: 627.2B USD (878.15B CAD).
+  const convertedCurrencies = new Set<string>();
+  const inBase = async (value: number, currency: string): Promise<string> => {
+    if (currency.trim().toUpperCase() === baseCurrency) return "";
+    const converted = await toBase(value, currency);
+    if (!Number.isFinite(converted)) return "";
+    convertedCurrencies.add(currency.trim().toUpperCase());
+    return ` (${formatCompact(converted)} ${baseCurrency})`;
+  };
   const marketCapText = capitalization
-    ? Number.isFinite(convertedMarketCap)
-      ? `${formatCompact(convertedMarketCap)} ${config.baseCurrency}`
-      : `${formatCompact(capitalization.value)} ${capitalization.currency}`
+    ? `${formatCompact(capitalization.value)} ${capitalization.currency}${await inBase(capitalization.value, capitalization.currency)}`
     : "—";
   // Shown in the same currency as the market cap, so the two can be compared.
   const enterpriseValue = reportedEnterpriseValue(priced.fundamentals);
   const evCurrency = enterpriseValueCurrency(quote, fundamentals);
   // A minor unit such as GBp stays as reported: the converter would read it as the major currency.
-  const convertedEnterpriseValue = enterpriseValue != null && evCurrency && /^[A-Z]{3}$/.test(evCurrency)
-    ? await toBase(enterpriseValue, evCurrency) : Number.NaN;
-  const enterpriseValueText = Number.isFinite(convertedEnterpriseValue)
-    ? `${formatCompact(convertedEnterpriseValue)} ${config.baseCurrency}`
-    : formatReportedMoney(enterpriseValue, evCurrency);
+  const enterpriseValueText = `${formatReportedMoney(enterpriseValue, evCurrency)}${enterpriseValue != null && evCurrency && /^[A-Z]{3}$/.test(evCurrency)
+    ? await inBase(enterpriseValue, evCurrency) : ""}`;
 
   if (quote) {
     // As the Overview reads it: the regular session, then the extended-hours print against its close.
@@ -1023,13 +1065,16 @@ export async function buildTickerReport({
     const volume = reportedQuoteVolume(quote);
     // A futures price is its latest trade; the exchange settlement is its own row, dated by its session.
     appendMetricSection(lines, "Quote", [
-      ["Last", colorBySign(formatMarketPriceWithCurrency(session.price, quote.currency, quoteOptions), session.change)],
+      // A price in cents says what it is per: 314.95¢/lb.
+      ["Last", colorBySign(`${formatMarketPriceWithCurrency(session.price, quote.currency, quoteOptions)}${minorUnitPricePer(futuresContract, quote.currency)}`, session.change)],
       ...futuresContract
         ? [["Settle", futuresSettleText(futuresContract, quote)] as [string, string]]
         : [],
-      ["Change", colorBySign(`${formatMarketChangeWithCurrency(session.change, quote.currency, quoteOptions, session.price)} (${formatPercentRaw(session.changePercent)})`, session.change)],
+      // The move says what it is measured from: "vs Fri 16 Oct close", a future's "vs Fri 16 Oct settle".
+      ["Change", quoteChangeText(quote, session, quoteOptions, futuresContract)],
       ["Open", quote.open != null ? formatMarketPriceWithCurrency(quote.open, quote.currency, quoteOptions) : "—"],
-      ["Day Range", quote.low != null || quote.high != null
+      // A listing that no longer trades: its last session's range, never today's.
+      [quote.delisting ? "Last Session" : "Day Range", quote.low != null || quote.high != null
         ? formatPriceRange(quote.low, quote.high, quote.currency, quoteOptions)
         : "—"],
       ["52W Range", quote.low52w != null || quote.high52w != null
@@ -1050,10 +1095,11 @@ export async function buildTickerReport({
   }
 
   const metrics = fundamentalsMetrics(quote, priced.fundamentals, profile, { text: marketCapText }, priceReturns, fundamentalsCurrency(financials),
-    { text: enterpriseValueText }, distributions, bondFund);
+    { text: enterpriseValueText }, distributions, bondFund, codes);
   const beforeFundamentals = lines.length;
   appendMetricSection(lines, "Fundamentals", metricLines(metrics));
   for (const note of fundamentalsNotes(priced, metrics, quote?.currency)) lines.push(cliStyles.muted(note));
+  if (lines.length > beforeFundamentals) for (const note of conversionNotes(toBase, convertedCurrencies)) lines.push(cliStyles.muted(note));
   // Where a fund's facts would go: under its fundamentals, or in their place.
   const fund = fundFactsNote(quote?.symbol ?? symbol,
     quote?.tradingExchangeName || listingExchange || quote?.listingExchangeName || quote?.exchangeName || tickerFile?.metadata.exchange, financials, tickerFile);
@@ -1071,13 +1117,13 @@ export async function buildTickerReport({
   const latestAnnual = latestFinancialPeriod(financials.annualStatements, row => row.date);
   if (latestAnnual) {
     appendMetricSection(lines, `Latest Annual (${statementPeriodText(latestAnnual.date, statementFilings?.latestAnnual ?? null)})`,
-      buildStatementMetrics(latestAnnual, statementCurrency(latestAnnual)));
+      buildStatementMetrics(latestAnnual, statementCurrency(latestAnnual), codes));
   }
 
   const latestQuarter = latestFinancialPeriod(financials.quarterlyStatements, row => row.date);
   if (latestQuarter) {
     appendMetricSection(lines, `Latest Quarter (${statementPeriodText(latestQuarter.date, statementFilings?.latestQuarter ?? null)})`,
-      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter)));
+      buildStatementMetrics(latestQuarter, statementCurrency(latestQuarter), codes));
   }
   // The statements stop a quarter short of the results the company has released.
   if (statementFilings?.resultsRelease && (latestAnnual || latestQuarter)) lines.push(cliStyles.muted(resultsReleaseText(statementFilings.resultsRelease)));
@@ -1161,6 +1207,10 @@ function buildTickerStructuredData({
       name: quote.name,
       // Last and Change as the text report reads them, then the extended print from that close.
       ...getQuoteSessionFields(quote),
+      // What Change is measured from ("vs Fri 16 Oct close"), and the quote's previous close with its exchange-local date.
+      changeBasis: changeBasisJson(quoteChangeBasis(quote, { terms: futuresContract })),
+      previousClose: quote.previousClose ?? null,
+      previousCloseDate: quotePreviousCloseDate(quote),
       priceBasis: quote.priceBasis ?? null,
       currency: quote.currency,
       marketCap: priced.quote?.marketCap ?? null,

package/src/cli/currency-hints.ts

@@ -0,0 +1,27 @@
+import { isVenueAbroad } from "../tickers/listing-fate";
+import type { Quote } from "../types/financials";
+import { isCurrencyCode } from "../utils/currency-pair";
+import { canonicalExchange } from "../utils/exchanges";
+import { UNLISTED_TYPES, type CliListing } from "./listing-arg";
+
+// Quoted as dollars per unit (EUR/USD); every other currency as units per dollar (USD/MXN).
+const DOLLARS_PER_UNIT = new Set(["EUR", "GBP", "AUD", "NZD"]);
+
+/**
+ * "MXN is also a currency: fx MXN, quote USD/MXN" for a bare currency code
+ * that read as a listing abroad (MXN is mixi Inc on Stuttgart's exchange): the
+ * quote is that company's, and a currency was likely what was typed. Null for
+ * a code that is no currency, for the dollar (a US fund trades as USD, and
+ * there is no USD/USD), for a listing that named or saved its venue, and for
+ * one in the US.
+ */
+export function currencyCodeNote(
+  listing: Pick<CliListing, "symbol" | "exchange" | "saved">,
+  quote: Pick<Quote, "listingExchangeName" | "exchangeName" | "instrumentType"> | null | undefined,
+): string | null {
+  const code = listing.symbol;
+  if (!quote || listing.exchange || listing.saved || code === "USD" || !/^[A-Z]{3}$/.test(code) || !isCurrencyCode(code)) return null;
+  if (UNLISTED_TYPES.has(quote.instrumentType?.trim().toUpperCase() ?? "")) return null;
+  if (!isVenueAbroad(canonicalExchange(quote.listingExchangeName || quote.exchangeName))) return null;
+  return `${code} is also a currency: fx ${code}, quote ${DOLLARS_PER_UNIT.has(code) ? `${code}/USD` : `USD/${code}`}`;
+}

package/src/cli/fx-pair.ts

@@ -1,5 +1,6 @@
 import { currencyMinorDigits } from "../market-data/market/format";
 import { parseTypedNumber, readCurrencyAmount } from "../utils/decimal-comma";
+import { currenciesNamed } from "../utils/currency-names";
 
 /**
  * What `gloomberb fx` is asked for. A bare code is one unit of it in the base
@@ -12,6 +13,8 @@ export interface FxRequest {
   currency: string;
   /** The currency the price is in: the base currency for a bare code, the quote of a pair. */
   baseCurrency: string;
+  /** Each currency typed as its name (`yen`) and the code it was read as, said beside the answer. */
+  readAs?: string[];
 }
 
 const CURRENCY_CODE = /^[A-Z]{3}$/;
@@ -30,19 +33,45 @@ function isKnownCurrency(code: string): boolean {
   return knownCurrencies.has(code);
 }
 
+/**
+ * A currency typed as its name: the code a name that is one currency's reads
+ * as, or the sentence listing the currencies a name several share (`peso`),
+ * with `retry` the argument that asks for the first of them. Null for text
+ * that names none.
+ */
+function readCurrencyName(typed: string, retry: (code: string) => string): { code: string } | { error: string } | null {
+  const named = currenciesNamed(typed);
+  if (named.length === 0) return null;
+  if (named.length === 1) return { code: named[0]!.code };
+  const choices = named.map(({ code, qualifier }) => (qualifier ? `${code} (${qualifier})` : code)).join(", ");
+  return { error: `${typed} names several currencies: ${choices}. Write one as its code, such as fx ${retry(named[0]!.code)}.` };
+}
+
 /** The request, or the sentence saying what is wrong with the argument. */
 export function parseFxRequest(raw: string, baseCurrency: string): FxRequest | { error: string } {
+  const typed = raw.trim().split("/").map((part) => part.trim());
   const text = raw.trim().toUpperCase();
-  const parts = text.split("/").map((part) => part.trim());
+  const parts = typed.map((part) => part.toUpperCase());
   if (parts.length > 2 || parts.some((part) => !part)) return { error: `"${raw}" is not a currency or a pair such as USD/NGN.` };
   // EURUSD is the pair typed without its slash: say how to write it.
   const joined = parts.length === 1 && /^[A-Z]{6}$/.test(text) && isKnownCurrency(text.slice(0, 3)) && isKnownCurrency(text.slice(3));
   if (joined) return { error: `${text} is not a currency code; write the pair as ${text.slice(0, 3)}/${text.slice(3)}.` };
+  // A name (peso, yen, Swiss franc) is a currency's code. Three letters that are a code stay one: only a name that is no code reads as one.
+  const readAs: string[] = [];
+  for (const [index, part] of parts.entries()) {
+    if (isKnownCurrency(part)) continue;
+    const named = readCurrencyName(typed[index]!, (code) => parts.map((other, at) => at === index ? code : other).join("/"));
+    if (!named) continue;
+    if ("error" in named) return named;
+    readAs.push(`Read ${typed[index]} as ${named.code}.`);
+    parts[index] = named.code;
+  }
   const bad = parts.filter((part) => !CURRENCY_CODE.test(part));
   if (bad.length > 0) return { error: `${bad.join(" and ")} ${bad.length > 1 ? "are not currency codes" : "is not a currency code"}; use three letters such as NGN.` };
-  return parts.length === 2
+  const request = parts.length === 2
     ? { currency: parts[0]!, baseCurrency: parts[1]! }
     : { currency: parts[0]!, baseCurrency: baseCurrency.trim().toUpperCase() };
+  return readAs.length > 0 ? { ...request, readAs } : request;
 }
 
 /** What `gloomberb fx` is asked for, with the amount to convert when one comes first. */
@@ -55,7 +84,14 @@ export interface FxArgs {
 }
 
 /** Every form `fx` takes, for its usage line. */
-export const FX_USAGE = "fx <currency> | fx <base>/<quote> | fx <amount> <from>/<to> | fx <amount> <from> <to>";
+export const FX_USAGE = "fx <currency> | fx <base>/<quote> | fx <amount> <from>/<to> | fx <amount> <from> <to> [--date <day>]";
+
+/** A currency's name of several words (`hong kong dollar`, `100 swiss franc`) as the one argument it is. */
+function joinNameWords(args: readonly string[]): readonly string[] {
+  const amount = args.length > 2 && parseTypedNumber(args[0]).kind !== "invalid" ? 1 : 0;
+  const name = args.slice(amount).join(" ");
+  return args.length - amount > 1 && currenciesNamed(name).length > 0 ? [...args.slice(0, amount), name] : args;
+}
 
 /**
  * `fx` arguments: a currency or a pair (`EUR`, `USD/NGN`), or an amount and
@@ -66,7 +102,8 @@ export const FX_USAGE = "fx <currency> | fx <base>/<quote> | fx <amount> <from>/
  * refused naming both readings. An amount and one currency converts to USD
  * (`toUsdByDefault`). The error sentence otherwise.
  */
-export function parseFxArgs(args: readonly string[], baseCurrency: string): FxArgs | { error: string } {
+export function parseFxArgs(words: readonly string[], baseCurrency: string): FxArgs | { error: string } {
+  const args = joinNameWords(words);
   if (args.length === 1) {
     const request = parseFxRequest(args[0]!, baseCurrency);
     if (!("error" in request)) return { request };