gloomberb 0.11.2 → 0.12.0

package/src/plugins/ibkr/gateway/contracts.ts

@@ -1,132 +0,0 @@
-import {
-  OptionType,
-  SecType,
-  type Contract,
-  type ContractDescription,
-  type ContractDetails,
-} from "@stoqey/ib";
-import type { BrokerContractRef, InstrumentSearchResult } from "../../../types/instrument";
-
-export function buildInstrumentSearchKey(result: InstrumentSearchResult): string {
-  return `${result.symbol}|${result.exchange}|${result.type}`;
-}
-
-export function contractToBrokerRef(
-  contract: Contract,
-  brokerInstanceId: string | undefined,
-): BrokerContractRef {
-  return {
-    brokerId: "ibkr",
-    brokerInstanceId,
-    conId: contract.conId,
-    symbol: contract.symbol || "",
-    localSymbol: contract.localSymbol,
-    secType: contract.secType,
-    exchange: contract.exchange,
-    primaryExchange: contract.primaryExch,
-    currency: contract.currency,
-    lastTradeDateOrContractMonth: contract.lastTradeDateOrContractMonth,
-    right: contract.right === OptionType.Call ? "C" : contract.right === OptionType.Put ? "P" : undefined,
-    strike: contract.strike,
-    multiplier: contract.multiplier != null ? String(contract.multiplier) : undefined,
-    tradingClass: contract.tradingClass,
-  };
-}
-
-export function brokerRefToContract(ref: BrokerContractRef): Contract {
-  return {
-    conId: ref.conId,
-    symbol: ref.symbol,
-    localSymbol: ref.localSymbol,
-    secType: (ref.secType as SecType | undefined) ?? SecType.STK,
-    exchange: "SMART",
-    primaryExch: ref.primaryExchange || ref.exchange || undefined,
-    currency: ref.currency || "USD",
-    lastTradeDateOrContractMonth: ref.lastTradeDateOrContractMonth,
-    right: ref.right === "C" ? OptionType.Call : ref.right === "P" ? OptionType.Put : undefined,
-    strike: ref.strike,
-    multiplier: ref.multiplier ? parseFloat(ref.multiplier) : undefined,
-    tradingClass: ref.tradingClass,
-  };
-}
-
-export function contractDescriptionToSearchResult(
-  description: ContractDescription,
-  brokerInstanceId: string | undefined,
-): InstrumentSearchResult | null {
-  const contract = description.contract;
-  if (!contract?.symbol) return null;
-  return {
-    providerId: "ibkr",
-    brokerInstanceId,
-    symbol: contract.localSymbol || contract.symbol,
-    name: contract.description || contract.symbol,
-    exchange: contract.primaryExch || contract.exchange || "",
-    type: contract.secType || "",
-    currency: contract.currency,
-    primaryExchange: contract.primaryExch,
-    brokerContract: contractToBrokerRef(contract, brokerInstanceId),
-  };
-}
-
-export function contractDetailsToSearchResult(
-  detail: ContractDetails,
-  fallbackSymbol: string,
-  brokerInstanceId: string | undefined,
-): InstrumentSearchResult {
-  const contract = detail.contract;
-  return {
-    providerId: "ibkr",
-    brokerInstanceId,
-    symbol: contract.localSymbol || contract.symbol || fallbackSymbol,
-    name: detail.longName || detail.marketName || contract.description || contract.symbol || fallbackSymbol,
-    exchange: contract.primaryExch || contract.exchange || "",
-    type: contract.secType || "",
-    currency: contract.currency,
-    primaryExchange: contract.primaryExch,
-    brokerContract: contractToBrokerRef(contract, brokerInstanceId),
-  };
-}
-
-export function findExactSymbolMatch(
-  results: InstrumentSearchResult[],
-  ticker: string,
-): InstrumentSearchResult | undefined {
-  const upperTicker = ticker.toUpperCase();
-  return results.find((result) => {
-    const symbol = result.symbol.toUpperCase();
-    return symbol === upperTicker || symbol === ticker;
-  });
-}
-
-export function buildDirectContractCandidates(query: string): Contract[] {
-  const trimmed = query.trim();
-  if (!trimmed) return [];
-
-  const candidates: Contract[] = [];
-  const optionLike = /^\S+\s+\d{6}[CP]\d{8}$/i.test(trimmed);
-
-  if (optionLike) {
-    candidates.push({
-      localSymbol: trimmed,
-      secType: SecType.OPT,
-      exchange: "SMART",
-    });
-  }
-
-  candidates.push({
-    localSymbol: trimmed,
-    exchange: "SMART",
-  });
-
-  return candidates;
-}
-
-export function buildFallbackStockContract(ticker: string, exchange: string): Contract {
-  return {
-    symbol: ticker,
-    exchange: exchange || "SMART",
-    currency: "USD",
-    secType: SecType.STK,
-  };
-}

