market-feed 0.6.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,137 @@
 # market-feed Changelog
 
+## 0.8.0 — 2026-03-12
+
+### New module
+
+**`market-feed/fundamentals`** — Financial statement types and a `getFundamentals()` convenience function.
+
+```ts
+import { getFundamentals } from "market-feed/fundamentals";
+import { MarketFeed } from "market-feed";
+
+const feed = new MarketFeed();
+const { incomeStatements, balanceSheets, cashFlows } = await getFundamentals(feed, "AAPL");
+
+console.log(`Revenue: $${(incomeStatements[0]!.revenue! / 1e9).toFixed(1)}B`);
+console.log(`Total assets: $${(balanceSheets[0]!.totalAssets! / 1e9).toFixed(1)}B`);
+console.log(`Free cash flow: $${(cashFlows[0]!.freeCashFlow! / 1e9).toFixed(1)}B`);
+```
+
+`getFundamentals()` fetches all three statements in parallel via `Promise.allSettled` — a failure on one statement still returns the others.
+
+#### `IncomeStatement`
+
+| Field | Description |
+|-------|-------------|
+| `revenue` | Total revenue |
+| `grossProfit` | Revenue - cost of revenue |
+| `operatingIncome` | EBIT (operating) |
+| `netIncome` | Bottom-line net income |
+| `ebitda` | EBITDA when available |
+| `dilutedEps` | Diluted EPS |
+
+#### `BalanceSheet`
+
+| Field | Description |
+|-------|-------------|
+| `totalAssets` | Total assets |
+| `totalLiabilities` | Total liabilities |
+| `totalStockholdersEquity` | Book value of equity |
+| `cashAndCashEquivalents` | Cash + cash equivalents |
+| `totalDebt` | Short + long-term debt |
+
+#### `CashFlowStatement`
+
+| Field | Description |
+|-------|-------------|
+| `operatingCashFlow` | Cash from operations |
+| `capitalExpenditures` | CapEx (negative = outflow) |
+| `freeCashFlow` | operatingCashFlow + capitalExpenditures |
+| `investingCashFlow` | Cash from investing |
+| `financingCashFlow` | Cash from financing |
+
+All three types include `symbol`, `date` (period end), `periodType` (`"annual"` | `"quarterly"`), and `provider`.
+
+### New methods on `MarketFeed`
+
+```ts
+const feed = new MarketFeed();
+
+const income  = await feed.incomeStatements("AAPL", { limit: 4 });
+const balance = await feed.balanceSheets("AAPL", { quarterly: true });
+const cash    = await feed.cashFlows("AAPL");
+```
+
+`FundamentalsOptions`: `quarterly?` (default `false`), `limit?` (default `4`), `raw?`.
+
+### Provider support
+
+| Method | `YahooProvider` | others |
+|--------|-----------------|--------|
+| `incomeStatements` | ✓ `incomeStatementHistory` / `incomeStatementHistoryQuarterly` | — |
+| `balanceSheets` | ✓ `balanceSheetHistory` / `balanceSheetHistoryQuarterly` | — |
+| `cashFlows` | ✓ `cashflowStatementHistory` / `cashflowStatementHistoryQuarterly` | — |
+
+### Breaking changes
+
+None. All v0.7.x imports continue to work unchanged.
+
+### Other changes
+
+- New types `IncomeStatement`, `BalanceSheet`, `CashFlowStatement`, `FundamentalsOptions` exported from main `market-feed` entry point
+- `CacheMethod` extended with `"incomeStatements" | "balanceSheets" | "cashFlows"` (TTL: 24 h each)
+- 13 new unit tests (460 total across 24 test files)
+- 10 tsup library entry points + 1 CLI binary
+
+---
+
+## 0.7.0 — 2026-03-12
+
+### New provider
+
+**`TiingoProvider`** — Tiingo (free tier: EOD prices, real-time IEX quotes, news).
+
+```ts
+import { MarketFeed, TiingoProvider } from "market-feed";
+
+const feed = new MarketFeed([
+  new TiingoProvider({ apiKey: process.env.TIINGO_KEY! }),
+]);
+
+const quote   = await feed.quote(["AAPL"]);
+const bars    = await feed.historical("AAPL", { period1: "2024-01-01" });
+const results = await feed.search("apple");
+const profile = await feed.company("AAPL");
+const news    = await feed.news("AAPL", { limit: 5 });
+```
+
+Supports: `quote`, `historical`, `search`, `company`, `news`.
+
+| Feature | Detail |
+|---------|--------|
+| Real-time quotes | IEX endpoint — US equities, intraday |
+| Historical | EOD daily bars, includes `adjClose` |
+| Rate limit | ~50 calls/hour (free plan) |
+| Auth | `Authorization: Token KEY` header |
+
+Free plan sign-up: https://www.tiingo.com
+
+### CLI
+
+`--tiingo-key <key>` flag adds `TiingoProvider` to the CLI provider chain.
+
+### Breaking changes
+
+None. All v0.6.x imports continue to work unchanged.
+
+### Other changes
+
+- `TiingoProvider` and `TiingoProviderOptions` exported from main `market-feed` entry point
+- 21 new unit tests (447 total across 23 test files)
+
+---
+
 ## 0.6.0 — 2026-03-12
 
 ### New provider

