sentisense 0.75.1 → 0.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -263,6 +263,7 @@ client.stocks.getShortInterest("GME", { limit: 12 }) // Short interest by set
263
263
  client.stocks.getShortVolume("GME") // Daily short volume
264
264
  client.stocks.getFloat("GME") // Free float
265
265
  client.stocks.getGraph("AAPL", { depth: 1 }) // Company knowledge graph: people, products, peers
266
+ client.stocks.getEtfs("NVDA", { limit: 5 }) // ETFs that hold the stock, heaviest weight first
266
267
  client.stocks.getOptionsSummary("NVDA") // End-of-day options dossier
267
268
  client.stocks.getOptionsHistory("NVDA", { window: "2y" }) // Daily options aggregates over time
268
269
  client.stocks.getOptionsIntradayHistory("NVDA") // One session's intraday options series (PRO)
@@ -272,6 +273,8 @@ client.stocks.getAISummary("AAPL", { depth: "deep" }) // AI report (PRO)
272
273
 
273
274
  Price fields carry `priceAsOf` (Unix milliseconds) for the age of the market data; read that for freshness rather than `timestamp`, which is when the response was served.
274
275
 
276
+ `stocks.getEtfs` resolves to a bare array (no preview envelope) on every tier. Each row has `etfTicker`, `etfName`, `weightPct` (the stock's weight in the fund as a percentage from 0 to 100, combined across share classes for a company with several) and `asOfDate` (that fund's own holdings date, so it can differ between rows; may be absent). It searches only the funds SentiSense tracks with a holdings file, some of which are partial, so it is not every fund in the market. A ticker no tracked fund holds resolves to `[]`. See the [API reference](https://sentisense.ai/docs/api/stocks/#get-stock-etfs).
277
+
275
278
  Short interest and short volume come back newest first, and an unknown ticker returns an empty `dataPoints` array rather than an error. Every identifier in `getGraph` is a slug, the same handle the metric and document endpoints take. An ETF symbol is refused by `getQuote` with an `APIError` whose `code` is `"ticker_is_etf"`; use `etfs.quote()` for funds.
276
279
 
277
280
  Product nodes (`type === "PRODUCT_OR_SERVICE"`) in `stocks.getGraph` now carry optional `category` when known. Other nodes and products without a category omit it.
package/dist/cli.cjs CHANGED
@@ -1432,7 +1432,7 @@ var flowsCommand = {
1432
1432
  };
1433
1433
 
1434
1434
  // src/version.ts
1435
- var VERSION = "0.75.1";
1435
+ var VERSION = "0.76.0";
1436
1436
 
1437
1437
  // src/resources/analyst.ts
1438
1438
  var Analyst = class {
@@ -2529,6 +2529,19 @@ var Stocks = class {
2529
2529
  async getSimilar(ticker, options) {
2530
2530
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);
2531
2531
  }
2532
+ /**
2533
+ * List the ETFs that hold a stock, heaviest weight first.
2534
+ *
2535
+ * Resolves to a bare array (no preview envelope) on every tier, sorted by `weightPct`
2536
+ * descending, then `etfTicker` ascending. A ticker no tracked fund holds, or an unknown
2537
+ * ticker, resolves to `[]` rather than throwing. Only funds SentiSense tracks with a
2538
+ * holdings file are searched, and some funds' holdings are partial, so the list is not
2539
+ * every fund in the market. `ticker` is case-insensitive. Counts against the monthly
2540
+ * quota like other data endpoints.
2541
+ */
2542
+ async getEtfs(ticker, options) {
2543
+ return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/etfs`, options);
2544
+ }
2532
2545
  /** Get company profile (CEO, sector, industry, market data). */
2533
2546
  async getProfile(ticker, options) {
2534
2547
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);
package/dist/index.cjs CHANGED
@@ -1177,6 +1177,19 @@ var Stocks = class {
1177
1177
  async getSimilar(ticker, options) {
1178
1178
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);
1179
1179
  }
1180
+ /**
1181
+ * List the ETFs that hold a stock, heaviest weight first.
1182
+ *
1183
+ * Resolves to a bare array (no preview envelope) on every tier, sorted by `weightPct`
1184
+ * descending, then `etfTicker` ascending. A ticker no tracked fund holds, or an unknown
1185
+ * ticker, resolves to `[]` rather than throwing. Only funds SentiSense tracks with a
1186
+ * holdings file are searched, and some funds' holdings are partial, so the list is not
1187
+ * every fund in the market. `ticker` is case-insensitive. Counts against the monthly
1188
+ * quota like other data endpoints.
1189
+ */
1190
+ async getEtfs(ticker, options) {
1191
+ return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/etfs`, options);
1192
+ }
1180
1193
  /** Get company profile (CEO, sector, industry, market data). */
1181
1194
  async getProfile(ticker, options) {
1182
1195
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);
@@ -1550,7 +1563,7 @@ function serializeTrackerParams(params) {
1550
1563
  }
1551
1564
 
1552
1565
  // src/version.ts
1553
- var VERSION = "0.75.1";
1566
+ var VERSION = "0.76.0";
1554
1567
 
1555
1568
  // src/client.ts
1556
1569
  var DEFAULT_BASE_URL = "https://app.sentisense.ai";