package/src/plugins/ibkr/gateway/fundamentals.ts

@@ -1,83 +0,0 @@
-import type { Contract, IBApiNext } from "@stoqey/ib";
-import type { TimeRange } from "../../../time-series/range";
-import type { Quote, PricePoint, TickerFinancials } from "../../../types/financials";
-import type { BrokerContractRef } from "../../../types/instrument";
-import { parseFinStatements, parseReportSnapshot } from "../fundamental-parser";
-import { IBKR_DATA_TIMEOUT, withTimeout } from "./timeouts";
-
-export interface IbkrTickerFinancialsContext {
-  resolveContract(ticker: string, exchange: string, instrument: BrokerContractRef | null): Promise<Contract>;
-  getQuote(
-    ticker: string,
-    exchange: string,
-    instrument?: BrokerContractRef | null,
-  ): Promise<Quote>;
-  getPriceHistory(
-    ticker: string,
-    exchange: string,
-    range: TimeRange,
-    instrument?: BrokerContractRef | null,
-  ): Promise<PricePoint[]>;
-  fetchFundamentalData(contract: Contract, reportType: string): Promise<string | null>;
-}
-
-export async function fetchIbkrFundamentalData(
-  api: IBApiNext,
-  contract: Contract,
-  reportType: string,
-): Promise<string | null> {
-  try {
-    return await withTimeout(
-      api.getFundamentalData(contract, reportType),
-      IBKR_DATA_TIMEOUT,
-      `getFundamentalData(${reportType})`,
-    );
-  } catch {
-    return null; // Paper account or no Reuters subscription; source fallback handles it.
-  }
-}
-
-export async function loadIbkrTickerFinancials(
-  context: IbkrTickerFinancialsContext,
-  {
-    ticker,
-    exchange,
-    instrument,
-  }: {
-    ticker: string;
-    exchange: string;
-    instrument?: BrokerContractRef | null;
-  },
-): Promise<TickerFinancials> {
-  const contract = await withTimeout(
-    context.resolveContract(ticker, exchange, instrument ?? null),
-    IBKR_DATA_TIMEOUT,
-    "resolveContract",
-  );
-
-  const [quote, priceHistory, snapshotXml, statementsXml] = await Promise.all([
-    context.getQuote(ticker, exchange, instrument),
-    context.getPriceHistory(ticker, exchange, "1Y", instrument),
-    context.fetchFundamentalData(contract, "ReportSnapshot"),
-    context.fetchFundamentalData(contract, "ReportsFinStatements"),
-  ]);
-
-  const fundamentals = snapshotXml ? parseReportSnapshot(snapshotXml) : {};
-  const statements = statementsXml ? parseFinStatements(statementsXml) : { annual: [], quarterly: [] };
-
-  if (priceHistory.length >= 2) {
-    const oldest = priceHistory[0]!.close;
-    const newest = priceHistory[priceHistory.length - 1]!.close;
-    if (oldest > 0) {
-      fundamentals.return1Y = (newest - oldest) / oldest;
-    }
-  }
-
-  return {
-    quote,
-    fundamentals,
-    annualStatements: statements.annual,
-    quarterlyStatements: statements.quarterly,
-    priceHistory,
-  };
-}

package/src/plugins/ibkr/gateway/helpers.ts

