gloomberb 0.16.1 → 0.16.3

package/src/plugins/builtin/holders/pane.tsx

@@ -26,25 +26,31 @@ import {
   formatMaybePercent,
   formatMoneyCompact,
   formatSignedCompact,
+  holderStakeMarketCap,
+  holderValueCurrency,
   resolveHolderOwnershipPercent,
 } from "./format";
+import { holderShareBasisMarker } from "./report-header";
 import {
   buildColumns,
+  hasHolderChanges,
   buildRows,
   DEFAULT_SORT,
+  nextViewMode,
   sortRows,
   VIEW_TABS,
 } from "./table-model";
 import { loadHolderData } from "./client";
 import { HoldersTreemap } from "./treemap";
+import { BeneficialOwnersView } from "./beneficial-view";
 import type { HolderColumn, HolderColumnId, HolderRow, SortPreference, ViewMode } from "./types";
 import { loadHolder13FMatches, type Holder13FMatch } from "./thirteenf-match";
 import { useSampledValue, useTickerQuoteStream } from "../../../state/hooks/live-ticker-financials";
 
 const HOLDER_MARKET_CAP_SAMPLE_MS = 5_000;
 
-/** The "13F" badge: the label and its padding. */
-const FUND_BADGE_WIDTH = 5;
+/** The width of a three-letter badge ("13F", "ADR"): the label and its padding. */
+const BADGE_WIDTH = 5;
 
 export function HoldersView({ focused, width, height }: { focused: boolean; width: number; height: number }) {
   const { nativePaneChrome } = useUiCapabilities();
@@ -67,17 +73,20 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
   // refresh keeps the last holders; the failure goes to the footer.
   const { data, loading, error, reload } = useAsyncResource<HolderData>(loadHolders, { keepPreviousData: true });
 
-  const currency = data?.currency || ticker?.metadata.currency || "USD";
+  // The values' own currency: dollars from the 13F filings on a London line, not its pence.
+  const currency = holderValueCurrency(data, ticker?.metadata.currency || "USD")!;
   // A stake without a reported percentage is the holding's value over the
-  // market cap. The stream keeps the cap current, about once a second; the
-  // stakes follow it at most every few seconds so ticks do not re-sort them.
+  // market cap, when both are in one currency. The stream keeps the cap
+  // current, about once a second; the stakes follow it at most every few
+  // seconds so ticks do not re-sort them.
   useTickerQuoteStream(ticker ? symbol : null, ticker, { surface: "detail", visible: false, weight: 30 });
-  const quoteMarketCap = financials?.quote?.marketCap;
-  const liveMarketCap = financials?.quote?.currency && financials.quote.currency !== currency ? undefined : quoteMarketCap;
+  const liveMarketCap = holderStakeMarketCap(financials?.quote?.marketCap, financials?.quote?.currency, currency);
   const marketCap = useSampledValue(liveMarketCap, HOLDER_MARKET_CAP_SAMPLE_MS, `${symbol ?? ""}:${currency}`);
   const rows = useMemo(() => buildRows(data), [data]);
   const sortedRows = useMemo(() => sortRows(rows, sortPreference, marketCap), [marketCap, rows, sortPreference]);
-  const columns = useMemo(() => buildColumns(width), [width]);
+  // Change columns only when the source reports a change; otherwise they read "-" on every row.
+  const showChange = useMemo(() => hasHolderChanges(rows), [rows]);
+  const columns = useMemo(() => buildColumns(width, showChange), [showChange, width]);
   const selectedIdx = selectedId
     ? sortedRows.findIndex((row) => row.id === selectedId)
     : -1;
@@ -145,7 +154,7 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
   }, [setSortPreference]);
 
   const toggleView = useCallback(() => {
-    setViewMode((current) => current === "table" ? "chart" : "table");
+    setViewMode(nextViewMode);
   }, [setViewMode]);
 
   const refresh = useCallback(() => {
@@ -211,17 +220,22 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
     switch (column.id) {
       case "holder": {
         const color = rowState.selected ? colors.selectedText : colors.textBright;
-        if (!fundMatches.has(row.id)) return { text: row.name, color, attributes: TextAttributes.BOLD };
-        // A fund with a 13F opens on Enter or o. The name gives way first, so
-        // the marker survives a narrow column.
+        // ADR: a position held as receipts on a home line's list. 13F: a fund
+        // whose filing opens on Enter or o.
+        const receipts = holderShareBasisMarker(row);
+        const fund = fundMatches.has(row.id);
+        if (!receipts && !fund) return { text: row.name, color, attributes: TextAttributes.BOLD };
+        const badges = (receipts ? 1 : 0) + (fund ? 1 : 0);
+        // The name gives way first, so the markers survive a narrow column.
         return {
-          text: `${row.name} 13F`,
+          text: [row.name, receipts, fund ? "13F" : ""].filter(Boolean).join(" "),
           content: (
             <Box flexDirection="row" gap={1} width={column.width} overflow="hidden">
               <Text fg={color} attributes={TextAttributes.BOLD}>
-                {clipToDisplayWidth(row.name, Math.max(1, column.width - FUND_BADGE_WIDTH - 1))}
+                {clipToDisplayWidth(row.name, Math.max(1, column.width - badges * (BADGE_WIDTH + 1)))}
               </Text>
-              <Badge label="13F" tone="accent" />
+              {receipts ? <Badge label={receipts} /> : null}
+              {fund ? <Badge label="13F" tone="accent" /> : null}
             </Box>
           ),
         };
@@ -250,7 +264,9 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
     }
   }, [currency, fundMatches, marketCap]);
 
+  // The 13D/G tab registers its own footer.
   usePaneFooter("holders", () => {
+    if (viewMode === "13dg") return null;
     return {
       info: [
         ...(data?.asOf ? [{ id: "as-of", parts: [{ text: data.asOf, tone: "value" as const }] }] : []),
@@ -264,7 +280,7 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
         ...(selectedFundMatch ? [{ id: "fund", key: "o", label: "pen 13F", onPress: () => openFundDetail(selectedRow) }] : []),
       ],
     };
-  }, [data, error, fundMatching, loading, openFundDetail, selectedFundMatch, selectedRow]);
+  }, [data, error, fundMatching, loading, openFundDetail, selectedFundMatch, selectedRow, viewMode]);
 
   const selectView = useCallback((value: string) => setViewMode(value as ViewMode), [setViewMode]);
   // As a research tab, h/l move between research tabs; `s` switches the view.
