tn-financial-data 0.2.0 → 0.3.1

package/README.md

@@ -26,6 +26,9 @@ This package is the hosted agent-facing surface only. The repo's website, local
 ## Features
 
 - Company facts, financials, prices, news, insider trades, ownership, global rates, and raw SEC filings through one hosted API
+- Multi-ticker resolve and snapshot reads for lower-latency agent workflows
+- Earnings calendar, dividends, and stock splits through the same hosted read contract
+- Cross-ticker news search over article title, summary, and body text with ticker, provider, publisher, and date filters
 - Agent-friendly CLI with clean error output, scoped subcommand help, and self-description via `tn-financial-data describe opencli`
 - Packaged skill bundle for Claude and OpenCode installs
 - Typed TypeScript client from the root package export
@@ -64,8 +67,14 @@ https://api.truenorth-financial.ai/v1
 
 ```bash
 tn-financial-data query resolve-ticker --query google
+tn-financial-data query resolve-ticker --query google --query meta --query nvda
 tn-financial-data query available-tickers
+tn-financial-data query snapshot --tickers AAPL,MSFT,NVDA
+tn-financial-data query financial-metrics-snapshot --tickers AAPL,MSFT,NVDA --period annual
+tn-financial-data query earnings-calendar --tickers AAPL,MSFT --start-date 2026-04-02 --end-date 2026-04-16
+tn-financial-data query dividends --ticker AAPL --limit 10
 tn-financial-data query company --ticker AAPL
+tn-financial-data query news-search --query "tariff semiconductor" --ticker NVDA --limit 10
 tn-financial-data query filings --ticker AAPL --filing-type 8-K --limit 5
 tn-financial-data query general-overview --ticker AAPL --period quarterly --financial-limit 4 --news-limit 5
 tn-financial-data skill install --tool claude
@@ -89,13 +98,20 @@ Ownership semantics:
 Common query examples:
 
 ```bash
+tn-financial-data query snapshot --tickers AAPL,MSFT,NVDA
+tn-financial-data query financial-metrics-snapshot --tickers AAPL,MSFT,NVDA --period annual
 tn-financial-data query financials --ticker AAPL --period annual --statement all
 tn-financial-data query financial-metrics --ticker AAPL --period annual --limit 4
 tn-financial-data query earnings --ticker AAPL --period quarterly --limit 8
+tn-financial-data query earnings-calendar --tickers AAPL,MSFT --start-date 2026-04-02 --end-date 2026-04-16
 tn-financial-data query quarterly-highlights --ticker AAPL
+tn-financial-data query dividends --ticker AAPL --limit 10
+tn-financial-data query splits --ticker AAPL --limit 10
 tn-financial-data query filings --ticker AAPL --filing-type 10-K,10-Q,8-K --limit 10
 tn-financial-data query filing-items --ticker AAPL --accession-number 0000320193-26-000005 --item 2.02 --include-exhibits
 tn-financial-data query prices --ticker AAPL --interval day --start-date 2025-01-01 --end-date 2025-01-31
+tn-financial-data query news --ticker AAPL --limit 10
+tn-financial-data query news-search --query "AI data center" --provider alpaca --limit 10
 tn-financial-data query institutional-ownership --ticker AAPL --limit 20
 tn-financial-data query investor-portfolio --investor vanguard --limit 20
 tn-financial-data query global-rates --series ecb_refi,boe_sonia --limit 10
@@ -175,6 +191,17 @@ const client = new TnFinancialData({
 const resolution = await client.resolveTicker("google");
 console.log(resolution.status, resolution.resolved_ticker);
 
+const batchResolution = await client.resolveTickers(["google", "meta", "nvda"]);
+console.log(batchResolution.results.map((row) => `${row.query}:${row.status}`));
+
+const calendar = await client.getEarningsCalendar({
+  tickers: ["NVDA", "KO"],
+  startDate: "2026-04-01",
+  endDate: "2026-06-30",
+});
+
+console.log(calendar.events.map((row) => `${row.ticker}:${row.event_date_start}`));
+
 const filings = await client.getFilings("AAPL", {
   filingTypes: ["8-K"],
   limit: 3,
@@ -182,6 +209,14 @@ const filings = await client.getFilings("AAPL", {
 
 console.log(filings.filings[0]?.accession_number);
 
+const news = await client.searchNews("AI data center", {
+  ticker: "NVDA",
+  provider: "alpaca",
+  limit: 5,
+});
+
+console.log(news.news[0]?.title, news.count);
+
 const filingItems = await client.getFilingItems("AAPL", {
   accessionNumber: "0000320193-26-000005",
   filingType: "8-K",