gloomberb 0.16.4 → 0.16.6

package/src/api-client/data.ts

@@ -5,7 +5,8 @@ import type { CatalystResponse, CatalystDetail, CatalystFilters, CatalystStatus,
 import type { KpisPayload, GuidancePayload, KpiQueryOptions } from "./company-kpis";
 import { companyDisclosurePath } from "./company-kpis";
 import type { PowerBoard, PowerDetail, PowerFilter, PowerHistory } from "./power";
-import type { PerpBoardPayload, PerpHistoryPayload, PerpRankingsPayload, PerpBoardQuery, PerpHistoryQuery, PerpMarketPayload } from "./perps";
+import type { PerpBoardPayload, PerpEquitiesPayload, PerpEquityListing, PerpHistoryPayload, PerpRankingsPayload, PerpBoardQuery, PerpHistoryQuery,
+  PerpMarketPayload } from "./perps";
 import type { ExposureRequest, ExposurePayload, ExposureScenario } from "./exposure";
 import type { SupplyChainPayload, SupplyOptions } from "./supply-chain";
 import { supplyGraphQuery, type GraphOptions, type GraphPayload } from "./supply-chain-graph";
@@ -23,18 +24,20 @@ import {
   type InsolvencyNoticesParams,
 } from "./distress";
 import type { IpoCalendarParams, IpoCalendarPayload } from "./ipo";
+import type { TickerChanges } from "../types/ticker-changes";
 import type { CryptoMarketsPayload } from "./crypto-markets";
 import type { CentralBankRatesPayload } from "./central-bank-rates";
 import type { EstimateRevisionsPayload } from "./estimate-revisions";
 import type { MoneyMarketsPayload } from "./money-markets";
-import type { CloudCurveId, CloudCurveView, CloudWorldCurves } from "./yield-curves";
+import type { CloudCurveHistory, CloudCurveId, CloudCurveView, CloudWorldCurves } from "./yield-curves";
 import type { CdxBoardPayload, CloudCreditBoardParams, SovrBoardPayload } from "./credit-boards";
 import type { ShortVolumePayload, ShortVolumeScope } from "./short-volume";
 import type { BeneficialOwnersPayload, CloudBeneficialOwnersParams } from "./beneficial-owners";
 import type { SocialMentionDayPosts, SocialMentionsPayload, SocialMentionsRange } from "./social-mentions";
-import type { FuturesCurveAsOfPayload, FuturesCurvePayload } from "./futures-curve";
+import type { FuturesContractTermsPayload, FuturesCurveAsOfPayload, FuturesCurvePayload } from "./futures-curve";
 import type { CotBoardPayload, CotContractPayload, CotFamily, CotClass } from "./cot";
 import type { DoeBoardPayload } from "./doe";
+import type { CarbonBoard, CarbonHistory, EuropePowerBoard, EuropePowerHistory } from "./europe-energy";
 import type { GpuBoardPayload, GpuEventsPayload, GpuHistoryPayload, GpuHistoryQuery } from "./gpu";
 import type { CpiBoardPayload } from "./cpi";
 import type { TapeSnapshot } from "./tape";
@@ -85,6 +88,7 @@ import {
   cloudMarketSearchPath,
   cloudMarketSymbolPath,
   cloudNewsPath,
+  cloudNewsSearchPath,
   cloudOptionsChainPath,
   cloudSavedSearchPath,
   cloudSavedSearchesPath,
@@ -109,6 +113,7 @@ import type {
   CloudAnalystResearchPayload,
   CloudShortInterestPayload,
   CloudCdsHistoryResponse,
+  CloudCdsLevelsResponse,
   CloudCdsResponse,
   CloudCongressHousePayload,
   CloudEarningsCallListPayload,
@@ -372,6 +377,17 @@ export class CloudDataApi {
     );
   }
 
+  /** Where the issuer that held a US symbol trades now, or what the symbol's holder was called before. */
+  async getCloudTickerChanges(
+    symbol: string,
+    options: { signal?: AbortSignal } = {},
+  ): Promise<CloudMarketResponse<TickerChanges>> {
+    return this.request<CloudMarketResponse<TickerChanges>>(
+      `/market/ticker-changes?${new URLSearchParams({ symbol: symbol.trim().toUpperCase() })}`,
+      options.signal ? { signal: options.signal } : undefined,
+    );
+  }
+
   async getCloudHistory(
     symbol: string,
     exchange: string,
@@ -517,6 +533,9 @@ export class CloudDataApi {
     const query = exchange === undefined ? "" : `?${new URLSearchParams({ identity: "listing", exchange })}`;
     return this.request(`/cloud/perps/equity/${encodeURIComponent(symbol)}${query}`);
   }
+  async getCloudPerpsEquities(listings: readonly PerpEquityListing[]): Promise<PerpEquitiesPayload> {
+    return this.request("/cloud/perps/equities", { method: "POST", body: JSON.stringify({ listings }) });
+  }
   async getCloudPerpsMarket(marketId: string): Promise<PerpMarketPayload> { return this.request(`/cloud/perps/market?${new URLSearchParams({ marketId })}`); }
 
   async analyzeCloudExposure(request: ExposureRequest): Promise<ExposurePayload> {
@@ -576,6 +595,31 @@ export class CloudDataApi {
     return this.request<PowerDetail>(`/cloud/power/projects/${encodeURIComponent(id)}?${params}`, { signal });
   }
 
+  /** European day-ahead power prices by country, latest day first per market. */
+  async getCloudEuropePower(): Promise<EuropePowerBoard> {
+    return this.request<EuropePowerBoard>("/cloud/europe-energy/power", { signal: AbortSignal.timeout(30_000) });
+  }
+
+  /** One market's daily day-ahead prices from `from` (all of them without one), oldest first. */
+  async getCloudEuropePowerHistory(code: string, from?: string | null): Promise<EuropePowerHistory> {
+    const query = from ? `?${new URLSearchParams({ from })}` : "";
+    return this.request<EuropePowerHistory>(
+      `/cloud/europe-energy/power/${encodeURIComponent(code)}/history${query}`,
+      { signal: AbortSignal.timeout(30_000) },
+    );
+  }
+
+  /** The EU carbon allowance (EUA) auction price as of its latest auction day, with the latest auctions. */
+  async getCloudEuropeCarbon(): Promise<CarbonBoard> {
+    return this.request<CarbonBoard>("/cloud/europe-energy/carbon", { signal: AbortSignal.timeout(30_000) });
+  }
+
+  /** The daily EUA auction price from `from` (every auction day since 2020 without one), oldest first. */
+  async getCloudEuropeCarbonHistory(from?: string | null): Promise<CarbonHistory> {
+    const query = from ? `?${new URLSearchParams({ from })}` : "";
+    return this.request<CarbonHistory>(`/cloud/europe-energy/carbon/history${query}`, { signal: AbortSignal.timeout(30_000) });
+  }
+
   async getCloudGpuBoard(): Promise<GpuBoardPayload> {
     return this.request<GpuBoardPayload>("/cloud/gpu/board");
   }
@@ -608,6 +652,15 @@ export class CloudDataApi {
     return this.request<CloudCurveView>(`/cloud/econ/curves/${encodeURIComponent(curve)}${query}`, { signal: AbortSignal.timeout(30_000) });
   }
 
+  /** One tenor of a curve from `from` (all stored sessions without one), oldest first. */
+  async getCloudCurveHistory(curve: CloudCurveId, tenor: string, from?: string | null): Promise<CloudCurveHistory> {
+    const query = new URLSearchParams({ tenor, ...(from ? { from } : {}) });
+    return this.request<CloudCurveHistory>(
+      `/cloud/econ/curves/${encodeURIComponent(curve)}/history?${query}`,
+      { signal: AbortSignal.timeout(30_000) },
+    );
+  }
+
   /** Each market's latest curve and the session before, each on its own date. */
   async getCloudWorldCurves(): Promise<CloudWorldCurves> {
     return this.request<CloudWorldCurves>("/cloud/econ/curves", { signal: AbortSignal.timeout(30_000) });
@@ -703,6 +756,11 @@ export class CloudDataApi {
     return this.request<FuturesCurvePayload>(`/cloud/futures/curve/${encodeURIComponent(root)}`, { signal: AbortSignal.timeout(60_000) });
   }
 
+  /** What a futures symbol (GC=F, GCZ26, CL1) trades: its contract, terms and latest confirmed settlement. */
+  async getCloudFuturesContract(symbol: string): Promise<FuturesContractTermsPayload> {
+    return this.request<FuturesContractTermsPayload>(`/cloud/futures/contract/${encodeURIComponent(symbol)}`, { signal: AbortSignal.timeout(20_000) });
+  }
+
   async getCloudFuturesCurveAsOf(root: string, date: string): Promise<FuturesCurveAsOfPayload> {
     return this.request<FuturesCurveAsOfPayload>(`/cloud/futures/curve/${encodeURIComponent(root)}/as-of/${encodeURIComponent(date)}`,
       { signal: AbortSignal.timeout(30_000) });
@@ -720,6 +778,11 @@ export class CloudDataApi {
     return this.request<CloudCdsHistoryResponse>(cloudCdsHistoryPath(params), { signal: AbortSignal.timeout(30_000) });
   }
 
+  /** Every listed issuer's latest 5Y level in one request. */
+  async getCloudCdsLevels(): Promise<CloudCdsLevelsResponse> {
+    return this.request<CloudCdsLevelsResponse>("/cloud/credit/cds/levels", { signal: AbortSignal.timeout(30_000) });
+  }
+
   async getCloudCdxBoard(params: CloudCreditBoardParams = {}): Promise<CdxBoardPayload> {
     return this.request<CdxBoardPayload>(cloudCreditBoardPath("cdx", params), { signal: AbortSignal.timeout(30_000) });
   }
@@ -926,6 +989,13 @@ export class CloudDataApi {
     return this.request<CloudNewsListResponse>(cloudNewsPath(params));
   }
 
+  async searchCloudNews(
+    query: string,
+    limit?: number,
+  ): Promise<CloudNewsListResponse> {
+    return this.request<CloudNewsListResponse>(cloudNewsSearchPath(query, limit));
+  }
+
   async getCloudNewsStory(storyId: string): Promise<CloudNewsPayload> {
     return this.request<CloudNewsPayload>(
       `/news/${encodeURIComponent(storyId)}`,

package/src/api-client/earnings.ts

@@ -1,3 +1,5 @@
+import type { EarningsDateStatus, EarningsEpsBasis } from "../types/financials";
+
 /** Before the open, during the session, after the close. */
 export type EarningsTiming = "bmo" | "dmh" | "amc";
 
@@ -44,6 +46,8 @@ export interface EarningsReport {
   revenueAnalysts: number | null;
   implied: EarningsImpliedMove | null;
   realized: EarningsRealizedMove | null;
+  /** Whether the date is out, announced or projected; absent from older servers. */
+  dateStatus?: EarningsDateStatus;
 }
 
 export interface EarningsCalendarReport extends EarningsReport {
@@ -61,6 +65,8 @@ export interface EarningsCalendarPayload {
 
 interface EarningsHistoryReport extends EarningsReport {
   revenueActual: number | null;
+  /** Null when the basis cannot be determined; absent from older servers. */
+  epsBasis?: EarningsEpsBasis | null;
 }
 
 export interface EarningsHistoryPayload {

package/src/api-client/europe-energy.ts

@@ -0,0 +1,106 @@
+/** Who publishes the prices; their licence asks for this attribution. */
+interface EuropeEnergySource {
+  name: string;
+  licence: string;
+  url: string;
+}
+
+/** One market's latest day-ahead price and its context, all as of `date`. */
+export interface PowerPriceRow {
+  /** ISO 3166 alpha-2: DE, FR, GB. */
+  code: string;
+  name: string;
+  /** Latest delivery day with a price. */
+  date: string | null;
+  /** EUR/MWh, the day's load-weighted average of the day-ahead auction. */
+  price: number | null;
+  previousDate: string | null;
+  change: number | null;
+  average7: number | null;
+  average30: number | null;
+  yearAgoDate: string | null;
+  yearAgo: number | null;
+  low52w: number | null;
+  high52w: number | null;
+  /** Weekly means over the year to `date`, oldest first. */
+  trail: Array<{ date: string; value: number }>;
+}
+
+export interface EuropePowerBoard {
+  generatedAt: string;
+  status: "available" | "unavailable";
+  market: "day-ahead";
+  unit: "EUR/MWh";
+  source: EuropeEnergySource;
+  /** When the published file was last read, and when its publisher last changed it. */
+  checkedAt: string | null;
+  publishedAt: string | null;
+  gaps: string[];
+  rows: PowerPriceRow[];
+}
+
+export interface EuropePowerHistory {
+  code: string;
+  name: string;
+  market: "day-ahead";
+  unit: "EUR/MWh";
+  source: EuropeEnergySource;
+  /** Oldest first. */
+  points: Array<{ date: string; value: number }>;
+}
+
+/** One EU ETS primary-market auction. Prices in EUR/tCO2, volumes in tCO2. */
+interface CarbonAuction {
+  date: string;
+  auction: string;
+  contract: string;
+  /** successful, cancelled. */
+  status: string;
+  /** EU (common platform), DE, PL, XI (Northern Ireland). */
+  zone: string | null;
+  /** Null when the auction did not clear. */
+  price: number | null;
+  minBid: number | null;
+  maxBid: number | null;
+  meanBid: number | null;
+  medianBid: number | null;
+  volume: number;
+  coverRatio: number | null;
+  bidders: number | null;
+  successfulBidders: number | null;
+  /** An aviation allowance (EUAA) auction, which is not the EUA price. */
+  aviation: boolean;
+}
+
+/** The EUA price as of its latest auction day: the day's cleared auctions, volume-weighted. */
+interface CarbonPriceRow extends Omit<PowerPriceRow, "code"> {
+  code: "EUA";
+  /** tCO2 auctioned that day, and in how many auctions. */
+  volume: number | null;
+  auctions: number | null;
+}
+
+export interface CarbonBoard {
+  generatedAt: string;
+  status: "available" | "unavailable";
+  /** The primary auction clearing price, not a futures settlement. */
+  market: "primary auction";
+  unit: "EUR/tCO2";
+  source: { name: string; url: string };
+  checkedAt: string | null;
+  publishedAt: string | null;
+  gaps: string[];
+  row: CarbonPriceRow;
+  /** Newest first. */
+  auctions: CarbonAuction[];
+}
+
+export interface CarbonHistory {
+  code: "EUA";
+  name: string;
+  market: "primary auction";
+  unit: "EUR/tCO2";
+  source: { name: string; url: string };
+  /** Each auction day's price, oldest first. */
+  points: Array<{ date: string; value: number }>;
+}

package/src/api-client/futures-curve.ts

@@ -1,3 +1,37 @@
+/** What one contract of a root is, from the exchange's rulebook. */
+export interface FuturesContractSpec {
+  /** What a quoted price counts: "USD / troy oz", "US cents / bushel", "index points". */
+  unit: string
+  /** One contract as the exchange words it: "100 troy oz", "$50 x index". */
+  size: string
+  /** US dollars a move of 1.0 in the quoted price makes on one contract. */
+  pointValue: number
+  /** The smallest outright price move, in the quoted unit. */
+  tick: number
+  /** US dollars one tick makes on one contract. */
+  tickValue: number
+  settlement: "physical" | "cash"
+}
+
+/** What a futures symbol trades: the contract behind it, its terms and its latest confirmed settlement. */
+export interface FuturesContractTermsPayload {
+  /** The symbol asked for: GC=F, GCZ26 or CL1. */
+  symbol: string
+  root: string
+  name: string
+  /** The listed contract the symbol prices today (GCZ26 for GC=F); null where it cannot be placed. */
+  contract: string | null
+  contractSymbol: string | null
+  deliveryMonth: string | null
+  spec: FuturesContractSpec | null
+  lastTrade: string | null
+  firstNotice: string | null
+  /** Past first notice: a long can be assigned delivery. */
+  inDelivery: boolean
+  /** The newest exchange settlement confirmed for the contract, with its session. */
+  settlement: { price: number; date: string } | null
+}
+
 /** Gloom Cloud futures prices retain provider denomination and explicit quote units. */
 export interface FuturesContract {
   symbol: string
@@ -17,6 +51,18 @@ export interface FuturesContract {
   samples: number
   historyStart: string | null
   historyEnd: string | null
+  /**
+   * The exchange settlement for the curve's settlementDate; null when none is
+   * confirmed for that session. `price` is the latest trade, never a settlement,
+   * except on a Cboe curve, whose prices are settlements.
+   */
+  settlement?: number | null
+  /** The last trading day. */
+  lastTrade?: string | null
+  /** First notice day of a physically delivered contract; null where there is none. */
+  firstNotice?: string | null
+  /** Past first notice: a long can be assigned delivery. */
+  inDelivery?: boolean
 }
 
 export interface FuturesCurvePayload {
@@ -51,6 +97,10 @@ export interface FuturesCurvePayload {
     state: "contango" | "backwardation" | "flat" | "unavailable"
   }
   gaps: string[]
+  /** The session the contracts' settlements are for; null when none is confirmed. */
+  settlementDate?: string | null
+  /** The root's contract terms; null where they are not listed. */
+  spec?: FuturesContractSpec | null
 }
 
 
@@ -78,6 +128,12 @@ export interface FuturesCurveAsOfPayload {
     /** When the price was made; older than tradeDate when the contract did not trade that day. */
     asOf: string
     stale: boolean
+    /** The price is the exchange settlement for tradeDate; otherwise that session's last trade or, when stale, an earlier price. */
+    settled?: boolean
+    lastTrade?: string | null
+    firstNotice?: string | null
+    inDelivery?: boolean
   }>
   gaps: string[]
+  spec?: FuturesContractSpec | null
 }

package/src/api-client/index.ts

@@ -59,7 +59,7 @@ export type {
 /** Server-side caps for `/assist/command`; enforced here so a 422 is never sent. */
 const ASSIST_QUERY_MAX_LENGTH = 200;
 const ASSIST_COMMAND_LIMIT = 150;
-const ASSIST_ARG_OPTION_LIMIT = 40;
+const ASSIST_ARG_OPTION_LIMIT = 64;
 const ASSIST_ARG_OPTION_VALUE_MAX_LENGTH = 40;
 const ASSIST_ARG_OPTION_LABEL_MAX_LENGTH = 60;
 const ASSIST_REQUEST_TIMEOUT_MS = 6_000;
@@ -643,6 +643,8 @@ class GloomApiClient {
   chatAttachmentsSupported = this.chat.attachmentsSupported.bind(this.chat);
   subscribeChatAttachmentSupport = this.chat.subscribeAttachmentSupport.bind(this.chat);
   editMessage = this.chat.editMessage.bind(this.chat);
+  setChatReaction = this.chat.setReaction.bind(this.chat);
+  subscribeChatReactions = this.chat.subscribeReactions.bind(this.chat);
   connectChannel = this.chat.connectChannel.bind(this.chat);
   subscribeChatNotifications = this.chat.subscribeNotifications.bind(this.chat);
   subscribeChatPresence = this.chat.subscribePresence.bind(this.chat);
@@ -738,6 +740,7 @@ class GloomApiClient {
   getCloudShortInterest = this.data.getCloudShortInterest.bind(this.data);
   getCloudAnalystResearch = this.data.getCloudAnalystResearch.bind(this.data);
   getCloudCorporateActions = this.data.getCloudCorporateActions.bind(this.data);
+  getCloudTickerChanges = this.data.getCloudTickerChanges.bind(this.data);
   getCloudHistory = this.data.getCloudHistory.bind(this.data);
   getCloudExchangeRate = this.data.getCloudExchangeRate.bind(this.data);
   getCloudEconomicCalendar = this.data.getCloudEconomicCalendar.bind(this.data);
@@ -775,6 +778,7 @@ class GloomApiClient {
   getCloudSocialMentionPosts = this.data.getCloudSocialMentionPosts.bind(this.data);
   getCloudFuturesCurve = this.data.getCloudFuturesCurve.bind(this.data);
   getCloudFuturesCurveAsOf = this.data.getCloudFuturesCurveAsOf.bind(this.data);
+  getCloudFuturesContract = this.data.getCloudFuturesContract.bind(this.data);
   getCloudRatePath = this.data.getCloudRatePath.bind(this.data);
   getCloudShiller = this.data.getCloudShiller.bind(this.data);
   getCloudCotBoard = this.data.getCloudCotBoard.bind(this.data);
@@ -795,6 +799,7 @@ class GloomApiClient {
   getCloudPerpsRankings = this.data.getCloudPerpsRankings.bind(this.data);
   getCloudPerpsCompare = this.data.getCloudPerpsCompare.bind(this.data);
   getCloudPerpsEquity = this.data.getCloudPerpsEquity.bind(this.data);
+  getCloudPerpsEquities = this.data.getCloudPerpsEquities.bind(this.data);
   getCloudPerpsMarket = this.data.getCloudPerpsMarket.bind(this.data);
   analyzeCloudExposure = this.data.analyzeCloudExposure.bind(this.data);
   getCloudExposureScenarios = this.data.getCloudExposureScenarios.bind(this.data);
@@ -808,6 +813,10 @@ class GloomApiClient {
   getCloudPowerBoard = this.data.getCloudPowerBoard.bind(this.data);
   getCloudPowerHistory = this.data.getCloudPowerHistory.bind(this.data);
   getCloudPowerProject = this.data.getCloudPowerProject.bind(this.data);
+  getCloudEuropePower = this.data.getCloudEuropePower.bind(this.data);
+  getCloudEuropePowerHistory = this.data.getCloudEuropePowerHistory.bind(this.data);
+  getCloudEuropeCarbon = this.data.getCloudEuropeCarbon.bind(this.data);
+  getCloudEuropeCarbonHistory = this.data.getCloudEuropeCarbonHistory.bind(this.data);
   getCloudGpuBoard = this.data.getCloudGpuBoard.bind(this.data);
   getCloudGpuHistory = this.data.getCloudGpuHistory.bind(this.data);
   getCloudGpuEvents = this.data.getCloudGpuEvents.bind(this.data);
@@ -815,9 +824,11 @@ class GloomApiClient {
   getCloudTape = this.data.getCloudTape.bind(this.data);
   getCloudYieldCurve = this.data.getCloudYieldCurve.bind(this.data);
   getCloudCurve = this.data.getCloudCurve.bind(this.data);
+  getCloudCurveHistory = this.data.getCloudCurveHistory.bind(this.data);
   getCloudWorldCurves = this.data.getCloudWorldCurves.bind(this.data);
   getCloudCds = this.data.getCloudCds.bind(this.data);
   getCloudCdsHistory = this.data.getCloudCdsHistory.bind(this.data);
+  getCloudCdsLevels = this.data.getCloudCdsLevels.bind(this.data);
   getCloudCdxBoard = this.data.getCloudCdxBoard.bind(this.data);
   getCloudSovrBoard = this.data.getCloudSovrBoard.bind(this.data);
   getCloudCongressHouse = this.data.getCloudCongressHouse.bind(this.data);
@@ -843,6 +854,7 @@ class GloomApiClient {
   updateCloudSavedSearch = this.data.updateCloudSavedSearch.bind(this.data);
   deleteCloudSavedSearch = this.data.deleteCloudSavedSearch.bind(this.data);
   getCloudNews = this.data.getCloudNews.bind(this.data);
+  searchCloudNews = this.data.searchCloudNews.bind(this.data);
   getCloudNewsStory = this.data.getCloudNewsStory.bind(this.data);
   getCloudTickerTweets = this.data.getCloudTickerTweets.bind(this.data);
   searchCloudTweets = this.data.searchCloudTweets.bind(this.data);

package/src/api-client/market-discovery.ts

@@ -1,4 +1,4 @@
-import type { CloudCorporateActionsPayload, CloudQuotePayload } from "./types";
+import type { CloudCorporateActionsPayload, CloudMoverSessionFields, CloudQuotePayload } from "./types";
 
 export interface ScreenerQuote {
   symbol: string;
@@ -19,6 +19,8 @@ export interface ScreenerQuote {
   lastUpdated?: number;
   /** Session-fixed, so the price column reads its decimals from it rather than from each tick. */
   previousClose?: number;
+  /** The quote's sessions beside the live print the list ranks by, when the server sends them. */
+  sessions?: CloudMoverSessionFields;
 }
 
 
@@ -63,6 +65,13 @@ export interface MarketHeatmapResult {
   session?: "REGULAR" | "PRE" | "POST" | "CLOSED" | null;
   /** The completed regular session every stored tile describes outside the regular session, as a New York date; null while it trades. */
   regularSessionDate?: string | null;
+  /**
+   * When that session closed, in epoch milliseconds: its real close from the
+   * exchange calendar, so an early close reads 13:00 New York. Null while a
+   * session trades and when the snapshot names no session; an older server
+   * leaves it out.
+   */
+  regularSessionClosedAt?: number | null;
   assets: MarketHeatmapAsset[];
 }
 
@@ -77,7 +86,10 @@ export interface MarketMoversPayload {
 export interface DividendSummary {
   trailingAnnualDividendRate: number | null;
   trailingAnnualDividendYield: number | null;
+  /** The indicated annual rate fundamentals serve: the latest regular distribution annualized. */
   forwardAnnualDividendRate: number | null;
+  /** The ex-date of the distribution that rate annualizes, YYYY-MM-DD. */
+  forwardRateAsOf?: string | null;
   payoutRatio: number | null;
   exDividendDate: number | null;
   dividendDate: number | null;

package/src/api-client/normalizers.ts

@@ -6,6 +6,8 @@ import type {
   ChatMessage,
   ChatMessageOrigin,
   ChatNotification,
+  ChatReaction,
+  ChatReactionUser,
   ChatStateResponse,
   CloudSavedSearch,
   CloudSearchHit,
@@ -98,6 +100,7 @@ export function normalizeChatMessage(message: ChatMessage): ChatMessage {
       : {}),
   };
   if ("attachments" in message) normalized.attachments = normalizeChatAttachments(message.attachments);
+  if ("reactions" in message) normalized.reactions = normalizeChatReactions(message.reactions);
   if (message.origin !== undefined && !CHAT_MESSAGE_ORIGINS.includes(message.origin)) delete normalized.origin;
   if (message.attachmentReview !== "pending" && message.attachmentReview !== "failed") {
     delete normalized.attachmentReview;
@@ -117,6 +120,35 @@ export function normalizeChatDiscordLink(value: unknown): ChatDiscordLink {
   };
 }
 
+/** Reactions as the server sent them, dropping anything malformed. */
+export function normalizeChatReactions(value: unknown): ChatReaction[] {
+  if (!Array.isArray(value)) return [];
+  const reactions: ChatReaction[] = [];
+  for (const entry of value) {
+    if (!entry || typeof entry !== "object") continue;
+    const raw = entry as Record<string, unknown>;
+    if (typeof raw.emoji !== "string" || !raw.emoji) continue;
+    const count = typeof raw.count === "number" && Number.isFinite(raw.count) ? Math.max(0, Math.floor(raw.count)) : 0;
+    if (count === 0) continue;
+    const users = Array.isArray(raw.users)
+      ? raw.users.flatMap((user): ChatReactionUser[] => {
+        if (!user || typeof user !== "object") return [];
+        const candidate = user as Record<string, unknown>;
+        if (typeof candidate.id !== "string") return [];
+        const accountType = candidate.accountType;
+        return [{
+          id: candidate.id,
+          username: typeof candidate.username === "string" ? candidate.username : null,
+          displayName: typeof candidate.displayName === "string" ? candidate.displayName : "User",
+          ...(accountType === "human" || accountType === "managed_llm" || accountType === "discord" ? { accountType } : {}),
+        }];
+      })
+      : [];
+    reactions.push({ emoji: raw.emoji, count, me: raw.me === true, users });
+  }
+  return reactions;
+}
+
 export function normalizeChatMessages(messages: ChatMessage[]): ChatMessage[] {
   return messages.map((message) => normalizeChatMessage(message));
 }

package/src/api-client/paths.ts

@@ -576,6 +576,13 @@ export function cloudNewsPath(params: CloudNewsParams = {}): string {
   return appendQuery("/news", search);
 }
 
+/** Stories whose headline, summary or publisher matches the text, best match first; the service takes at most 100. */
+export function cloudNewsSearchPath(query: string, limit?: number): string {
+  const search = new URLSearchParams({ query });
+  if (limit != null) search.set("limit", String(limit));
+  return appendQuery("/news/search", search);
+}
+
 export function cloudTickerTweetsPath(params: CloudTickerTweetsParams): string {
   const search = new URLSearchParams({ ticker: params.ticker });
   if (params.limit != null) search.set("limit", String(params.limit));

package/src/api-client/perps.ts

@@ -147,6 +147,14 @@ export interface PerpBoardPayload {
   access: "pro" | "preview"; sources?: unknown[];
 }
 export interface PerpEquityListing { symbol: string; exchange: string }
+/**
+ * The batch lookup a watchlist or portfolio makes: one entry per requested listing, in its order, with the contract
+ * the single equity lookup would list first, or none. `listing` is null when the server cannot read the listing.
+ */
+export interface PerpEquitiesPayload {
+  status: string; asOf: string | null; access: "pro" | "preview"; locked: number;
+  results: { listing: PerpEquityListing | null; market: PerpBoardRow | null }[];
+}
 export interface PerpHistoryPayload {
   status: string; marketId: string; rows: PerpHistoryPoint[]; funding: PerpFunding[]; candles: PerpCandle[];
   /** Absent from servers older than the long/short series: read as empty. */

package/src/api-client/request.ts

@@ -408,8 +408,15 @@ export class CloudApiRequestTransport {
     // Crash reports, usage counts and command-search reports are background
     // traffic: a rate-limited, timed-out or missing one must not show up as a
     // Cloud outage in the connections pane. Nor must the map's probe for geo
-    // layers, which a server without them answers with 404.
-    if (path.startsWith("/telemetry/") || path === "/assist/searches" || path === "/cloud/geo/layers") return request();
+    // layers, which a server without them answers with 404, or a ticker
+    // change lookup: a note beside a quote, never one of the refused market
+    // requests a lookup of many symbols waits out and retries.
+    if (
+      path.startsWith("/telemetry/")
+      || path === "/assist/searches"
+      || path === "/cloud/geo/layers"
+      || path.startsWith("/market/ticker-changes?")
+    ) return request();
     return this.connectionHealth.track(
       GLOOM_CLOUD_HTTP_CONNECTION_ID,
       operation,

package/src/api-client/research-activity.ts

@@ -6,6 +6,9 @@ import { createWallExperimentSession, type WallExperiment, type WallExperimentCo
 import { createUpgradeExperimentSession, UPGRADE_PERSONALIZED, type UpgradeExperimentContext, type UpgradePersonalizedVariant } from "./upgrade-experiment";
 import { hasProAccess } from "./plan-rules";
 import { withDeadline } from "../utils/async-deadline";
+import { browserDoNotTrack } from "../telemetry/crash-reports-dom";
+import { currentTelemetryConfig } from "../telemetry/live-config";
+import { usageTelemetryAllowed } from "../telemetry/usage-counts";
 
 export type ResearchActivity =
   | "workspace_opened"
@@ -234,12 +237,7 @@ function stripHandoffParams(url: URL): void {
 /** Hosted web analytics only. Native local use never creates an identifier. */
 export function initializeBrowserResearchActivity(): void {
   try {
-    if (
-      navigator.doNotTrack === "1" ||
-      (navigator as Navigator & { globalPrivacyControl?: boolean })
-        .globalPrivacyControl
-    )
-      return;
+    if (!researchTelemetryAllowed()) return;
     const url = new URL(location.href);
     const incoming = readHandoffId(url);
     const stored = localStorage.getItem(ANONYMOUS_ID_STORAGE_KEY);
@@ -269,6 +267,7 @@ export function initializeBrowserResearchActivity(): void {
  */
 export function initializeDesktopResearchActivity(storage: StorageLike = localStorage): void {
   try {
+    if (!researchTelemetryAllowed()) return;
     const stored = storage.getItem(ANONYMOUS_ID_STORAGE_KEY);
     anonymousId = stored && ANONYMOUS_ID.test(stored) ? stored : undefined;
     attribution = readStoredAttribution(storage.getItem(ATTRIBUTION_STORAGE_KEY));
@@ -278,6 +277,7 @@ export function initializeDesktopResearchActivity(storage: StorageLike = localSt
 }
 
 export function adoptDesktopHandoff(href: string, storage: StorageLike = localStorage, now = Date.now()): boolean {
+  if (!researchTelemetryAllowed()) return false;
   if (!carriesHandoff(href)) return false;
   try {
     const url = new URL(href);
@@ -369,6 +369,7 @@ export function recordResearchActivity(
   tab?: string,
   { desks, placement: rawPlacement, teaser_kind, cta }: ResearchActivityDetails = {},
 ): void {
+  if (!researchTelemetryAllowed()) return;
   const target = getCurrentPluginTarget();
   const user = apiClient.getCurrentUser();
   const wallEvent = event === "wall_viewed" || event === "wall_cta_clicked";
@@ -451,6 +452,7 @@ function webExperimentAttribution(): { experiments?: string } {
  * Privacy Control) and not driven by automation are asked. See web-experiments.ts.
  */
 export function exposeWebExperiment(experiment: string): Promise<string | null> {
+  if (!researchTelemetryAllowed()) return Promise.resolve(null);
   if (getCurrentPluginTarget() !== "web") return Promise.resolve(null);
   try {
     return exposeExperiment(experiment, {
@@ -473,11 +475,13 @@ export function exposeWebExperiment(experiment: string): Promise<string | null>
   }
 }
 
+/** Research milestones, attribution and exposures share the Usage off switch. */
+function researchTelemetryAllowed(): boolean {
+  return usageTelemetryAllowed(currentTelemetryConfig(undefined)) && !browserDoNotTrack();
+}
+
 function wallPrivacyBlocked(): boolean {
-  if (typeof navigator === "undefined") return false;
-  return navigator.doNotTrack === "1"
-    || (navigator as Navigator & { globalPrivacyControl?: boolean }).globalPrivacyControl === true
-    || navigator.webdriver === true;
+  return !researchTelemetryAllowed() || (typeof navigator !== "undefined" && navigator.webdriver === true);
 }
 
 function wallExperimentContext(): WallExperimentContext {
@@ -568,6 +572,7 @@ export function recordWallCtaClicked(placement: string, cta: "login" | "signup")
 export function researchUpgradeUrl(returnTo?: string): string {
   const url = new URL("https://gloom.sh/cloud?upgrade=pro");
   if (returnTo) url.searchParams.set("returnTo", returnTo);
+  if (!researchTelemetryAllowed()) return url.href;
   if (anonymousId) url.searchParams.set(HANDOFF_ID_KEY, anonymousId);
   for (const [key, value] of Object.entries(attribution)) {
     if (/^(utm_(source|medium|campaign|content|term)|twclid)$/.test(key))