package/README.md

@@ -1,7 +1,7 @@
 # market-feed
 
 > Unified TypeScript client for financial market data.
-> Wraps Yahoo Finance, Alpha Vantage, Polygon.io, Finnhub, and Twelve Data under one consistent interface — with caching and automatic fallback built in.
+> Wraps Yahoo Finance, Alpha Vantage, Polygon.io, Finnhub, Twelve Data, and Tiingo under one consistent interface — with caching and automatic fallback built in.
 
 [![CI](https://github.com/piyushgupta344/market-feed/actions/workflows/ci.yml/badge.svg)](https://github.com/piyushgupta344/market-feed/actions/workflows/ci.yml)
 [![npm version](https://badge.fury.io/js/market-feed.svg)](https://www.npmjs.com/package/market-feed)
@@ -39,7 +39,7 @@ const quote = await feed.quote("AAPL");
 console.log(quote.price); // always a number, always the same key
 ```
 
-One interface. Five providers. Zero API key required for Yahoo Finance.
+One interface. Six providers. Zero API key required for Yahoo Finance.
 
 ---
 

package/dist/cli.js

@@ -348,6 +348,70 @@ function transformSearch(quote, raw) {
     ...raw !== void 0 ? { raw } : {}
   };
 }
+function transformIncomeStatement(symbol, entry, periodType, raw) {
+  const rawDate = entry.endDate?.raw;
+  return {
+    symbol: symbol.toUpperCase(),
+    date: rawDate ? new Date(rawDate * 1e3) : /* @__PURE__ */ new Date(0),
+    periodType,
+    ...entry.totalRevenue?.raw !== void 0 ? { revenue: entry.totalRevenue.raw } : {},
+    ...entry.costOfRevenue?.raw !== void 0 ? { costOfRevenue: entry.costOfRevenue.raw } : {},
+    ...entry.grossProfit?.raw !== void 0 ? { grossProfit: entry.grossProfit.raw } : {},
+    ...entry.researchDevelopment?.raw !== void 0 ? { researchAndDevelopment: entry.researchDevelopment.raw } : {},
+    ...entry.sellingGeneralAdministrative?.raw !== void 0 ? { sellingGeneralAdministrative: entry.sellingGeneralAdministrative.raw } : {},
+    ...entry.totalOperatingExpenses?.raw !== void 0 ? { totalOperatingExpenses: entry.totalOperatingExpenses.raw } : {},
+    ...entry.operatingIncome?.raw !== void 0 ? { operatingIncome: entry.operatingIncome.raw } : {},
+    ...entry.netIncome?.raw !== void 0 ? { netIncome: entry.netIncome.raw } : {},
+    ...entry.ebit?.raw !== void 0 ? { ebit: entry.ebit.raw } : {},
+    ...entry.ebitda?.raw !== void 0 ? { ebitda: entry.ebitda.raw } : {},
+    ...entry.dilutedEps?.raw !== void 0 ? { dilutedEps: entry.dilutedEps.raw } : {},
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformBalanceSheet(symbol, entry, periodType, raw) {
+  const rawDate = entry.endDate?.raw;
+  return {
+    symbol: symbol.toUpperCase(),
+    date: rawDate ? new Date(rawDate * 1e3) : /* @__PURE__ */ new Date(0),
+    periodType,
+    ...entry.totalAssets?.raw !== void 0 ? { totalAssets: entry.totalAssets.raw } : {},
+    ...entry.totalCurrentAssets?.raw !== void 0 ? { totalCurrentAssets: entry.totalCurrentAssets.raw } : {},
+    ...entry.totalLiab?.raw !== void 0 ? { totalLiabilities: entry.totalLiab.raw } : {},
+    ...entry.totalCurrentLiabilities?.raw !== void 0 ? { totalCurrentLiabilities: entry.totalCurrentLiabilities.raw } : {},
+    ...entry.totalStockholderEquity?.raw !== void 0 ? { totalStockholdersEquity: entry.totalStockholderEquity.raw } : {},
+    ...entry.cash?.raw !== void 0 ? { cashAndCashEquivalents: entry.cash.raw } : {},
+    ...entry.shortTermInvestments?.raw !== void 0 ? { shortTermInvestments: entry.shortTermInvestments.raw } : {},
+    ...entry.netReceivables?.raw !== void 0 ? { netReceivables: entry.netReceivables.raw } : {},
+    ...entry.inventory?.raw !== void 0 ? { inventory: entry.inventory.raw } : {},
+    ...entry.shortLongTermDebt?.raw !== void 0 ? { shortTermDebt: entry.shortLongTermDebt.raw } : {},
+    ...entry.longTermDebt?.raw !== void 0 ? { longTermDebt: entry.longTermDebt.raw } : {},
+    ...entry.totalDebt?.raw !== void 0 ? { totalDebt: entry.totalDebt.raw } : {},
+    ...entry.retainedEarnings?.raw !== void 0 ? { retainedEarnings: entry.retainedEarnings.raw } : {},
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformCashFlowStatement(symbol, entry, periodType, raw) {
+  const rawDate = entry.endDate?.raw;
+  const operatingCF = entry.totalCashFromOperatingActivities?.raw;
+  const capex = entry.capitalExpenditures?.raw;
+  const freeCashFlow = operatingCF !== void 0 && capex !== void 0 ? operatingCF + capex : void 0;
+  return {
+    symbol: symbol.toUpperCase(),
+    date: rawDate ? new Date(rawDate * 1e3) : /* @__PURE__ */ new Date(0),
+    periodType,
+    ...operatingCF !== void 0 ? { operatingCashFlow: operatingCF } : {},
+    ...entry.totalCashflowsFromInvestingActivities?.raw !== void 0 ? { investingCashFlow: entry.totalCashflowsFromInvestingActivities.raw } : {},
+    ...entry.totalCashFromFinancingActivities?.raw !== void 0 ? { financingCashFlow: entry.totalCashFromFinancingActivities.raw } : {},
+    ...entry.changeInCash?.raw !== void 0 ? { netChangeInCash: entry.changeInCash.raw } : {},
+    ...capex !== void 0 ? { capitalExpenditures: capex } : {},
+    ...freeCashFlow !== void 0 ? { freeCashFlow } : {},
+    ...entry.depreciation?.raw !== void 0 ? { depreciation: entry.depreciation.raw } : {},
+    provider: PROVIDER,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
 
 // src/providers/yahoo/index.ts
 var YahooProvider = class {
@@ -498,6 +562,93 @@ var YahooProvider = class {
     return transformDividends(symbol, result, options?.raw ? data : void 0).slice(0, limit);
   }
   // ---------------------------------------------------------------------------
+  // Fundamentals: income statements
+  // ---------------------------------------------------------------------------
+  async incomeStatements(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const limit = options?.limit ?? 4;
+    const quarterly = options?.quarterly ?? false;
+    const module = quarterly ? "incomeStatementHistoryQuarterly" : "incomeStatementHistory";
+    const data = await this.http2.get(`/v10/finance/quoteSummary/${s}`, {
+      params: { modules: module }
+    });
+    const result = data.quoteSummary.result?.[0];
+    if (!result) {
+      const err = data.quoteSummary.error;
+      throw new ProviderError(
+        err?.description ?? `No income statement data for symbol "${s}"`,
+        this.name
+      );
+    }
+    const history = quarterly ? result.incomeStatementHistoryQuarterly?.incomeStatementHistory : result.incomeStatementHistory?.incomeStatementHistory;
+    return (history ?? []).slice(0, limit).map(
+      (entry) => transformIncomeStatement(
+        symbol,
+        entry,
+        quarterly ? "quarterly" : "annual",
+        options?.raw ? entry : void 0
+      )
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Fundamentals: balance sheets
+  // ---------------------------------------------------------------------------
+  async balanceSheets(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const limit = options?.limit ?? 4;
+    const quarterly = options?.quarterly ?? false;
+    const module = quarterly ? "balanceSheetHistoryQuarterly" : "balanceSheetHistory";
+    const data = await this.http2.get(`/v10/finance/quoteSummary/${s}`, {
+      params: { modules: module }
+    });
+    const result = data.quoteSummary.result?.[0];
+    if (!result) {
+      const err = data.quoteSummary.error;
+      throw new ProviderError(
+        err?.description ?? `No balance sheet data for symbol "${s}"`,
+        this.name
+      );
+    }
+    const statements = quarterly ? result.balanceSheetHistoryQuarterly?.balanceSheetStatements : result.balanceSheetHistory?.balanceSheetStatements;
+    return (statements ?? []).slice(0, limit).map(
+      (entry) => transformBalanceSheet(
+        symbol,
+        entry,
+        quarterly ? "quarterly" : "annual",
+        options?.raw ? entry : void 0
+      )
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Fundamentals: cash flow statements
+  // ---------------------------------------------------------------------------
+  async cashFlows(symbol, options) {
+    const s = toYahooSymbol(symbol);
+    const limit = options?.limit ?? 4;
+    const quarterly = options?.quarterly ?? false;
+    const module = quarterly ? "cashflowStatementHistoryQuarterly" : "cashflowStatementHistory";
+    const data = await this.http2.get(`/v10/finance/quoteSummary/${s}`, {
+      params: { modules: module }
+    });
+    const result = data.quoteSummary.result?.[0];
+    if (!result) {
+      const err = data.quoteSummary.error;
+      throw new ProviderError(
+        err?.description ?? `No cash flow data for symbol "${s}"`,
+        this.name
+      );
+    }
+    const statements = quarterly ? result.cashflowStatementHistoryQuarterly?.cashflowStatements : result.cashflowStatementHistory?.cashflowStatements;
+    return (statements ?? []).slice(0, limit).map(
+      (entry) => transformCashFlowStatement(
+        symbol,
+        entry,
+        quarterly ? "quarterly" : "annual",
+        options?.raw ? entry : void 0
+      )
+    );
+  }
+  // ---------------------------------------------------------------------------
   // Splits
   // ---------------------------------------------------------------------------
   async splits(symbol, options) {
@@ -544,7 +695,10 @@ var DEFAULT_TTLS = {
   marketStatus: 60,
   earnings: 3600,
   dividends: 86400,
-  splits: 86400
+  splits: 86400,
+  incomeStatements: 86400,
+  balanceSheets: 86400,
+  cashFlows: 86400
 };
 var MarketFeed = class {
   _providers;
@@ -697,6 +851,50 @@ var MarketFeed = class {
     return result;
   }
   // ---------------------------------------------------------------------------
+  // incomeStatements
+  // ---------------------------------------------------------------------------
+  async incomeStatements(symbol, options) {
+    const cacheKey = `incomeStatements:${symbol}:${options?.quarterly ?? false}:${options?.limit ?? 4}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("incomeStatements", (provider) => {
+      if (!provider.incomeStatements)
+        throw new UnsupportedOperationError(provider.name, "incomeStatements");
+      return provider.incomeStatements(symbol, options);
+    });
+    await this.setCache(cacheKey, result, "incomeStatements");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // balanceSheets
+  // ---------------------------------------------------------------------------
+  async balanceSheets(symbol, options) {
+    const cacheKey = `balanceSheets:${symbol}:${options?.quarterly ?? false}:${options?.limit ?? 4}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("balanceSheets", (provider) => {
+      if (!provider.balanceSheets)
+        throw new UnsupportedOperationError(provider.name, "balanceSheets");
+      return provider.balanceSheets(symbol, options);
+    });
+    await this.setCache(cacheKey, result, "balanceSheets");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
+  // cashFlows
+  // ---------------------------------------------------------------------------
+  async cashFlows(symbol, options) {
+    const cacheKey = `cashFlows:${symbol}:${options?.quarterly ?? false}:${options?.limit ?? 4}`;
+    const cached = await this.getCache(cacheKey);
+    if (cached) return cached;
+    const result = await this.withFallback("cashFlows", (provider) => {
+      if (!provider.cashFlows) throw new UnsupportedOperationError(provider.name, "cashFlows");
+      return provider.cashFlows(symbol, options);
+    });
+    await this.setCache(cacheKey, result, "cashFlows");
+    return result;
+  }
+  // ---------------------------------------------------------------------------
   // Cache management
   // ---------------------------------------------------------------------------
   /** Invalidate all cached entries. */
@@ -1585,9 +1783,213 @@ function subtractOneYear3() {
   return d;
 }
 
+// src/providers/tiingo/transform.ts
+var PROVIDER5 = "tiingo";
+function transformQuote5(iex, meta, raw) {
+  const price = iex.last ?? iex.tngoLast;
+  const prevClose = iex.prevClose;
+  const change = price - prevClose;
+  const changePercent = prevClose !== 0 ? change / prevClose * 100 : 0;
+  return {
+    symbol: iex.ticker.toUpperCase(),
+    name: meta?.name ?? iex.ticker.toUpperCase(),
+    price,
+    change,
+    changePercent,
+    open: iex.open ?? price,
+    high: iex.high ?? price,
+    low: iex.low ?? price,
+    close: price,
+    previousClose: prevClose,
+    volume: iex.volume,
+    currency: "USD",
+    exchange: meta?.exchangeCode ?? "",
+    timestamp: new Date(iex.timestamp),
+    provider: PROVIDER5,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformHistoricalBar2(bar, raw) {
+  return {
+    date: new Date(bar.date),
+    open: bar.open,
+    high: bar.high,
+    low: bar.low,
+    close: bar.close,
+    adjClose: bar.adjClose,
+    volume: bar.volume,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformSearch5(item, raw) {
+  return {
+    symbol: item.ticker.toUpperCase(),
+    name: item.name,
+    type: mapAssetType(item.assetType),
+    exchange: item.exchangeCode || void 0,
+    provider: PROVIDER5,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformCompany5(meta, raw) {
+  return {
+    symbol: meta.ticker.toUpperCase(),
+    name: meta.name,
+    description: meta.description || void 0,
+    exchange: meta.exchangeCode || void 0,
+    provider: PROVIDER5,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function transformNews3(article, raw) {
+  return {
+    id: String(article.id),
+    title: article.title,
+    summary: article.description || void 0,
+    url: article.url,
+    source: article.source,
+    publishedAt: new Date(article.publishedDate),
+    symbols: article.tickers.map((t) => t.toUpperCase()),
+    provider: PROVIDER5,
+    ...raw !== void 0 ? { raw } : {}
+  };
+}
+function mapAssetType(type) {
+  if (!type) return "stock";
+  const t = type.toLowerCase();
+  if (t === "stock" || t === "equity") return "stock";
+  if (t === "etf") return "etf";
+  if (t === "mutualfund" || t === "mutual fund") return "mutual-fund";
+  if (t === "crypto") return "crypto";
+  if (t === "forex") return "forex";
+  return "unknown";
+}
+
+// src/providers/tiingo/index.ts
+var TiingoProvider = class {
+  constructor(options) {
+    this.options = options;
+    this.http = new HttpClient("tiingo", {
+      baseUrl: "https://api.tiingo.com",
+      headers: {
+        Authorization: `Token ${options.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+      ...options.retries !== void 0 ? { retries: options.retries } : {}
+    });
+    this.limiter = options.rateLimiter ?? new RateLimiter("tiingo", 50, 50 / 3600);
+  }
+  name = "tiingo";
+  http;
+  limiter;
+  // ---------------------------------------------------------------------------
+  // Quote (IEX real-time)
+  // ---------------------------------------------------------------------------
+  async quote(symbols, options) {
+    return Promise.all(symbols.map((s) => this.fetchSingleQuote(s, options)));
+  }
+  async fetchSingleQuote(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const [iexData, metaData] = await Promise.allSettled([
+      this.http.get(`/iex/${s}`),
+      this.http.get(`/tiingo/daily/${s}`)
+    ]);
+    if (iexData.status === "rejected") {
+      throw new ProviderError(`No quote data for symbol "${s}"`, this.name);
+    }
+    const iexRaw = iexData.value;
+    const iex = Array.isArray(iexRaw) ? iexRaw[0] : null;
+    if (!iex) {
+      throw new ProviderError(`No quote data for symbol "${s}"`, this.name);
+    }
+    const meta = metaData.status === "fulfilled" && !("detail" in metaData.value) ? metaData.value : void 0;
+    return transformQuote5(iex, meta, options?.raw ? { iex, meta } : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // Historical (EOD daily)
+  // ---------------------------------------------------------------------------
+  async historical(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const params = {};
+    if (options?.period1 !== void 0) {
+      params["startDate"] = typeof options.period1 === "string" ? options.period1 : options.period1.toISOString().slice(0, 10);
+    }
+    if (options?.period2 !== void 0) {
+      params["endDate"] = typeof options.period2 === "string" ? options.period2 : options.period2.toISOString().slice(0, 10);
+    }
+    const data = await this.http.get(
+      `/tiingo/daily/${s}/prices`,
+      { params }
+    );
+    if (!Array.isArray(data)) {
+      throw new ProviderError(
+        data.detail ?? `No historical data for symbol "${s}"`,
+        this.name
+      );
+    }
+    if (data.length === 0) {
+      throw new ProviderError(`No historical data for symbol "${s}"`, this.name);
+    }
+    return data.map((bar) => transformHistoricalBar2(bar, options?.raw ? bar : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Search
+  // ---------------------------------------------------------------------------
+  async search(query, options) {
+    this.limiter.consume();
+    const limit = options?.limit ?? 10;
+    const data = await this.http.get(
+      "/tiingo/utilities/search",
+      { params: { query, limit } }
+    );
+    if (!Array.isArray(data)) {
+      return [];
+    }
+    return data.slice(0, limit).map((item) => transformSearch5(item, options?.raw ? item : void 0));
+  }
+  // ---------------------------------------------------------------------------
+  // Company (metadata)
+  // ---------------------------------------------------------------------------
+  async company(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const data = await this.http.get(
+      `/tiingo/daily/${s}`
+    );
+    if ("detail" in data || !("name" in data) || !data.name) {
+      throw new ProviderError(
+        ("detail" in data ? data.detail : void 0) ?? `No company data for symbol "${s}"`,
+        this.name
+      );
+    }
+    return transformCompany5(data, options?.raw ? data : void 0);
+  }
+  // ---------------------------------------------------------------------------
+  // News
+  // ---------------------------------------------------------------------------
+  async news(symbol, options) {
+    this.limiter.consume();
+    const s = normalise(symbol);
+    const limit = options?.limit ?? 10;
+    const data = await this.http.get("/tiingo/news", {
+      params: { tickers: s, limit }
+    });
+    if (!Array.isArray(data)) {
+      throw new ProviderError(
+        data.detail ?? `No news data for symbol "${s}"`,
+        this.name
+      );
+    }
+    return data.slice(0, limit).map((article) => transformNews3(article, options?.raw ? article : void 0));
+  }
+};
+
 // src/providers/twelve-data/transform.ts
-var PROVIDER5 = "twelve-data";
-function transformQuote5(data, raw) {
+var PROVIDER6 = "twelve-data";
+function transformQuote6(data, raw) {
   return {
     symbol: data.symbol,
     name: data.name,
@@ -1608,11 +2010,11 @@ function transformQuote5(data, raw) {
     currency: data.currency,
     exchange: data.exchange,
     timestamp: new Date(data.timestamp * 1e3),
-    provider: PROVIDER5,
+    provider: PROVIDER6,
     ...raw !== void 0 ? { raw } : {}
   };
 }
-function transformHistoricalBar2(bar, raw) {
+function transformHistoricalBar3(bar, raw) {
   return {
     date: new Date(bar.datetime),
     open: Number(bar.open),
@@ -1623,13 +2025,13 @@ function transformHistoricalBar2(bar, raw) {
     ...raw !== void 0 ? { raw } : {}
   };
 }
-function transformSearch5(result, raw) {
+function transformSearch6(result, raw) {
   return {
     symbol: result.symbol,
     name: result.instrument_name,
     type: mapInstrumentType(result.instrument_type),
     exchange: result.exchange || void 0,
-    provider: PROVIDER5,
+    provider: PROVIDER6,
     ...raw !== void 0 ? { raw } : {}
   };
 }
@@ -1645,7 +2047,7 @@ function transformProfile(data, raw) {
     website: data.website || void 0,
     ceo: data.CEO || void 0,
     exchange: data.exchange || void 0,
-    provider: PROVIDER5,
+    provider: PROVIDER6,
     ...raw !== void 0 ? { raw } : {}
   };
 }
@@ -1696,7 +2098,7 @@ var TwelveDataProvider = class {
         data.code
       );
     }
-    return transformQuote5(data, options?.raw ? data : void 0);
+    return transformQuote6(data, options?.raw ? data : void 0);
   }
   // ---------------------------------------------------------------------------
   // Historical (time series)
@@ -1728,7 +2130,7 @@ var TwelveDataProvider = class {
     if (!Array.isArray(data.values) || data.values.length === 0) {
       throw new ProviderError(`No historical data for symbol "${s}"`, this.name);
     }
-    return [...data.values].reverse().map((bar) => transformHistoricalBar2(bar, options?.raw ? bar : void 0));
+    return [...data.values].reverse().map((bar) => transformHistoricalBar3(bar, options?.raw ? bar : void 0));
   }
   // ---------------------------------------------------------------------------
   // Search
@@ -1742,7 +2144,7 @@ var TwelveDataProvider = class {
     if (data.code !== void 0 || data.status === "error") {
       return [];
     }
-    return (data.data ?? []).slice(0, limit).map((r) => transformSearch5(r, options?.raw ? r : void 0));
+    return (data.data ?? []).slice(0, limit).map((r) => transformSearch6(r, options?.raw ? r : void 0));
   }
   // ---------------------------------------------------------------------------
   // Company (profile)
@@ -1804,6 +2206,7 @@ Options:
   --polygon-key <key>   Polygon.io API key
   --finnhub-key <key>   Finnhub API key
   --td-key <key>        Twelve Data API key
+  --tiingo-key <key>    Tiingo API key
   --json                Output raw JSON
   --limit <n>           Limit results (default: 10)
   --interval <i>        Historical interval: 1m 5m 15m 30m 1h 1d 1wk 1mo (default: 1d)
@@ -1853,6 +2256,9 @@ function parseArgs(argv) {
     } else if (arg === "--td-key") {
       result.tdKey = args[++i];
       i++;
+    } else if (arg === "--tiingo-key") {
+      result.tiingoKey = args[++i];
+      i++;
     } else if (arg === "--limit") {
       result.limit = Number(args[++i]) || 10;
       i++;
@@ -1889,6 +2295,7 @@ function buildFeed(args) {
   if (args.polygonKey) providers.push(new PolygonProvider({ apiKey: args.polygonKey }));
   if (args.finnhubKey) providers.push(new FinnhubProvider({ apiKey: args.finnhubKey }));
   if (args.tdKey) providers.push(new TwelveDataProvider({ apiKey: args.tdKey }));
+  if (args.tiingoKey) providers.push(new TiingoProvider({ apiKey: args.tiingoKey }));
   return new MarketFeed({ providers });
 }
 function pad(s, n) {