@@ -1,33 +0,0 @@
-import { useCallback, useSyncExternalStore } from "react";
-import type { BrokerInstanceConfig } from "../../../types/config";
-import { getGatewayConfig } from "../config";
-import { ibkrGatewayManager } from "./service";
-
-export function useGatewaySnapshot(instanceId?: string) {
-  const subscribe = useCallback(
-    (listener: () => void) => ibkrGatewayManager.subscribe(instanceId, listener),
-    [instanceId],
-  );
-  const getSnapshot = useCallback(
-    () => ibkrGatewayManager.getSnapshot(instanceId),
-    [instanceId],
-  );
-  return useSyncExternalStore(subscribe, getSnapshot);
-}
-
-export function getGatewayRequiredMessage(instanceCount: number) {
-  return instanceCount > 0
-    ? "Choose a Gateway / TWS IBKR profile first."
-    : "Connect a Gateway / TWS IBKR profile first.";
-}
-
-export async function refreshGatewayData(instance: BrokerInstanceConfig): Promise<void> {
-  const gateway = getGatewayConfig(instance.config);
-  const service = ibkrGatewayManager.getService(instance.id);
-  await service.connect(gateway);
-  await Promise.allSettled([
-    service.getAccounts(gateway),
-    service.listOpenOrders(gateway),
-    service.listExecutions(gateway),
-  ]);
-}

package/src/plugins/ibkr/gateway/history-requests.ts

@@ -1,158 +0,0 @@
-import {
-  WhatToShow,
-  type Contract,
-  type ContractDetails,
-  type IBApiNext,
-} from "@stoqey/ib";
-import type { TimeRange } from "../../../time-series/range";
-import type { ManualChartResolution } from "../../../time-series/resolution";
-import type { PricePoint } from "../../../types/financials";
-import type { BrokerContractRef } from "../../../types/instrument";
-import {
-  formatIbkrHistoricalEndDateTime,
-  getIbkrHistoryDuration,
-  ibkrHistoricalBarsToPricePoints,
-  IBKR_GENERIC_BAR_SIZE_MAP,
-  IBKR_HISTORY_PARAMS,
-} from "./history";
-import { IBKR_DATA_TIMEOUT, withTimeout } from "./timeouts";
-import { getIbkrPriceDivisor } from "./price-normalization";
-
-export interface IbkrHistoryRequestContext {
-  api: IBApiNext;
-  resolveContract(ticker: string, exchange: string, instrument: BrokerContractRef | null): Promise<Contract>;
-  getPrimaryContractDetails(contract: Contract): Promise<ContractDetails>;
-  withMarketDataFallback<T>(operation: () => Promise<T>): Promise<T>;
-}
-
-async function resolveHistoryContract(
-  context: IbkrHistoryRequestContext,
-  ticker: string,
-  exchange: string,
-  instrument: BrokerContractRef | null,
-) {
-  const contract = await withTimeout(
-    context.resolveContract(ticker, exchange, instrument),
-    IBKR_DATA_TIMEOUT,
-    "resolveContract",
-  );
-  const detailsPromise = withTimeout(
-    context.getPrimaryContractDetails(contract),
-    IBKR_DATA_TIMEOUT,
-    "getContractDetails",
-  ).catch(() => undefined);
-  return { contract, detailsPromise };
-}
-
-export async function loadIbkrPriceHistory(
-  context: IbkrHistoryRequestContext,
-  {
-    ticker,
-    exchange,
-    range,
-    instrument,
-  }: {
-    ticker: string;
-    exchange: string;
-    range: TimeRange;
-    instrument?: BrokerContractRef | null;
-  },
-): Promise<PricePoint[]> {
-  const { contract, detailsPromise } = await resolveHistoryContract(context, ticker, exchange, instrument ?? null);
-  const params = IBKR_HISTORY_PARAMS[range];
-  const bars = await context.withMarketDataFallback(
-    () => withTimeout(context.api.getHistoricalData(
-      contract,
-      "",
-      params.duration,
-      params.size,
-      WhatToShow.TRADES,
-      1,
-      1,
-    ), IBKR_DATA_TIMEOUT, "getHistoricalData"),
-  );
-  const details = await detailsPromise;
-  const priceDivisor = getIbkrPriceDivisor(contract, details);
-
-  return ibkrHistoricalBarsToPricePoints(bars, priceDivisor);
-}
-
-export async function loadIbkrPriceHistoryForResolution(
-  context: IbkrHistoryRequestContext,
-  {
-    ticker,
-    exchange,
-    bufferRange,
-    resolution,
-    instrument,
-  }: {
-    ticker: string;
-    exchange: string;
-    bufferRange: TimeRange;
-    resolution: ManualChartResolution;
-    instrument?: BrokerContractRef | null;
-  },
-): Promise<PricePoint[]> {
-  const ibkrBarSize = IBKR_GENERIC_BAR_SIZE_MAP[resolution];
-  if (!ibkrBarSize) return [];
-
-  const { contract, detailsPromise } = await resolveHistoryContract(context, ticker, exchange, instrument ?? null);
-  const params = IBKR_HISTORY_PARAMS[bufferRange];
-  const bars = await context.withMarketDataFallback(
-    () => withTimeout(context.api.getHistoricalData(
-      contract,
-      "",
-      params.duration,
-      ibkrBarSize,
-      WhatToShow.TRADES,
-      1,
-      1,
-    ), IBKR_DATA_TIMEOUT, "getHistoricalData"),
-  );
-  const details = await detailsPromise;
-  const priceDivisor = getIbkrPriceDivisor(contract, details);
-
-  return ibkrHistoricalBarsToPricePoints(bars, priceDivisor);
-}
-
-export async function loadIbkrDetailedPriceHistory(
-  context: IbkrHistoryRequestContext,
-  {
-    ticker,
-    exchange,
-    startDate,
-    endDate,
-    barSize,
-    instrument,
-  }: {
-    ticker: string;
-    exchange: string;
-    startDate: Date;
-    endDate: Date;
-    barSize: string;
-    instrument?: BrokerContractRef | null;
-  },
-): Promise<PricePoint[]> {
-  const ibkrBarSize = IBKR_GENERIC_BAR_SIZE_MAP[barSize as ManualChartResolution];
-  if (!ibkrBarSize) return [];
-
-  const { contract, detailsPromise } = await resolveHistoryContract(context, ticker, exchange, instrument ?? null);
-  const endDateTime = formatIbkrHistoricalEndDateTime(endDate);
-  const durationStr = getIbkrHistoryDuration(startDate, endDate);
-
-  const bars = await context.withMarketDataFallback(
-    () => withTimeout(context.api.getHistoricalData(
-      contract,
-      endDateTime,
-      durationStr,
-      ibkrBarSize,
-      WhatToShow.TRADES,
-      1,
-      1,
-    ), IBKR_DATA_TIMEOUT, "getDetailedHistoricalData"),
-  );
-  const details = await detailsPromise;
-  const priceDivisor = getIbkrPriceDivisor(contract, details);
-
-  return ibkrHistoricalBarsToPricePoints(bars, priceDivisor);
-}