@@ -316,6 +332,16 @@ export function HoldersView({ focused, width, height }: { focused: boolean; widt
           selectedTextOverridesCellColor
           emptyStateTitle={statusTitle ?? "No holders available"}
         />
+      ) : viewMode === "13dg" ? (
+        <BeneficialOwnersView
+          focused={focused}
+          width={width}
+          symbol={symbol ?? null}
+          holderRows={rows}
+          fundMatches={fundMatches}
+          onCycleView={toggleView}
+          onRefreshHolders={refresh}
+        />
       ) : (
         <HoldersTreemap
           rows={sortedRows}

package/src/plugins/builtin/holders/report-header.ts

@@ -0,0 +1,136 @@
+import type { HolderData } from "../../../types/financials";
+import { currencyUnitLabel, resolveCurrencyUnit } from "../../../utils/currency-units";
+import { adrRatioText } from "../../../utils/depositary-receipt";
+import { canonicalExchange, isUsListingExchange, resolveExchangeTimeZone } from "../../../utils/exchanges";
+
+/**
+ * The lines above a holder table in text reports (`holders`, `insider`,
+ * `13f`, `fn HDS`): which listing, in which unit, and how much of the list
+ * is shown. Holder lists come as the source's own top holders, usually
+ * without a total, so the count says that rather than implying a full list.
+ */
+export interface HolderReportFacts {
+  name?: string | null;
+  /** Left out when the report title already names it. */
+  symbol?: string | null;
+  exchange?: string | null;
+  /** The unit the values are in. */
+  currency?: string | null;
+  /** The listing's price currency, when the values are in another one. */
+  listingCurrency?: string | null;
+  /** Left out when the report's closing line already carries it. */
+  asOf?: string | null;
+  /** Rows printed. */
+  shown: number;
+  /** Rows the source returned, before any limit. */
+  reported: number;
+  /** Every holder the source counts, when it says so. */
+  total?: number | null;
+}
+
+/** "Value (GBp)": a money column names its unit. */
+export function moneyColumnHeader(label: string, currency?: string | null): string {
+  const unit = currency?.trim();
+  return unit ? `${label} (${unit})` : label;
+}
+
+function holderCountText(shown: number, reported: number, total?: number | null): string {
+  if (total != null && Number.isFinite(total) && total >= reported) {
+    return `${shown.toLocaleString("en-US")} of ${total.toLocaleString("en-US")} holders`;
+  }
+  if (reported === 0) return "none reported";
+  // Without a total the source's list is its largest holders, cut where it cuts it.
+  return shown < reported ? `${shown} of top ${reported} reported` : `top ${reported} reported`;
+}
+
+/** A venue the app knows by its short name (NasdaqGS is NASDAQ); any other as the source wrote it. */
+function venueLabel(exchange?: string | null): string {
+  const canonical = canonicalExchange(exchange ?? "");
+  return resolveExchangeTimeZone(canonical) ? canonical : (exchange ?? "").trim();
+}
+
+/** What the list is, after the listing is named: its unit, date and how much of it is shown. */
+export function holderListFacts(
+  facts: Pick<HolderReportFacts, "currency" | "listingCurrency" | "asOf" | "shown" | "reported" | "total">,
+): string[] {
+  const unit = currencyUnitLabel(facts.currency);
+  // Dollars on a London line: say they are the values' unit, not the listing's.
+  const otherUnit = unit && facts.listingCurrency?.trim() && facts.listingCurrency.trim() !== facts.currency?.trim();
+  return [
+    otherUnit ? `values in ${unit}` : unit,
+    facts.asOf ? `as of ${facts.asOf}` : "",
+    holderCountText(facts.shown, facts.reported, facts.total),
+  ].filter(Boolean);
+}
+
+export function holdersHeaderLine(facts: HolderReportFacts): string {
+  const name = facts.name?.trim();
+  const symbol = facts.symbol?.trim();
+  const identity = name && symbol && name !== symbol ? `${name} (${symbol})` : name || symbol || "";
+  return [identity, venueLabel(facts.exchange), ...holderListFacts(facts)].filter(Boolean).join(" | ");
+}
+
+/** The one report date every row shares, or null when they differ or none has one. */
+export function sharedReportDate(rows: ReadonlyArray<{ reportDate?: unknown }>): string | null {
+  const dates = new Set(rows.map((row) => (typeof row.reportDate === "string" ? row.reportDate : "")));
+  const [only] = dates;
+  return dates.size === 1 && only ? only : null;
+}
+
+/**
+ * How a holder value was reached: reported shares times the latest price, or,
+ * where Gloom Cloud priced the filings themselves, times the security's price
+ * at the report date in the values' currency.
+ */
+export function holderValueBasis(
+  reportDate: string | null,
+  basis?: HolderData["valueBasis"] | null,
+  valueCurrency?: string | null,
+): string {
+  const shares = `shares reported${reportDate ? ` at ${reportDate}` : ""}`;
+  if (basis === "period_end_price") {
+    const unit = valueCurrency?.trim();
+    return `${shares} x period-end price${unit ? ` (${unit})` : ""}`;
+  }
+  return `${shares} x latest price`;
+}
+
+/** The short marker a holder row carries when its position is held as depositary receipts. */
+export function holderShareBasisMarker(row: { shareBasis?: unknown }): string {
+  return row.shareBasis === "depositary_receipt" ? "ADR" : "";
+}
+
+/**
+ * What the share counts are, when Gloom Cloud says: which rows of a home
+ * line are positions in the receipts, or that a receipt line's rows all are.
+ */
+export function holderShareBasisNote(
+  data: Pick<HolderData, "shareBasis" | "adrRatio">,
+  rows: ReadonlyArray<{ shareBasis?: unknown }>,
+): string | null {
+  const ratio = adrRatioText(data.adrRatio);
+  const each = ratio ? ` (${ratio})` : "";
+  if (rows.some((row) => holderShareBasisMarker(row))) return `ADR: shares held as depositary receipts${each}.`;
+  if (rows.length > 0 && data.shareBasis === "depositary_receipt") return `Shares are depositary receipts${each}.`;
+  return null;
+}
+
+/** A listing outside the US, by its venue, or by a currency other than the dollar. */
+function isNonUsHolderListing(exchange?: string | null, currency?: string | null): boolean {
+  const venue = canonicalExchange(exchange ?? "");
+  if (venue && !isUsListingExchange(venue) && resolveExchangeTimeZone(venue)) return true;
+  const unit = resolveCurrencyUnit(currency).currency;
+  return unit !== "" && unit !== "USD";
+}
+
+/**
+ * Holder lists are institutions' quarterly filings, mostly US 13F. On a
+ * listing outside the US they are not that market's share register, which a
+ * reader would otherwise assume.
+ */
+export function nonUsHolderCaveat(exchange?: string | null, currency?: string | null): string | null {
+  if (!isNonUsHolderListing(exchange, currency)) return null;
+  const canonical = canonicalExchange(exchange ?? "");
+  const venue = resolveExchangeTimeZone(canonical) ? canonical : "local";
+  return `Positions come from institutional filings (mostly US 13F), not the ${venue} share register.`;
+}

package/src/plugins/builtin/holders/table-model.ts

@@ -11,8 +11,15 @@ export const DEFAULT_SORT: SortPreference = {
 export const VIEW_TABS: Array<{ label: string; value: ViewMode }> = [
   { label: "Table", value: "table" },
   { label: "Chart", value: "chart" },
+  { label: "13D/G", value: "13dg" },
 ];
 
+/** `s` steps through the views in tab order. */
+export function nextViewMode(current: ViewMode): ViewMode {
+  const index = VIEW_TABS.findIndex((tab) => tab.value === current);
+  return VIEW_TABS[(index + 1) % VIEW_TABS.length]!.value;
+}
+
 export function buildRows(data: HolderData | null): HolderRow[] {
   return (data?.holders ?? []).map((holder, index) => ({
     ...holder,
@@ -20,23 +27,31 @@ export function buildRows(data: HolderData | null): HolderRow[] {
   }));
 }
 
-export function buildColumns(width: number): HolderColumn[] {
+/** Whether any holder carries the quarter's change; many sources report none. */
+export function hasHolderChanges(rows: readonly HolderRow[]): boolean {
+  return rows.some((row) => row.changeShares != null || row.changePercent != null);
+}
+
+export function buildColumns(width: number, showChange: boolean): HolderColumn[] {
   const valueWidth = 10;
   const sharesWidth = 10;
   const changeWidth = 10;
   const changePercentWidth = 8;
   const heldWidth = 7;
   const dateWidth = 10;
-  const columnCount = 7;
-  const fixedWidth = valueWidth + sharesWidth + changeWidth + changePercentWidth + heldWidth + dateWidth;
+  const columnCount = showChange ? 7 : 5;
+  const fixedWidth = valueWidth + sharesWidth + heldWidth + dateWidth
+    + (showChange ? changeWidth + changePercentWidth : 0);
   const holderWidth = Math.max(16, width - 2 - columnCount - fixedWidth);
 
   return [
     { id: "holder", label: "HOLDER", width: holderWidth, align: "left" },
     { id: "value", label: "MKT VAL", width: valueWidth, align: "right" },
     { id: "shares", label: "AMOUNT", width: sharesWidth, align: "right" },
-    { id: "changeShares", label: "CHG", width: changeWidth, align: "right" },
-    { id: "changePercent", label: "CHG%", width: changePercentWidth, align: "right" },
+    ...(showChange ? [
+      { id: "changeShares", label: "CHG", width: changeWidth, align: "right" },
+      { id: "changePercent", label: "CHG%", width: changePercentWidth, align: "right" },
+    ] satisfies HolderColumn[] : []),
     { id: "percentHeld", label: "HELD", width: heldWidth, align: "right" },
     { id: "reportDate", label: "PERIOD", width: dateWidth, align: "right" },
   ];

package/src/plugins/builtin/holders/thirteenf-match.ts

@@ -1,4 +1,4 @@
-import { listThirteenFForms, searchThirteenFFunds } from "../thirteenf/api";
+import { listThirteenFForms, normalizeCik, searchThirteenFFunds } from "../thirteenf/api";
 import { isoDateToday, isoDateYearsAgo } from "../../../utils/calendar-date";
 import { buildPeriodReports } from "../thirteenf/model";
 import type { HolderRow } from "./types";
@@ -42,6 +42,34 @@ export function bestFundMatch(holderName: string, funds: Array<{ cik: string; na
   return matches.length === 1 ? matches[0] : undefined;
 }
 
+/**
+ * The 13F holder row that is a 13D/13G filer: the row whose matched 13F
+ * manager has the filer's CIK, else the one row whose name is the filer's once
+ * normalised. A parent or subsidiary with a longer name is not the filer, and
+ * two rows with the filer's name leave it unmatched. A manager's CIK can
+ * change (BlackRock's 13G filer did in 2024) while its 13F match keeps the
+ * old one, so an exact name is not overruled by a CIK.
+ */
+export function matchFilerToHolder<Row extends { id: string; name: string }>(
+  filer: { filerCik: string | null; filerName: string },
+  rows: readonly Row[],
+  fundMatches: ReadonlyMap<string, Pick<Holder13FMatch, "cik">> = new Map(),
+): Row | undefined {
+  const cik = filer.filerCik ? normalizeCik(filer.filerCik) : null;
+  const matchedCik = (row: Row) => {
+    const match = fundMatches.get(row.id);
+    return match ? normalizeCik(match.cik) : null;
+  };
+  if (cik) {
+    const byCik = rows.filter((row) => matchedCik(row) === cik);
+    if (byCik.length === 1) return byCik[0];
+  }
+  const name = normalizeName(filer.filerName);
+  if (!name) return undefined;
+  const byName = rows.filter((row) => normalizeName(row.name) === name);
+  return byName.length === 1 ? byName[0] : undefined;
+}
+
 export async function loadHolder13FMatches(
   rows: HolderRow[],
   signal: AbortSignal,

package/src/plugins/builtin/holders/types.ts

@@ -2,7 +2,8 @@ import type { DataTableColumn } from "../../../components";
 import type { HolderRecord } from "../../../types/financials";
 import type { SortDirection } from "../../../utils/sort-values";
 
-export type ViewMode = "table" | "chart";
+/** `13dg`: the Schedule 13D and 13G beneficial owners. */
+export type ViewMode = "table" | "chart" | "13dg";
 export type HolderColumnId = "holder" | "value" | "shares" | "changeShares" | "changePercent" | "percentHeld" | "reportDate";
 export type HolderColumn = DataTableColumn & { id: HolderColumnId };
 

package/src/plugins/builtin/insider/headless.ts

@@ -17,6 +17,7 @@ import {
 } from "./model";
 import { relevantInsiderAmendments } from "./amendments";
 import { formatInsiderName } from "./display";
+import { SEC_FILINGS } from "../shared/report-freshness";
 
 const INSIDER_COLUMNS: HeadlessPaneColumn[] = [
   { key: "form", header: "Form" },
@@ -84,6 +85,7 @@ export function createInsiderHeadless(
 ): HeadlessPaneDefinition<"rows"> {
   return {
     shape: "rows",
+    freshness: { ...SEC_FILINGS, basis: "Form 4 filings", observedKey: "filingDate" },
     argument: {
       kind: "ticker",
       placeholder: "ticker",

package/src/plugins/builtin/ipo-calendar/headless.ts

@@ -104,6 +104,7 @@ function projectIpoCalendarHeadless(payload: IpoCalendarPayload, args: HeadlessP
 
 export const ipoCalendarHeadless: HeadlessPaneDefinition<"rows"> = {
   shape: "rows",
+  freshness: { source: "Exchange listings", status: "not-a-feed", basis: "calendar" },
   argument: {
     kind: "free-text",
     placeholder: "company or ticker",

package/src/plugins/builtin/iv-history/headless.ts

@@ -11,6 +11,7 @@ const percent = (value: unknown) => typeof value === "number" ? formatVol(value)
 
 export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle", argument: { kind: "ticker", description: "US option underlying" },
+  freshness: { status: "not-a-feed", basis: "daily implied volatility", cadence: "daily", observedKey: "date", oldest: null },
   describe: (args) => `HIVG ${args.symbols[0] ?? ""}`,
   discovery: { aliases: ["HIVG"], screenshotReadiness: "live-dom", dataRequirements: ["Cloud stored implied volatility", "Daily price history"],
     limitations: ["History starts February 2024 (OPRA daily trade closes)", "Rank and percentile use trade-close readings only"] },
@@ -57,6 +58,7 @@ export const ivHistoryHeadless: HeadlessPaneDefinition<"bundle"> = {
 
 export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
+  freshness: { status: "not-a-feed", basis: "daily implied volatility", cadence: "daily" },
   argument: { kind: "symbol-list", optional: true, maximum: VCA_LIMIT, description: "US option underlyings; defaults to index and sector ETFs." },
   options: [{ key: "preset", type: "enum", values: [{ value: "etfs" }, { value: "megacaps" }], defaultValue: "etfs", description: "Preset when no symbols are given" }],
   describe: "Volatility rich/cheap",
@@ -86,7 +88,8 @@ export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
         { key: "ivHv", header: "IV/HV", format: (value: unknown) => typeof value === "number" ? value.toFixed(2) : "--" },
       ], rows: rows.map((row) => ({ ...row })) }],
       complete: !queued.length && !universe.error, unavailableSymbols: queued,
-      errors: [universe.error, ...(queued.length ? [`Queued for backfill: ${queued.join(", ")}`] : [])].filter((value): value is string => !!value),
+      errors: [universe.error].filter((value): value is string => !!value),
+      ...(queued.length ? { notes: [`Queued for backfill: ${queued.join(", ")}.`] } : {}),
       metadata: { asOf: payload.asOf, presets: VCA_PRESETS, methodology: METHODOLOGY },
     };
   },

package/src/plugins/builtin/jobs/headless.ts

@@ -151,6 +151,7 @@ function companyBundle(symbol: string, state: JobsCompanyState, roleLimit: numbe
  */
 export const jobsHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle",
+  freshness: { source: "Company careers sites", status: "not-a-feed", basis: "observed job postings" },
   argument: {
     kind: "ticker",
     placeholder: "ticker",

package/src/plugins/builtin/kelly-sizer/index.tsx

@@ -15,6 +15,7 @@ export const positionSizerModule: PluginModule = {
   panes: [
     {
       id: KELLY_PANE_ID,
+      reportFreshness: { source: "Your inputs and Gloom Cloud", status: "not-a-feed", basis: "position sizing" },
       name: "Position Sizer",
       icon: "K",
       component: KellySizerPane,

package/src/plugins/builtin/kelly-sizer/pane.tsx

@@ -35,6 +35,7 @@ import { getSharedRegistry } from "../../registry";
 import { resolveTickerOpenTarget } from "../../../tickers/open-target";
 import { calculatePortfolioSummaryTotals } from "../portfolio-list/metrics";
 import { resolvePortfolioNetLiquidation } from "../portfolio-list/account-metrics";
+import { resolvePortfolioCash } from "../portfolio-list/allocation";
 import {
   buildTrackedCurrencies,
   getCollectionTickersFromConfig,
@@ -71,7 +72,7 @@ import {
   KellySensitivitySection,
   buildKellyResultItems,
 } from "./sections";
-import { getPortfolioPositionValue, resolveActivePortfolioId } from "./portfolio";
+import { getPortfolioPositionValue, resolveActivePortfolioId, resolveKellyBankroll } from "./portfolio";
 import { useKellyCommonAssumptions } from "./state";
 
 export function KellySizerPane({ focused, width, height }: PaneProps) {
@@ -214,9 +215,11 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
     ? portfolioFinancials.get(requestedSymbol!) ?? null
     : financials;
   const { accountState } = usePortfolioAccountState(activePortfolio, { brokerAccounts, config });
+  // Cash entered by hand counts toward a manual portfolio's bankroll; a broker's is in its Net Liq.
+  const manualCash = accountState ? null : resolvePortfolioCash(activePortfolio, null);
   const trackedCurrencies = useMemo(
-    () => buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency),
-    [accountState, config.baseCurrency, portfolioFinancials, portfolioTickers],
+    () => buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency, manualCash?.currency),
+    [accountState, config.baseCurrency, manualCash?.currency, portfolioFinancials, portfolioTickers],
   );
   const exchangeRates = useFxRatesMap(trackedCurrencies);
   const portfolioSummary = useMemo(
@@ -237,9 +240,12 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
     (value) => convertCurrency(value, accountState?.account.currency ?? "", config.baseCurrency, exchangeRates),
     accountState?.snapshotBasis,
   );
-  const sourceBankroll = netLiquidation != null && Number.isFinite(netLiquidation)
-    ? netLiquidation
-    : portfolioSummary.totalMktValue ?? 0;
+  const sourceBankroll = resolveKellyBankroll({
+    netLiquidation,
+    brokerPortfolio: !!activePortfolio?.brokerInstanceId,
+    holdings: portfolioSummary.allocationHoldings ?? [],
+    cashValue: manualCash ? convertCurrency(manualCash.amount, manualCash.currency, config.baseCurrency, exchangeRates) : null,
+  });
   const sourceCurrentValue = getPortfolioPositionValue({
     ticker,
     financials: positionFinancials,

package/src/plugins/builtin/kelly-sizer/portfolio.ts

@@ -2,6 +2,7 @@ import type { AppConfig } from "../../../types/config";
 import type { TickerFinancials } from "../../../types/financials";
 import type { TickerRecord } from "../../../types/ticker";
 import { convertCurrency } from "../../../utils/format";
+import { allocationTotal, type AllocationHolding } from "../portfolio-list/allocation";
 import { getCollectionTypeFromConfig } from "../portfolio-list/pane/data";
 import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue } from "../portfolio-list/position-metrics";
 
@@ -41,6 +42,30 @@ export function getPortfolioPositionValue({
     ?? (metrics.positionCount > 0 ? Number.NaN : 0);
 }
 
+/**
+ * What the portfolio is worth to bet with: its equity. A broker account's is
+ * its Net Liq. Otherwise it is the priced holdings at net value plus the cash
+ * entered for the portfolio, the portfolio header's Total. A broker portfolio
+ * with neither has no known equity: its positions alone are its gross, which
+ * margin puts above the equity, so it gives no bankroll.
+ */
+export function resolveKellyBankroll({
+  netLiquidation,
+  brokerPortfolio,
+  holdings,
+  cashValue,
+}: {
+  netLiquidation: number | null;
+  brokerPortfolio: boolean;
+  holdings: readonly AllocationHolding[];
+  /** Cash entered by hand, in the bankroll currency; NaN when it cannot be converted. */
+  cashValue: number | null;
+}): number {
+  if (netLiquidation != null && Number.isFinite(netLiquidation)) return netLiquidation;
+  if (brokerPortfolio && cashValue == null) return 0;
+  return allocationTotal(holdings, cashValue) ?? 0;
+}
+
 export function resolveActivePortfolioId({
   requestedPortfolioId,
   activeCollectionId,

package/src/plugins/builtin/macro-day/headless.ts

@@ -11,6 +11,8 @@ const share = (value: unknown) => typeof value === "number" ? `${Math.round(valu
 
 export const macroDayHeadless: HeadlessPaneDefinition<"bundle"> = {
   shape: "bundle", argument: { kind: "ticker", description: "Ticker" },
+  // Dated by the maintained release list as much as by the closes, so no session schedule applies.
+  freshness: { status: "not-a-feed", basis: "release-day study on daily closes" },
   describe: (args) => `MDAY ${args.symbols[0] ?? ""}`,
   discovery: { screenshotReadiness: "live-dom", limitations: [
     "US listings; close-to-close on the release day.",

package/src/plugins/builtin/market-halts/index.tsx

@@ -17,6 +17,7 @@ export const marketHaltsPlugin: GloomPlugin = {
   panes: [
     {
       id: MARKET_HALTS_PANE_ID,
+      reportFreshness: { source: "Nasdaq Trader" },
       name: "Market Halts",
       icon: "H",
       component: MarketHaltsPane,

package/src/plugins/builtin/market-heatmap/data.ts

@@ -6,6 +6,8 @@ export const MARKET_HEATMAP_UNIVERSES = [
   { id: "us-equity", label: "US Stocks" },
   { id: "us-etf", label: "US ETFs" },
 ] as const;
+/** The 500 largest US stocks (an older server answers with its own maximum); ETFs stay flat and need fewer. */
+export const MARKET_HEATMAP_REQUEST_COUNT: Record<MarketHeatmapUniverseId, number> = { "us-equity": 500, "us-etf": 160 };
 export interface MarketHeatmapFetchOptions { count?: number; forceRefresh?: boolean; cache?: boolean; }
 export interface MarketHeatmapSources { client?: Pick<typeof apiClient, "getMarketHeatmap">; }
 const DEFAULT_COUNT = 80;