gloomberb 0.18.4 → 0.19.0

package/src/cli/commands/market.ts

@@ -12,7 +12,7 @@ import type {
   Quote,
   TickerFinancials,
 } from "../../types/financials";
-import { currencyPriceMinDigits, formatMarketPrice, formatMarketPriceWithCurrency, quoteFormatOptions, resolveAssetDisplayKind, withCurrencyMinorDigits } from "../../market-data/market/format";
+import { currencyPriceMinDigits, formatMarketPrice, formatMarketPriceWithCurrency, penceFigure, quoteFormatOptions, resolveAssetDisplayKind, withCurrencyMinorDigits } from "../../market-data/market/format";
 import { INDEX_POINTS_EXPORT_UNIT, isIndexLevel, reportedQuoteVolume } from "../../market-data/market/index-level";
 import { changeBasisJson, changeBasisLabel, changeBasisNote, quoteChangeBasis, quotePreviousCloseDate, quoteSettleText } from "../../market-data/market/change-basis";
 import {
@@ -41,6 +41,7 @@ import {
 import { cliArrow, cliStyles, colorBySign, renderSection, renderStats } from "../../utils/cli-output";
 import { filledPeriodsNote, stalePeriodNote, statementHistoryNotes } from "../../utils/financial-statements";
 import { formatPerShareNumber } from "../../utils/reported-money";
+import { isCurrencyPairListing } from "../../utils/fx-market-hours";
 import {
   analystTargetCurrency,
   formatAnalystPrice,
@@ -53,10 +54,12 @@ import {
 } from "../../plugins/builtin/research/analyst-model";
 import { getPublishedUsEquityCalendarYears, getPublishedUsEquitySession } from "../../market-data/published-us-sessions";
 import { isQuoteStaleForCurrentSession, noPrintsTodayText } from "../../market-data/quotes/freshness";
-import { isOptionsUnavailableError, listedOptionsAlternative, optionsUnavailableTitle } from "../../market-data/options-alternatives";
+import {
+  coinOptionsAlternativesText, isCoinWithoutOptions, isOptionsUnavailableError, listedOptionsAlternative, optionsUnavailableTitle,
+} from "../../market-data/options-alternatives";
 import {
   atReportTtmRate, cliFuturesContract, futuresContractMetrics, exportedDividendFundamentals, fundamentalsReportTables, loadDividendDistributions,
-  loadReportBondFacts, renderFundamentalsReport, writesCurrencyCodes,
+  loadReportFundFacts, renderFundamentalsReport, writesCurrencyCodes,
 } from "./ticker";
 import { createBaseConverter } from "../base-converter";
 import { loadStatementFilings } from "../statement-filings";
@@ -72,9 +75,16 @@ import {
   formatExpiryList,
   loadOptionModelInputs,
   loadOptionsChainOpenInterest,
+  chainCoinCurrency,
+  chainHasFilledIv,
+  formatCoinPremiumCell,
   formatOptionDeltaCell,
+  formatOptionDollarCell,
+  formatOptionGammaCell,
   formatOptionIvCell,
   formatOptionQuoteCell,
+  isMarkedChain,
+  MARKED_OPTION_FIELDS,
   OPTION_MODEL_RATE,
   OPTION_VOLATILITY_FIELDS,
   OPTIONS_USAGE,
@@ -82,12 +92,13 @@ import {
   optionsBasisFields,
   optionsBasisFootnote,
   parseOptionExpiration,
+  takeExpirationOption,
   valueChainAtModelSpot,
   type OptionsChainBasis,
 } from "./options-chain";
 import {
   expirationHint, expiredExpiryText, expiryIsoDate, isLiveOptionExpiry, liveDefaultExpiry, liveOptionExpiries, missingExpiryMessage,
-  OPTION_EXPIRATION_FORMAT, OPTION_EXPIRATION_PLACEHOLDER, withLiveExpiryList,
+  OPTION_EXPIRATION_FORMAT, OPTION_EXPIRATION_PLACEHOLDER, optionExpiryVenue, withLiveExpiryList,
 } from "../../utils/option-expiry";
 import { DATE_OPTION_EXAMPLES, isoDateOption, isoDateToday } from "../../utils/calendar-date";
 import { apiClient } from "../../api-client";
@@ -115,6 +126,7 @@ import {
   closedPeriodBarDay,
   formingPeriodBar,
   historyBarStatusNote,
+  venueTradingDay,
   historyCoverageWarning,
   historyFacts,
   historyFlagNote,
@@ -130,6 +142,7 @@ import {
   historyPriceDecimals,
   historyRows,
   historyUnit,
+  quotedPriceDivisor,
   historyVolume,
   historyVolumeText,
   type HistoryRow,
@@ -144,7 +157,7 @@ import {
   symbolListNotes,
   type HistoryListRow,
 } from "../history-export";
-import { isCliFailure } from "../errors";
+import { fail, isCliFailure, NO_DATA_CODE } from "../errors";
 import { mapWithConcurrency } from "../../utils/concurrency";
 import { MISSING_VOLUME_TEXT } from "../../utils/price-history-integrity";
 import { CRYPTO_BOARD_HINT, quoteNotes } from "./crypto-hints";
@@ -206,6 +219,7 @@ import {
   type ResolvedEarningsEvent,
 } from "../../plugins/builtin/shared/earnings-calendar";
 import {
+  coinListingNotes,
   EXCHANGE_OPTION,
   listingHeading,
   listingIdentity,
@@ -294,6 +308,7 @@ import {
   unvaluedHoldersNote,
 } from "../../plugins/builtin/holders/report-rows";
 import { fetchBeneficialOwners } from "../../plugins/builtin/holders/beneficial-client";
+import { fundHoldersAnswer } from "../../plugins/builtin/holders/fund-holders";
 import { centralBankEventsMessage } from "../central-bank-events";
 import { classSharesAsOf, classSharesToday } from "../../plugins/builtin/holders/client";
 import {
@@ -456,7 +471,8 @@ const QUOTE_LEAD_COLUMNS = [
       row.error && !row.price
         // A typo is not an outage: say what is wrong with the symbol itself.
         ? isNotATickerMessage(row.error) ? cliStyles.warning("not a ticker") : cliStyles.danger("unavailable")
-        : yieldLevelCell(row.price, row)
+        // A London line adds the pence it trades in, as the exchange and RNS write it, muted as a table cell's note is: £6.308 630.8p.
+        : `${yieldLevelCell(row.price, row)}${row.pence ? ` ${cliStyles.muted(row.pence)}` : ""}`
     ),
   },
   {
@@ -683,7 +699,7 @@ function changeBasisNotes(results: QuoteCliRecord[], now = Date.now()): string[]
 function withPreviousCloseDate(quote: Quote | null | undefined): (Quote & { previousCloseDate?: string | null }) | null {
   if (!quote) return null;
   const previousCloseDate = quotePreviousCloseDate(quote);
-  const entries = Object.entries(quote);
+  const entries = Object.entries(quote).filter(([key]) => key !== "previousCloseDate");
   const at = entries.findIndex(([key]) => key === "previousClose");
   entries.splice(at < 0 ? entries.length : at + 1, 0, ["previousCloseDate", previousCloseDate]);
   return Object.fromEntries(entries) as Quote & { previousCloseDate?: string | null };
@@ -720,10 +736,12 @@ function quoteRows(results: QuoteCliRecord[], now = Date.now()) {
     // A price in cents says what it is per, as the contract terms word it: 314.95¢/lb.
     const per = display.price != null ? futuresPricePer(result.futuresContract, quote?.currency) : "";
     const previousClose = display.price != null && display.change != null ? display.price - display.change : quote?.previousClose;
+    const last = price(display.price);
     return {
       symbol: result.target.symbol,
       name: quote?.name || result.listing?.name || "",
-      price: `${price(display.price)}${per}`,
+      price: `${last}${per}`,
+      pence: penceFigure(display.price, quote, /\.(\d+)/.exec(last)?.[1]?.length ?? 0),
       rawPrice: display.price,
       priceBasis: quote?.priceBasis ?? null,
       instrumentType: quote?.instrumentType ?? null,
@@ -1007,13 +1025,14 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
       : listings.map((listing) => [listing, startTickerChangeLookup(market.dataProvider, listing.symbol, listing.exchange)] as const));
     // The service's quote of the moment, not each form's local copy from whenever it was last asked for:
     // BRK.B saved on NYSE, BRK-B and BRK.B:NYSE print one quote. A local copy answers only offline.
-    const results = await market.dataProvider.getQuotesBatch(targets, { forceRefresh: ctx.cliOptions.refresh, revalidate: true });
+    // Each row prints what its move is from (Chg Basis).
+    const results = await market.dataProvider.getQuotesBatch(targets, { forceRefresh: ctx.cliOptions.refresh, revalidate: true, datesChangeBasis: true });
     const listingOf = (result: QuoteBatchResult, index: number) => listings[targets.indexOf(result.target)] ?? listings[index]!;
     const asked = results.map(listingOf);
     const request = { command: commandName, noun: "quote" };
     const answers = await Promise.all(results.map((result, index) => {
       const listing = asked[index]!;
-      return answerQuote(result, listing, market, request, ctx.cliOptions.refresh, venues.get(listing) ?? null);
+      return answerQuote(result, listing, market, request, ctx.cliOptions.refresh, venues.get(listing) ?? null, { datesChangeBasis: true });
     }));
     const now = Date.now();
     const symbolChanges = await Promise.all(answers.map(async ({ result }, index) => {
@@ -1092,7 +1111,7 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
         return pair ? [`${row.target.symbol}: ${depositaryPairText(pair, isReceiptSide({ quote: row.quote }))}.`] : [];
       }),
       // A cell shows only "unavailable", and an exported row only its status, so stderr names each failure; the JSON rows carry each reason.
-      ...ctx.cliOptions.format !== "json" ? quoteNotes(data, { exchange }) : [],
+      ...ctx.cliOptions.format !== "json" ? quoteNotes(data) : [],
     ];
     const columns = commandName === "compare" ? compareColumns() : quoteColumns();
     const basisNotes = changeBasisNotes(data, now);
@@ -1107,7 +1126,8 @@ async function runQuote(rawArgs: string[], ctx: Parameters<CliCommandDef["execut
       // close does not read as a contradiction of DGS10 or GC for the same day.
       // Dated by the quotes as served, which say whether one is the saved copy.
       freshness: withSavedCopy(
-        quotesFreshness(data.map((row) => row.quote), yieldsOnly ? { schedule: `Cboe close ${CBOE_YIELD_INDEX_CLOSE}` } : undefined),
+        // A table across markets (US and London lines) dates each market's session and says when each opens.
+        quotesFreshness(data.map((row) => row.quote), { datesEachVenue: true, ...yieldsOnly ? { schedule: `Cboe close ${CBOE_YIELD_INDEX_CLOSE}` } : {} }),
         answers.map(({ result }) => result.quote),
       ),
     }, {
@@ -1389,7 +1409,11 @@ async function loadListingHistory(
   };
   // A coin's volume is traded value in its quote currency: said in every row and on the status line.
   const volume = historyVolume(unit, traded);
-  const rows = historyRows(points, resolution, unit.currency, unit.unit, volume);
+  // Spot FX has no exchange to count its trades: a source's 0 is no volume, printed as missing.
+  const pair = quote?.instrumentType === "CURRENCY" || isCurrencyPairListing(symbol, exchange);
+  // A London line's bars were priced in pence: cleaned there, and printed to the pence decimals `quote` shows.
+  const priceDivisor = quotedPriceDivisor(quote);
+  const rows = historyRows(pair ? points.map(({ volume: _volume, ...point }) => point) : points, resolution, unit.currency, unit.unit, volume, priceDivisor);
   // Bars stop arriving on the listing's own trading days, not New York's.
   const venue = quote?.listingExchangeName || exchange || undefined;
   const served = range === "YTD" && !window ? rows.slice(Math.max(0, yearToDateStartIndex(rows.map((row) => row.date), rows[0]?.interval, venue))) : rows;
@@ -1436,11 +1460,11 @@ async function loadListingHistory(
     // The status line says how far a bar still forming runs; the note is for the bars it does not name.
     gaps ?? [], historyJumpNote(data) ?? [], historyFlagNote(data) ?? [], historyMissingVolumeNote(data) ?? [],
     historyVenueVolumeNote(data) ?? [],
-    historyBarStatusNote(forming ? served : data) ?? [],
+    historyBarStatusNote(forming ? served : data, { tradingDay: venueTradingDay(venue, Date.now()) }) ?? [],
   ].flat();
   return {
     listing, identity, unit, data, resolution, interval, intraday, volume, freshness, notes,
-    decimals: historyPriceDecimals(data, listing.saved?.metadata.assetCategory),
+    decimals: historyPriceDecimals(data, listing.saved?.metadata.assetCategory, priceDivisor),
   };
 }
 
@@ -1641,7 +1665,7 @@ async function runHistoryList(
       oldest: null,
     });
     // A saved copy is marked on the bars a symbol loaded, not on the rows drawn from them (loadListingHistory
-    // reads it there): the list ends "couldn't refresh; saved <time>" for the oldest copy among its symbols.
+    // reads it there): the list ends "couldn't refresh; saved copy from <time>" for the oldest copy among its symbols.
     const savedAt = served.flatMap((history) => history.freshness?.savedAt ?? []).sort()[0];
     const freshness = listFreshness && savedAt && !listFreshness.savedAt ? { ...listFreshness, savedAt } : listFreshness;
     const decimals = (row: Record<string, unknown>) => bySymbol.get(String(row.symbol))?.decimals ?? 2;
@@ -1710,6 +1734,22 @@ const STATEMENT_COLUMNS: CliResultColumn<ReturnType<typeof financialStatementRow
   { key: "currency", header: "Cur" },
 ];
 
+/** A symbol as typed in capitals (`NEE`, `BP:LSE`, `7203.T`), never a word of a company's name. */
+const TYPED_SYMBOL = /^[A-Z0-9][A-Z0-9.:^=&-]{0,15}$/;
+
+/**
+ * The symbols of a command given several where it takes one: `NEE FSLR` as
+ * two words, or as one (`"NEE FSLR"`, `NEE,FSLR`). One word with spaces is
+ * a list only when every part is a symbol as typed, so a company's name
+ * (`"Bank of America"`) is still searched for. Null for one symbol.
+ */
+export function comparedSymbols(args: readonly string[]): string[] | null {
+  const words = args.flatMap((arg) => arg.split(/[\s,]+/)).filter(Boolean);
+  if (words.length < 2) return null;
+  if (args.length > 1 || args.some((arg) => arg.includes(","))) return words;
+  return words.every((word) => TYPED_SYMBOL.test(word)) ? words : null;
+}
+
 async function runFinancials(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1], view: FinancialsView) {
   const args = [...rawArgs];
   const exchangeOption = takeOption(args, "--exchange");
@@ -1734,6 +1774,12 @@ async function runFinancials(rawArgs: string[], ctx: Parameters<CliCommandDef["e
   const tabular = ctx.cliOptions.format === "csv" || ctx.cliOptions.format === "ndjson";
   if (sectionFlag && !tabular) ctx.fail("--section picks one table of --csv or --ndjson output.");
   if (sectionFlag && !section?.trim()) ctx.fail("--section needs a section title or number.");
+  // Several symbols are a comparison, which RV draws side by side.
+  const compared = view === "valuation" ? comparedSymbols(args) : null;
+  if (compared) {
+    ctx.fail(`valuation takes one symbol; got ${compared.join(" ")}.`,
+      `To compare their valuations side by side: gloom fn RV ${compared.join(",")}\nUsage: gloom valuation <symbol>`);
+  }
   const raw = requireOneArg(args, `${commandName} <symbol>`, "symbol", ctx);
   const selectTables = (tables: CliReportTables) => {
     try {
@@ -1755,8 +1801,8 @@ async function runFinancials(rawArgs: string[], ctx: Parameters<CliCommandDef["e
     // declared distribution it annualizes (not in JSON), and one whose dividend stopped says so; read beside the listing notes.
     const distributions = view === "statements" ? null : loadDividendDistributions(
       market.dataProvider, listing.request, financials, { declared: ctx.cliOptions.format !== "json" });
-    // A bond fund's SEC yield, yield to worst and duration, beside its distribution yield.
-    const bondFund = view === "statements" ? null : loadReportBondFacts(listing.request.symbol,
+    // A fund's facts: its bond figures beside its distribution yield, and whether fn ETF has any to point to.
+    const fundFacts = view === "statements" ? null : loadReportFundFacts(listing.request.symbol,
       financials.quote?.tradingExchangeName || listing.request.exchange || financials.quote?.listingExchangeName || financials.quote?.exchangeName,
       financials, listing.saved);
     const treasury = rates ? loadTreasuryTenors() : null;
@@ -1785,13 +1831,14 @@ async function runFinancials(rawArgs: string[], ctx: Parameters<CliCommandDef["e
           loadBankFigures(market.statementSources, listing.request, financials),
         ])
         : [null, { bank: null, note: null }];
-      const bond = await bondFund;
+      const facts = await fundFacts;
+      const bond = facts?.bond ?? null;
       // On the SEC yield when the sponsor publishes one, else the distribution yield the line above shows.
       const taxEquivalent = rates ? analyzeTaxEquivalent({
         symbol: identity.symbol || listing.key, bond, rates, treasury: await treasury,
         distribution: distributionBasis(priced.fundamentals?.dividendYield, priced.fundamentals?.dividendYieldBasis === "trailing" ? "trailing" : "forward"),
       }) : null;
-      const report = { ...data, distributions: await distributions, statementFilings, bank: bank.bank, bankNote: bank.note, bondFund: bond, taxEquivalent,
+      const report = { ...data, distributions: await distributions, statementFilings, bank: bank.bank, bankNote: bank.note, bondFund: bond, fundFacts: facts, taxEquivalent,
         // A base currency other than USD reads every amount with its code, as `ticker` does.
         currencyCodes: writesCurrencyCodes(market.config) };
       ctx.printResult({
@@ -2033,7 +2080,8 @@ async function runNews(rawArgs: string[], ctx: Parameters<CliCommandDef["execute
       return;
     }
     const empty = emptyMessage(false);
-    const read = listing ? listingReadNotes(listing) : [];
+    // A bare coin ticker read as another listing (ETH, the Grayscale fund) says where the coin is, as `quote` does.
+    const read = listing ? [...listingReadNotes(listing), ...coinListingNotes(listing, quote)] : [];
     // A word that is also the company's name ("gold" for Gold.com Inc.) says once which ticker it found and how
     // to search the stories that mention it instead, when those stories are mostly about something else.
     const typed = args[0]?.trim() ?? "";
@@ -2391,14 +2439,20 @@ async function runHolders(
     // --tail counts back from the end of the rows loaded, so it loads at least as many as it asks for.
     const tail = ctx.cliOptions.tail;
     const indexLimit = Math.min(ctx.cliOptions.limit ?? Math.max(tail ?? 0, HOLDERS_DEFAULT_ROWS), HOLDER_ROWS_MAX);
+    const quoted = loadListingQuote(market.dataProvider, listing);
     const [source, quote, form4, index] = await Promise.all([
       loadForListing(
         listing, market, ctx,
         () => market.dataProvider.getHolders(listing.request.symbol, listing.request.exchange),
         (found) => found.holders.length === 0,
         { command: commandName, noun: "holder data" },
-      ),
-      loadListingQuote(market.dataProvider, listing),
+      ).catch(async (error: unknown) => {
+        // A fund has no ownership breakdown: say so, and what reads it, rather than the source's NO_DATA.
+        const fund = await fundHoldersAnswer(listing.symbol, error, await quoted, apiClient);
+        if (fund) fail(fund.message, fund.details.join("\n") || undefined, NO_DATA_CODE);
+        throw error;
+      }),
+      quoted,
       insiderCommand ? loadForm4Report(market, listing) : null,
       indexTicker ? loadIndexedHolders(indexTicker, indexLimit).catch(logFailure("cli.commands-market", "Read the 13F holder index failed", null)) : null,
     ]);
@@ -2606,12 +2660,13 @@ async function runEvents(rawArgs: string[], ctx: Parameters<CliCommandDef["execu
 async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["execute"]>[1]) {
   const args = [...rawArgs];
   const leapsOptions = takeLeapsOptions(args);
-  const expiration = takeOption(args, "--expiration");
+  const expirationOption = takeExpirationOption(args);
+  const { value: expiration, flag: expirationFlag } = expirationOption;
+  if (expirationOption.both) ctx.fail("--expiry is --expiration; give one of them.", `Usage: gloom ${OPTIONS_USAGE}`);
   const exchangeOption = takeOption(args, "--exchange");
   if (leapsOptions.leaps) {
     // With --leaps, --expiration is a window of one expiry.
-    const expirationGiven = expiration != null || rawArgs.some((arg) => arg === "--expiration" || arg.startsWith("--expiration="));
-    const criteria = parseLeapsCriteria({ ...leapsOptions.raw, ...expirationGiven ? { "--expiration": expiration ?? "" } : {} });
+    const criteria = parseLeapsCriteria({ ...leapsOptions.raw, ...expirationOption.given ? { "--expiration": expiration ?? "" } : {} });
     if ("error" in criteria) ctx.fail(criteria.error, `Usage: gloom ${LEAPS_USAGE}`);
     const entries = normalizeSymbols(args);
     if (entries.length === 0) ctx.fail("--leaps needs at least one symbol.", `Usage: gloom ${LEAPS_USAGE}`);
@@ -2623,11 +2678,11 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
   }
   const raw = requireOneArg(args, OPTIONS_USAGE, "symbol", ctx);
   let expirationDate: number | undefined;
-  if (expiration != null || rawArgs.includes("--expiration")) {
+  if (expirationOption.given) {
     const parsed = expiration == null ? null : parseOptionExpiration(expiration);
     if (parsed == null) {
       ctx.fail(
-        expiration == null ? "--expiration needs a date." : `Invalid --expiration "${expiration}".`,
+        expiration == null ? `${expirationFlag} needs a date.` : `Invalid ${expirationFlag} "${expiration}".`,
         `Use ${OPTION_EXPIRATION_FORMAT}.${expiration == null ? "" : expirationHint(expiration)}\nUsage: gloom ${OPTIONS_USAGE}`,
       );
     }
@@ -2642,6 +2697,8 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     const fate = listingFateLoader(listing, market, quotePromise);
     const inputsPromise = loadOptionModelInputs(market.dataProvider, listing, quotePromise, refresh);
     const now = Date.now();
+    // Expiries close on the listing's clock: a coin's options (Deribit) settle at 08:00 UTC on any day.
+    const expiryVenue = optionExpiryVenue(symbol, exchange);
     const readChain = async (expiry: number | undefined) => {
       const cached = await market.dataProvider.getCachedQuery?.("getOptionsChain", [symbol, exchange, expiry, undefined])
         .load({ force: refresh });
@@ -2653,17 +2710,17 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
       };
     };
     // An expiry whose last session has closed has no chain to show: it says so, and names the nearest live one.
-    if (expirationDate != null && !isLiveOptionExpiry(expirationDate, now, exchange)) {
+    if (expirationDate != null && !isLiveOptionExpiry(expirationDate, now, expiryVenue)) {
       const listed = await readChain(undefined).then(({ chain }) => chain.expirationDates,
         logFailure("cli-market", "Read available option expirations failed", []));
       ctx.fail(`expiry ${expiryIsoDate(expirationDate)} for ${listing.key} `
-        + expiredExpiryText(expirationDate, listed, now, { exchange, flag: "expiration" }),
+        + expiredExpiryText(expirationDate, listed, now, { exchange: expiryVenue, flag: expirationFlag.slice(2) }),
       `Run gloom options ${listing.key} to list the live expiries.`);
     }
     const { result, chain: read } = await loadForListing(listing, market, ctx, async () => {
       const first = await readChain(expirationDate);
       // A source can still default to the expiry that lapsed at Friday's close; the nearest live one is shown instead.
-      const live = expirationDate == null ? liveDefaultExpiry(first.chain, now, exchange) : undefined;
+      const live = expirationDate == null ? liveDefaultExpiry(first.chain, now, expiryVenue) : undefined;
       if (live === null) return { ...first, chain: { ...first.chain, calls: [], puts: [] } };
       if (live == null) return first;
       // The default's list stays the catalogue: a dated chain can list fewer expiries.
@@ -2672,6 +2729,8 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         expirationDates: [...new Set([...first.chain.expirationDates, ...shown.chain.expirationDates])].sort((a, b) => a - b) } };
     }, undefined, { command: "options", noun: "options chain", fate }).catch((error: unknown) => {
       if (!isOptionsUnavailableError(error)) throw error;
+      // A coin other than BTC and ETH: say which coins have options, and the bitcoin-linked listings.
+      if (isCoinWithoutOptions(listing.key)) return ctx.fail(optionsUnavailableTitle(listing.key), coinOptionsAlternativesText("options"));
       // A future or commodity with no chain of its own: name the listed fund whose options stand in.
       const alternative = listedOptionsAlternative(listing.key);
       // A name read as a fund or an index asks about the company's stock it means, whose options are listed.
@@ -2681,13 +2740,13 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
           + ` Strategy payoffs: gloom fn OSA ${alternative.symbol}`
         : "Strategy payoffs on a listed underlying: gloom fn OSA <ticker>");
     });
-    const loaded = withLiveExpiryList(read, now, exchange);
+    const loaded = withLiveExpiryList(read, now, expiryVenue);
     const inputs = await inputsPromise;
     if (expirationDate != null && !chainHasExpiry(loaded, expirationDate)) {
       // An unlisted date comes back as an empty chain; its own list of expiries, else the default chain's, says what to pick.
       const listed = loaded.expirationDates.length > 0 ? loaded.expirationDates : await market.dataProvider
         .getOptionsChain(symbol, exchange, undefined, { cacheMode: "default" })
-        .then((fallback) => liveOptionExpiries(fallback.expirationDates, now, exchange),
+        .then((fallback) => liveOptionExpiries(fallback.expirationDates, now, expiryVenue),
           logFailure("cli-market", "Read available option expirations failed", []));
       const miss = missingExpiryMessage(listing.key, expirationDate, listed);
       ctx.fail(miss.message, miss.details);
@@ -2697,7 +2756,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
     // IV and delta are valued at one spot and instant, named under the table and on every exported row.
     const { chain, spot: modelSpot } = valueChainAtModelSpot(loaded, inputs, Date.now(), identity.exchange);
     const basis: OptionsChainBasis = { spot: modelSpot, dividendYield: inputs.dividendYield ?? null,
-      openInterest: await loadOptionsChainOpenInterest(symbol, chain) };
+      openInterest: await loadOptionsChainOpenInterest(symbol, chain), ivFilled: chainHasFilledIv(chain) };
     const basisFields = optionsBasisFields(basis);
     const currency = [...chain.calls, ...chain.puts].find((contract) => contract.currency?.trim())?.currency.trim().toUpperCase()
       ?? quote?.currency ?? null;
@@ -2706,7 +2765,10 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
       : `Options refresh failed; showing the chain stored ${new Date(result.fetchedAt).toISOString()}`
         + (chain.asOf ? ` (last trade ${chain.asOf})` : "");
     const sessionWarning = refreshWarning ? null : priorSessionChainWarning(chain, identity.exchange, Date.now());
-    const modelWarning = inputs.spot == null && (chain.calls.length > 0 || chain.puts.length > 0)
+    // A venue that marks its contracts (Deribit) states IV and greeks without a quote.
+    const marked = isMarkedChain(chain);
+    const coin = chainCoinCurrency(chain);
+    const modelWarning = !marked && inputs.spot == null && (chain.calls.length > 0 || chain.puts.length > 0)
       ? `IV and delta need a current ${listing.key} quote; those columns are blank`
       : null;
     const listed = chain.expirationDates.length > 0 || chain.calls.length > 0 || chain.puts.length > 0;
@@ -2733,25 +2795,28 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         // `iv` is annualised volatility and `delta` the option's change per 1.00 move in the underlying, both decimals.
         units: { iv: "annualized decimal", delta: "decimal per 1.00 move in the underlying" },
         // What each contract's `iv` and `impliedVolatility` are, so neither is read as the other.
-        fields: OPTION_VOLATILITY_FIELDS,
+        fields: marked ? MARKED_OPTION_FIELDS : OPTION_VOLATILITY_FIELDS,
         // What `iv` and `delta` on each contract are valued from; the provider's own impliedVolatility is left as sent.
-        model: {
-          spot: basisFields.spot, spotBasis: basisFields.spotBasis, spotAsOf: basisFields.spotAsOf,
-          valuationTime: modelSpot ? new Date(modelSpot.valuationTime).toISOString() : null,
-          dividendYield: inputs.dividendYield ?? null, rate: OPTION_MODEL_RATE,
-        },
+        model: marked
+          ? { venue: chain.venue ?? null, marks: "venue", rate: chain.rate ?? 0, basis: "the expiry's forward", coin }
+          : {
+            spot: basisFields.spot, spotBasis: basisFields.spotBasis, spotAsOf: basisFields.spotAsOf,
+            valuationTime: modelSpot ? new Date(modelSpot.valuationTime).toISOString() : null,
+            dividendYield: inputs.dividendYield ?? null, rate: OPTION_MODEL_RATE,
+          },
         openInterest: { asOf: basisFields.openInterestAsOf, listedAsOf: basis.openInterest?.listedDate ?? null,
           compared: basis.openInterest?.compared ?? 0, matched: basis.openInterest?.matched ?? 0 },
       },
       ...(warnings.length > 0 ? { warnings } : {}),
       freshness,
     }, {
-      heading: listingHeading(identity),
+      // Options a venue other than the US exchanges lists (Deribit's) are headed by that venue, not the coin's board.
+      heading: chain.venue ? `${cliStyles.bold(identity.name || identity.symbol)}${cliStyles.muted(`  ·  ${chain.venue}`)}` : listingHeading(identity),
       rows: (data: OptionsChain) => optionRows(data).map((row) => ({ ...row, ...basisFields })),
       // Choosing an expiry needs the list; once one is chosen the table is that expiry.
       summary: (data: OptionsChain) => expirationDate == null ? formatExpiryList(data.expirationDates) : "",
       empty: `No option contracts for ${listingTitle(identity)}.`,
-      ...(contractCount > 0 ? { footnote: optionsBasisFootnote(basis) } : {}),
+      ...(contractCount > 0 ? { footnote: optionsBasisFootnote(basis, chain) } : {}),
       exportIdentity: { symbolOrSeries: listing.key, currencyOrUnit: currency, interval: OPTIONS_EXPORT_INTERVAL },
       // Exports state each decimal's unit in its header and end every row with the spot and dates it is as of.
       columns: [
@@ -2763,6 +2828,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         { key: "bid", header: "Bid" },
         { key: "ask", header: "Ask" },
         { key: "iv", header: "IV (annualized decimal)" },
+        { key: "ivSource", header: "IV source" },
         { key: "delta", header: "Delta (decimal)" },
         { key: "volume", header: "Vol" },
         { key: "openInterest", header: "OI" },
@@ -2770,8 +2836,34 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         { key: "spotBasis", header: "Spot basis" },
         { key: "spotAsOf", header: "Spot as of" },
         { key: "openInterestAsOf", header: "OI as of" },
+        // A venue's marks and its coin prices (Deribit's BTC and ETH options).
+        ...(marked ? [
+          { key: "mark", header: "Mark (USD)" }, { key: "gamma", header: "Gamma (per 1.00)" },
+          { key: "vega", header: "Vega (USD per vol point)" }, { key: "theta", header: "Theta (USD per day)" },
+          { key: "forward", header: "Forward" }, { key: "expiresAt", header: "Settles" },
+        ] : []),
+        ...(coin ? [
+          { key: "coinBid", header: `Bid (${coin})` }, { key: "coinAsk", header: `Ask (${coin})` },
+          { key: "coinMark", header: `Mark (${coin})` }, { key: "coinLast", header: `Last (${coin})` },
+        ] : []),
       ],
-      textColumns: [
+      // A coin's options are quoted in the coin: its bid, ask and mark, then the mark in dollars and the venue's greeks.
+      textColumns: coin ? [
+        { key: "side", header: "Side" },
+        { key: "contract", header: "Contract", shrink: false },
+        { key: "strike", header: "Strike", align: "right" },
+        { key: "coinBid", header: `Bid ${coin}`, align: "right", format: formatCoinPremiumCell },
+        { key: "coinAsk", header: `Ask ${coin}`, align: "right", format: formatCoinPremiumCell },
+        { key: "coinMark", header: `Mark ${coin}`, align: "right", format: formatCoinPremiumCell },
+        { key: "mark", header: "Mark $", align: "right", format: formatOptionDollarCell },
+        { key: "iv", header: "IV", align: "right", format: (value, row) => formatOptionIvCell(value, row) },
+        { key: "delta", header: "Delta", align: "right", format: formatOptionDeltaCell },
+        { key: "gamma", header: "Gamma", align: "right", format: formatOptionGammaCell, optional: true, dropPriority: 3 },
+        { key: "vega", header: "Vega $", align: "right", format: formatOptionDollarCell, optional: true, dropPriority: 2 },
+        { key: "theta", header: "Theta $", align: "right", format: formatOptionDollarCell, optional: true, dropPriority: 2 },
+        { key: "volume", header: "Vol", align: "right", format: formatCountCell, optional: true, dropPriority: 1 },
+        { key: "openInterest", header: "OI", align: "right", format: formatCountCell, optional: true, dropPriority: 1 },
+      ] : [
         { key: "side", header: "Side" },
         { key: "contract", header: "Contract", shrink: false },
         // The contract symbol already carries the date, so this goes first when the table is narrow.
@@ -2780,7 +2872,7 @@ async function runOptions(rawArgs: string[], ctx: Parameters<CliCommandDef["exec
         { key: "last", header: "Last", align: "right" },
         { key: "bid", header: "Bid", align: "right", format: (_value, row) => formatOptionQuoteCell(row, "bid") },
         { key: "ask", header: "Ask", align: "right", format: (_value, row) => formatOptionQuoteCell(row, "ask") },
-        { key: "iv", header: "IV", align: "right", format: formatOptionIvCell },
+        { key: "iv", header: "IV", align: "right", format: (value, row) => formatOptionIvCell(value, row) },
         { key: "delta", header: "Delta", align: "right", format: formatOptionDeltaCell },
         { key: "volume", header: "Vol", align: "right", format: formatCountCell, optional: true, dropPriority: 1 },
         { key: "openInterest", header: "OI", align: "right", format: formatCountCell, optional: true, dropPriority: 1 },
@@ -3204,7 +3296,7 @@ export const marketDataCliCommands: BuiltinCliCommandDef[] = [
       usage: [OPTIONS_USAGE, LEAPS_USAGE],
       options: [
         {
-          flags: `--expiration <${OPTION_EXPIRATION_PLACEHOLDER}>`,
+          flags: `--expiration <${OPTION_EXPIRATION_PLACEHOLDER}>, --expiry <${OPTION_EXPIRATION_PLACEHOLDER}>`,
           description: "Expiration as a date (2028-01-21) or Unix seconds; defaults to the nearest one, and lists the others. With --leaps: rank that expiry alone",
         },
         EXCHANGE_OPTION,