package/src/plugins/ibkr/gateway/history.ts

@@ -1,120 +0,0 @@
-import { BarSizeSetting } from "@stoqey/ib";
-import type { TimeRange } from "../../../time-series/range";
-import {
-  normalizeChartResolutionSupport,
-  type ChartResolutionSupport,
-  type ManualChartResolution,
-} from "../../../time-series/resolution";
-import type { PricePoint } from "../../../types/financials";
-import { normalizeIbkrPriceValue } from "./price-normalization";
-
-export interface IbkrHistoricalBar {
-  time?: string | number;
-  open?: number;
-  high?: number;
-  low?: number;
-  close?: number;
-  volume?: number;
-}
-
-export const IBKR_HISTORY_PARAMS: Record<TimeRange, { duration: string; size: BarSizeSetting }> = {
-  "1D": { duration: "1 D", size: BarSizeSetting.MINUTES_FIVE },
-  "1W": { duration: "7 D", size: BarSizeSetting.HOURS_ONE },
-  "1M": { duration: "1 M", size: BarSizeSetting.HOURS_ONE },
-  "3M": { duration: "3 M", size: BarSizeSetting.DAYS_ONE },
-  "6M": { duration: "6 M", size: BarSizeSetting.DAYS_ONE },
-  "1Y": { duration: "1 Y", size: BarSizeSetting.DAYS_ONE },
-  "5Y": { duration: "5 Y", size: BarSizeSetting.WEEKS_ONE },
-  "ALL": { duration: "10 Y", size: BarSizeSetting.MONTHS_ONE },
-};
-
-export const IBKR_RESOLUTION_SUPPORT: ChartResolutionSupport[] = normalizeChartResolutionSupport([
-  { resolution: "1m", maxRange: "1W" },
-  { resolution: "5m", maxRange: "1M" },
-  { resolution: "15m", maxRange: "3M" },
-  { resolution: "30m", maxRange: "6M" },
-  { resolution: "1h", maxRange: "1Y" },
-  { resolution: "1d", maxRange: "ALL" },
-  { resolution: "1wk", maxRange: "ALL" },
-  { resolution: "1mo", maxRange: "ALL" },
-]);
-
-export const IBKR_GENERIC_BAR_SIZE_MAP: Record<string, BarSizeSetting> = {
-  "1m": BarSizeSetting.MINUTES_ONE,
-  "5m": BarSizeSetting.MINUTES_FIVE,
-  "15m": BarSizeSetting.MINUTES_FIFTEEN,
-  "30m": BarSizeSetting.MINUTES_THIRTY,
-  "1h": BarSizeSetting.HOURS_ONE,
-  "1d": BarSizeSetting.DAYS_ONE,
-  "1wk": BarSizeSetting.WEEKS_ONE,
-  "1mo": BarSizeSetting.MONTHS_ONE,
-};
-
-export function getIbkrHistoryCapabilities(): ManualChartResolution[] {
-  return IBKR_RESOLUTION_SUPPORT.map((entry) => entry.resolution);
-}
-
-export function parseIbkrHistoricalBarTime(value: string | number): Date {
-  if (typeof value === "number") {
-    if (!Number.isFinite(value)) return new Date(Number.NaN);
-
-    const compactDate = String(Math.trunc(value));
-    if (/^\d{8}$/.test(compactDate)) {
-      return parseIbkrHistoricalBarTime(compactDate);
-    }
-
-    return new Date(value > 10_000_000_000 ? value : value * 1000);
-  }
-
-  const trimmed = value.trim();
-  if (!trimmed) return new Date(Number.NaN);
-
-  const parsed = Date.parse(trimmed);
-  if (Number.isFinite(parsed)) {
-    return new Date(parsed);
-  }
-
-  const compactMatch = trimmed.match(/^(\d{4})(\d{2})(\d{2})(?:\D+(\d{2}):(\d{2}):(\d{2}))?/);
-  if (!compactMatch) {
-    return new Date(Number.NaN);
-  }
-
-  const [, yearText, monthText, dayText, hourText, minuteText, secondText] = compactMatch;
-  const year = Number(yearText);
-  const month = Number(monthText) - 1;
-  const day = Number(dayText);
-  const hour = Number(hourText ?? "0");
-  const minute = Number(minuteText ?? "0");
-  const second = Number(secondText ?? "0");
-
-  return new Date(year, month, day, hour, minute, second);
-}
-
-export function formatIbkrHistoricalEndDateTime(endDate: Date): string {
-  const pad = (n: number) => String(n).padStart(2, "0");
-  return `${endDate.getFullYear()}${pad(endDate.getMonth() + 1)}${pad(endDate.getDate())} ${pad(endDate.getHours())}:${pad(endDate.getMinutes())}:${pad(endDate.getSeconds())}`;
-}
-
-export function getIbkrHistoryDuration(startDate: Date, endDate: Date): string {
-  const spanMs = endDate.getTime() - startDate.getTime();
-  const spanDays = Math.ceil(spanMs / (1000 * 60 * 60 * 24));
-
-  if (spanDays <= 1) return `${Math.max(Math.ceil(spanMs / (1000 * 60 * 60)), 1)} hours`;
-  if (spanDays <= 30) return `${spanDays} D`;
-  if (spanDays <= 365) return `${Math.ceil(spanDays / 30)} M`;
-  return `${Math.ceil(spanDays / 365)} Y`;
-}
-
-export function ibkrHistoricalBarsToPricePoints(
-  bars: readonly IbkrHistoricalBar[],
-  priceDivisor: number,
-): PricePoint[] {
-  return bars.map((bar) => ({
-    date: parseIbkrHistoricalBarTime(bar.time ?? ""),
-    open: normalizeIbkrPriceValue(bar.open, priceDivisor),
-    high: normalizeIbkrPriceValue(bar.high, priceDivisor),
-    low: normalizeIbkrPriceValue(bar.low, priceDivisor),
-    close: normalizeIbkrPriceValue(bar.close ?? bar.open ?? bar.high ?? bar.low ?? 0, priceDivisor) ?? 0,
-    volume: bar.volume,
-  }));
-}

package/src/plugins/ibkr/gateway/instrument-lookup.ts

@@ -1,117 +0,0 @@
-import type { Contract, ContractDetails, IBApiNext } from "@stoqey/ib";
-import type { BrokerContractRef, InstrumentSearchResult } from "../../../types/instrument";
-import {
-  brokerRefToContract,
-  buildDirectContractCandidates,
-  buildFallbackStockContract,
-  buildInstrumentSearchKey,
-  contractDescriptionToSearchResult,
-  contractDetailsToSearchResult,
-  findExactSymbolMatch,
-} from "./contracts";
-import { IBKR_DATA_TIMEOUT, withTimeout } from "./timeouts";
-
-export interface IbkrInstrumentLookupContext {
-  api: IBApiNext;
-  instanceId?: string;
-}
-
-export async function searchIbkrInstruments(
-  context: IbkrInstrumentLookupContext,
-  query: string,
-): Promise<InstrumentSearchResult[]> {
-  const [descriptions, directMatches] = await Promise.all([
-    withTimeout(context.api.getMatchingSymbols(query), IBKR_DATA_TIMEOUT, "getMatchingSymbols").catch(() => []),
-    withTimeout(getIbkrDirectContractMatches(context, query), IBKR_DATA_TIMEOUT, "getDirectContractMatches")
-      .catch(() => [] as InstrumentSearchResult[]),
-  ]);
-  const merged = new Map<string, InstrumentSearchResult>();
-
-  for (const result of descriptions
-    .map((description) => contractDescriptionToSearchResult(description, context.instanceId))
-    .filter((value): value is InstrumentSearchResult => value != null)) {
-    merged.set(buildInstrumentSearchKey(result), result);
-  }
-
-  for (const result of directMatches) {
-    merged.set(buildInstrumentSearchKey(result), result);
-  }
-
-  return [...merged.values()];
-}
-
-export async function resolveIbkrContract(
-  context: IbkrInstrumentLookupContext,
-  ticker: string,
-  exchange: string,
-  instrument: BrokerContractRef | null,
-): Promise<Contract> {
-  if (instrument) {
-    if (instrument.conId) {
-      return brokerRefToContract(instrument);
-    }
-    return getIbkrPrimaryContractDetails(context.api, brokerRefToContract(instrument))
-      .then((detail) => detail.contract);
-  }
-
-  const directMatches = await withTimeout(
-    getIbkrDirectContractMatches(context, ticker),
-    IBKR_DATA_TIMEOUT,
-    "getDirectContractMatches",
-  );
-  const direct = findExactSymbolMatch(directMatches, ticker);
-  if (direct?.brokerContract) {
-    return brokerRefToContract(direct.brokerContract);
-  }
-
-  const symbolResults = (await withTimeout(context.api.getMatchingSymbols(ticker), IBKR_DATA_TIMEOUT, "getMatchingSymbols"))
-    .map((description) => contractDescriptionToSearchResult(description, context.instanceId))
-    .filter((value): value is InstrumentSearchResult => value != null);
-  const matched = findExactSymbolMatch(symbolResults, ticker);
-  if (matched?.brokerContract) {
-    return brokerRefToContract(matched.brokerContract);
-  }
-
-  const fallbackContract = buildFallbackStockContract(ticker, exchange);
-  const details = await getIbkrPrimaryContractDetails(context.api, fallbackContract);
-  return details.contract;
-}
-
-export async function getIbkrPrimaryContractDetails(
-  api: IBApiNext,
-  contract: Contract,
-): Promise<ContractDetails> {
-  const details = await withTimeout(api.getContractDetails(contract), IBKR_DATA_TIMEOUT, "getContractDetails");
-  if (!details.length) {
-    throw new Error(`Unable to resolve contract ${contract.symbol || contract.localSymbol || contract.conId}`);
-  }
-  return details[0]!;
-}
-
-async function getIbkrDirectContractMatches(
-  context: IbkrInstrumentLookupContext,
-  query: string,
-): Promise<InstrumentSearchResult[]> {
-  const trimmed = query.trim();
-  if (!trimmed) return [];
-
-  const seen = new Set<string>();
-  const results: InstrumentSearchResult[] = [];
-
-  for (const candidate of buildDirectContractCandidates(trimmed)) {
-    try {
-      const details = await withTimeout(context.api.getContractDetails(candidate), IBKR_DATA_TIMEOUT, "getDirectContractDetails");
-      for (const detail of details) {
-        const result = contractDetailsToSearchResult(detail, trimmed, context.instanceId);
-        const key = buildInstrumentSearchKey(result);
-        if (seen.has(key)) continue;
-        seen.add(key);
-        results.push(result);
-      }
-    } catch {
-      // Ignore exact-match lookup failures and fall back to symbol search.
-    }
-  }
-
-  return results;
-}