sentisense 0.75.1 → 0.77.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/dist/index.d.mts CHANGED
@@ -181,6 +181,24 @@ interface SimilarStock {
181
181
  price: number | null;
182
182
  changePercent: number | null;
183
183
  }
184
+ /** One ETF that holds a given stock. Returned by `stocks.getEtfs`. */
185
+ interface EtfMembership {
186
+ /** The fund's ticker. */
187
+ etfTicker: string;
188
+ /** The fund's name; the fund ticker when no name is known. */
189
+ etfName: string;
190
+ /**
191
+ * The stock's weight in the fund as a percentage (0 to 100, so `7.1` means 7.1%). For a
192
+ * company with several listed share classes (GOOGL and GOOG, BRK.B and BRK.A) it is the
193
+ * combined weight of all the classes in that fund, and every class returns the same rows.
194
+ */
195
+ weightPct: number;
196
+ /**
197
+ * ISO date `YYYY-MM-DD` of this fund's holdings file. It is per fund, so rows in one
198
+ * response can carry different dates. May be absent.
199
+ */
200
+ asOfDate?: string;
201
+ }
184
202
  interface StockImage {
185
203
  iconUrl: string | null;
186
204
  logoUrl: string | null;
@@ -688,6 +706,10 @@ interface GetDescriptionsOptions {
688
706
  interface GetSimilarOptions {
689
707
  limit?: number;
690
708
  }
709
+ interface GetStockEtfsOptions {
710
+ /** Return at most this many rows. Omitted, 0 or negative returns every row. */
711
+ limit?: number;
712
+ }
691
713
  interface GetProfileOptions {
692
714
  forced?: boolean;
693
715
  }
@@ -3887,6 +3909,21 @@ interface AnalystAction {
3887
3909
  actionType: string;
3888
3910
  fromGrade: string | null;
3889
3911
  toGrade: string | null;
3912
+ /**
3913
+ * The price target the firm stated with this action, raw as stated on the day. `null`
3914
+ * when the firm stated none or the row is not covered, never zero. PRO (and sample
3915
+ * companies): every free preview row carries `null`. On {@link Analyst.actions}, rows
3916
+ * dated before a split of the ticker carry `null`, because firms do not restate old
3917
+ * targets. Absent on older responses.
3918
+ */
3919
+ priceTarget?: number | null;
3920
+ /**
3921
+ * The target the firm moved from, as stated with this action; read the pair as
3922
+ * "400 to 200". `null` when we hold none, when the firm kept its target unchanged, and
3923
+ * always when `priceTarget` is `null`. Same PRO and split rules as `priceTarget`.
3924
+ * Absent on older responses.
3925
+ */
3926
+ priorPriceTarget?: number | null;
3890
3927
  }
3891
3928
  /** Which forward period an {@link AnalystEstimate} covers. */
3892
3929
  type AnalystEstimatePeriodType = "CURRENT_QUARTER" | "NEXT_QUARTER" | "CURRENT_YEAR" | "NEXT_YEAR";
@@ -4176,6 +4213,10 @@ declare class Analyst {
4176
4213
  /**
4177
4214
  * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
4178
4215
  * Free users receive the 3 most recent.
4216
+ *
4217
+ * Each row carries `priceTarget`, the target the firm stated with the action, and
4218
+ * `priorPriceTarget`, the target it moved from (PRO; `null` on free preview rows,
4219
+ * `null` when the firm stated none or kept its target unchanged).
4179
4220
  */
4180
4221
  actions(ticker: string, options?: GetAnalystActionsOptions): Promise<PreviewResponse<AnalystAction[]>>;
4181
4222
  /**
@@ -4186,6 +4227,10 @@ declare class Analyst {
4186
4227
  /**
4187
4228
  * Get market-wide recent analyst actions across all covered tickers, newest first.
4188
4229
  * Free users receive the 5 most recent.
4230
+ *
4231
+ * Rows carry the same `priceTarget` and `priorPriceTarget` as {@link actions} (PRO;
4232
+ * `null` on free preview rows). This feed does not check for stock splits, so for a
4233
+ * stock that split inside the window, read its targets from {@link actions}.
4189
4234
  */
4190
4235
  marketActivity(options?: GetAnalystMarketActivityOptions): Promise<PreviewResponse<AnalystAction[]>>;
4191
4236
  /**
@@ -5228,6 +5273,17 @@ declare class Stocks {
5228
5273
  getDescriptions(tickers: string[], options?: GetDescriptionsOptions): Promise<Record<string, StockProfile>>;
5229
5274
  /** Get peer/similar stocks. */
5230
5275
  getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]>;
5276
+ /**
5277
+ * List the ETFs that hold a stock, heaviest weight first.
5278
+ *
5279
+ * Resolves to a bare array (no preview envelope) on every tier, sorted by `weightPct`
5280
+ * descending, then `etfTicker` ascending. A ticker no tracked fund holds, or an unknown
5281
+ * ticker, resolves to `[]` rather than throwing. Only funds SentiSense tracks with a
5282
+ * holdings file are searched, and some funds' holdings are partial, so the list is not
5283
+ * every fund in the market. `ticker` is case-insensitive. Counts against the monthly
5284
+ * quota like other data endpoints.
5285
+ */
5286
+ getEtfs(ticker: string, options?: GetStockEtfsOptions): Promise<EtfMembership[]>;
5231
5287
  /** Get company profile (CEO, sector, industry, market data). */
5232
5288
  getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile>;
5233
5289
  /**
@@ -5619,6 +5675,6 @@ declare class APIError extends SentiSenseError {
5619
5675
  constructor(message: string, status: number, code?: string);
5620
5676
  }
5621
5677
 
5622
- declare const VERSION = "0.75.1";
5678
+ declare const VERSION = "0.77.0";
5623
5679
 
5624
- export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatePeriodType, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AnalystRef, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarlyFilers, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EarningsSummariesResponse, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfQuote, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type ExtendedHoursInfo, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersHistoryOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetInstitutionDetailOptions, type GetInstitutionHistoryOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetOptionsIntradayHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetShortInterestOptions, type GetShortVolumeOptions, type GetStockGraphOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type GraphCounts, type GraphEdge, type GraphGroups, type GraphNode, type GraphProductFamily, type Holder, type HolderComparisonStatus, type HolderNotableChanges, type HoldersHistory, type HoldersHistoryQuarter, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionChangeFilter, type InstitutionChangeType, type InstitutionDetail, type InstitutionHistory, type InstitutionHistoryQuarter, type InstitutionHolding, type InstitutionList, type InstitutionListResponse, type InstitutionMatchTotals, type InstitutionPositionPoint, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type NotableHolder, type OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsIntradayHistory, type OptionsIntradayPoint, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type OwnershipSelection, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShareClass, type ShortInterest, type ShortInterestDataPoint, type ShortVolume, type ShortVolumeDataPoint, type SimilarStock, type StockDetail, type StockEntity, type StockGraph, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerFilter, type TrackerGeoEntry, type TrackerGetParams, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
5680
+ export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatePeriodType, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AnalystRef, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarlyFilers, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EarningsSummariesResponse, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfMembership, type EtfQuote, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type ExtendedHoursInfo, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersHistoryOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetInstitutionDetailOptions, type GetInstitutionHistoryOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetOptionsIntradayHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetShortInterestOptions, type GetShortVolumeOptions, type GetStockEtfsOptions, type GetStockGraphOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type GraphCounts, type GraphEdge, type GraphGroups, type GraphNode, type GraphProductFamily, type Holder, type HolderComparisonStatus, type HolderNotableChanges, type HoldersHistory, type HoldersHistoryQuarter, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionChangeFilter, type InstitutionChangeType, type InstitutionDetail, type InstitutionHistory, type InstitutionHistoryQuarter, type InstitutionHolding, type InstitutionList, type InstitutionListResponse, type InstitutionMatchTotals, type InstitutionPositionPoint, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type NotableHolder, type OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsIntradayHistory, type OptionsIntradayPoint, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type OwnershipSelection, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShareClass, type ShortInterest, type ShortInterestDataPoint, type ShortVolume, type ShortVolumeDataPoint, type SimilarStock, type StockDetail, type StockEntity, type StockGraph, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerFilter, type TrackerGeoEntry, type TrackerGetParams, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
package/dist/index.d.ts CHANGED
@@ -181,6 +181,24 @@ interface SimilarStock {
181
181
  price: number | null;
182
182
  changePercent: number | null;
183
183
  }
184
+ /** One ETF that holds a given stock. Returned by `stocks.getEtfs`. */
185
+ interface EtfMembership {
186
+ /** The fund's ticker. */
187
+ etfTicker: string;
188
+ /** The fund's name; the fund ticker when no name is known. */
189
+ etfName: string;
190
+ /**
191
+ * The stock's weight in the fund as a percentage (0 to 100, so `7.1` means 7.1%). For a
192
+ * company with several listed share classes (GOOGL and GOOG, BRK.B and BRK.A) it is the
193
+ * combined weight of all the classes in that fund, and every class returns the same rows.
194
+ */
195
+ weightPct: number;
196
+ /**
197
+ * ISO date `YYYY-MM-DD` of this fund's holdings file. It is per fund, so rows in one
198
+ * response can carry different dates. May be absent.
199
+ */
200
+ asOfDate?: string;
201
+ }
184
202
  interface StockImage {
185
203
  iconUrl: string | null;
186
204
  logoUrl: string | null;
@@ -688,6 +706,10 @@ interface GetDescriptionsOptions {
688
706
  interface GetSimilarOptions {
689
707
  limit?: number;
690
708
  }
709
+ interface GetStockEtfsOptions {
710
+ /** Return at most this many rows. Omitted, 0 or negative returns every row. */
711
+ limit?: number;
712
+ }
691
713
  interface GetProfileOptions {
692
714
  forced?: boolean;
693
715
  }
@@ -3887,6 +3909,21 @@ interface AnalystAction {
3887
3909
  actionType: string;
3888
3910
  fromGrade: string | null;
3889
3911
  toGrade: string | null;
3912
+ /**
3913
+ * The price target the firm stated with this action, raw as stated on the day. `null`
3914
+ * when the firm stated none or the row is not covered, never zero. PRO (and sample
3915
+ * companies): every free preview row carries `null`. On {@link Analyst.actions}, rows
3916
+ * dated before a split of the ticker carry `null`, because firms do not restate old
3917
+ * targets. Absent on older responses.
3918
+ */
3919
+ priceTarget?: number | null;
3920
+ /**
3921
+ * The target the firm moved from, as stated with this action; read the pair as
3922
+ * "400 to 200". `null` when we hold none, when the firm kept its target unchanged, and
3923
+ * always when `priceTarget` is `null`. Same PRO and split rules as `priceTarget`.
3924
+ * Absent on older responses.
3925
+ */
3926
+ priorPriceTarget?: number | null;
3890
3927
  }
3891
3928
  /** Which forward period an {@link AnalystEstimate} covers. */
3892
3929
  type AnalystEstimatePeriodType = "CURRENT_QUARTER" | "NEXT_QUARTER" | "CURRENT_YEAR" | "NEXT_YEAR";
@@ -4176,6 +4213,10 @@ declare class Analyst {
4176
4213
  /**
4177
4214
  * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
4178
4215
  * Free users receive the 3 most recent.
4216
+ *
4217
+ * Each row carries `priceTarget`, the target the firm stated with the action, and
4218
+ * `priorPriceTarget`, the target it moved from (PRO; `null` on free preview rows,
4219
+ * `null` when the firm stated none or kept its target unchanged).
4179
4220
  */
4180
4221
  actions(ticker: string, options?: GetAnalystActionsOptions): Promise<PreviewResponse<AnalystAction[]>>;
4181
4222
  /**
@@ -4186,6 +4227,10 @@ declare class Analyst {
4186
4227
  /**
4187
4228
  * Get market-wide recent analyst actions across all covered tickers, newest first.
4188
4229
  * Free users receive the 5 most recent.
4230
+ *
4231
+ * Rows carry the same `priceTarget` and `priorPriceTarget` as {@link actions} (PRO;
4232
+ * `null` on free preview rows). This feed does not check for stock splits, so for a
4233
+ * stock that split inside the window, read its targets from {@link actions}.
4189
4234
  */
4190
4235
  marketActivity(options?: GetAnalystMarketActivityOptions): Promise<PreviewResponse<AnalystAction[]>>;
4191
4236
  /**
@@ -5228,6 +5273,17 @@ declare class Stocks {
5228
5273
  getDescriptions(tickers: string[], options?: GetDescriptionsOptions): Promise<Record<string, StockProfile>>;
5229
5274
  /** Get peer/similar stocks. */
5230
5275
  getSimilar(ticker: string, options?: GetSimilarOptions): Promise<SimilarStock[]>;
5276
+ /**
5277
+ * List the ETFs that hold a stock, heaviest weight first.
5278
+ *
5279
+ * Resolves to a bare array (no preview envelope) on every tier, sorted by `weightPct`
5280
+ * descending, then `etfTicker` ascending. A ticker no tracked fund holds, or an unknown
5281
+ * ticker, resolves to `[]` rather than throwing. Only funds SentiSense tracks with a
5282
+ * holdings file are searched, and some funds' holdings are partial, so the list is not
5283
+ * every fund in the market. `ticker` is case-insensitive. Counts against the monthly
5284
+ * quota like other data endpoints.
5285
+ */
5286
+ getEtfs(ticker: string, options?: GetStockEtfsOptions): Promise<EtfMembership[]>;
5231
5287
  /** Get company profile (CEO, sector, industry, market data). */
5232
5288
  getProfile(ticker: string, options?: GetProfileOptions): Promise<StockProfile>;
5233
5289
  /**
@@ -5619,6 +5675,6 @@ declare class APIError extends SentiSenseError {
5619
5675
  constructor(message: string, status: number, code?: string);
5620
5676
  }
5621
5677
 
5622
- declare const VERSION = "0.75.1";
5678
+ declare const VERSION = "0.77.0";
5623
5679
 
5624
- export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatePeriodType, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AnalystRef, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarlyFilers, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EarningsSummariesResponse, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfQuote, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type ExtendedHoursInfo, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersHistoryOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetInstitutionDetailOptions, type GetInstitutionHistoryOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetOptionsIntradayHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetShortInterestOptions, type GetShortVolumeOptions, type GetStockGraphOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type GraphCounts, type GraphEdge, type GraphGroups, type GraphNode, type GraphProductFamily, type Holder, type HolderComparisonStatus, type HolderNotableChanges, type HoldersHistory, type HoldersHistoryQuarter, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionChangeFilter, type InstitutionChangeType, type InstitutionDetail, type InstitutionHistory, type InstitutionHistoryQuarter, type InstitutionHolding, type InstitutionList, type InstitutionListResponse, type InstitutionMatchTotals, type InstitutionPositionPoint, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type NotableHolder, type OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsIntradayHistory, type OptionsIntradayPoint, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type OwnershipSelection, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShareClass, type ShortInterest, type ShortInterestDataPoint, type ShortVolume, type ShortVolumeDataPoint, type SimilarStock, type StockDetail, type StockEntity, type StockGraph, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerFilter, type TrackerGeoEntry, type TrackerGetParams, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
5680
+ export { type AISummary, APIError, type AnalystAction, type AnalystCall, type AnalystCalledItCall, type AnalystCalledItMove, type AnalystConsensus, type AnalystConsensusHistory, type AnalystConsensusHistoryPoint, type AnalystCoverage, type AnalystCoverageAnalyst, type AnalystCoverageBookEntry, type AnalystCoverageFirm, type AnalystEarningsSurprise, type AnalystEstimate, type AnalystEstimatePeriodType, type AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AnalystRef, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, type EarlyFilers, type EarningsCalendarResponse, type EarningsEvent, type EarningsKpiHighlight, type EarningsOutcomeStatistics, type EarningsQuarter, type EarningsReaction, type EarningsReactionsResponse, type EarningsSource, type EarningsStatistics, type EarningsStatisticsBaseline, type EarningsStatisticsDeviation, type EarningsStatisticsThresholds, type EarningsStatisticsWindow, type EarningsSummariesResponse, type EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfMembership, type EtfQuote, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, type ExtendedHoursInfo, type FeaturedScreen, type FloatInfo, type Fundamentals, type FundamentalsPeriod, type FundamentalsPeriodsResponse, type GetAnalystActionsOptions, type GetAnalystCalledItOptions, type GetAnalystCallsOptions, type GetAnalystConsensusHistoryOptions, type GetAnalystCoverageOptions, type GetAnalystMarketActivityOptions, type GetEarningsCalendarOptions, type GetEarningsStatisticsOptions, type GetEarningsSummariesOptions, type GetEtfInsiderAggregateOptions, type GetHoldersHistoryOptions, type GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetInstitutionDetailOptions, type GetInstitutionHistoryOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetOptionsIntradayHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetShortInterestOptions, type GetShortVolumeOptions, type GetStockEtfsOptions, type GetStockGraphOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type GraphCounts, type GraphEdge, type GraphGroups, type GraphNode, type GraphProductFamily, type Holder, type HolderComparisonStatus, type HolderNotableChanges, type HoldersHistory, type HoldersHistoryQuarter, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionChangeFilter, type InstitutionChangeType, type InstitutionDetail, type InstitutionHistory, type InstitutionHistoryQuarter, type InstitutionHolding, type InstitutionList, type InstitutionListResponse, type InstitutionMatchTotals, type InstitutionPositionPoint, type InstitutionSummary, type InstitutionalFlow, type InstitutionalFlows, type InstitutionalFlowsResponse, type KBEntity, type KpiCoverageEntry, type KpiCoverageResponse, type KpiDataPoint, type KpiSeries, type KpiTypeEntry, type ListInstitutionsOptions, type LockedInsight, type MarketMood, type MarketMoodOptions, type MarketStatus, type MarketSummary, type MetricDistribution, type MetricDistributionOptions, type MetricType, type MetricsBreakdown, type MetricsOptions, NotFoundError, type NotableHolder, type OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsIntradayHistory, type OptionsIntradayPoint, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, type OwnershipSelection, type PoliticianDetail, type PoliticianDirectory, type PoliticianDirectoryEntry, type PoliticianDirectoryResponse, type PoliticianSummary, type PreviewResponse, type Quarter, type RankedEarnings, type RankedEarningsSection, type RankedReportedEarnings, type RankedUpcomingEarnings, RateLimitError, type RatingBase, type RatingDimension, type RatingDimensionKey, type RatingFlag, type RatingNotRatedReason, type RatingSubLeg, type RecentEarningsEntry, type RiskAdjustment, type RiskCondition, type ScreenerExecuteOptions, type ScreenerExecuteResponse, type ScreenerFieldCatalog, type ScreenerFieldDescriptor, type ScreenerFieldOption, type ScreenerFilter, type ScreenerPlan, type ScreenerRow, type ScreenerScreensResponse, type ScreenerSort, type SearchEntitiesOptions, type SearchStoriesOptions, SentiSense, SentiSenseError, type SentiSenseOptions, type SentimentEntry, type ServingMetric, type ShareClass, type ShortInterest, type ShortInterestDataPoint, type ShortVolume, type ShortVolumeDataPoint, type SimilarStock, type StockDetail, type StockEntity, type StockGraph, type StockImage, type StockNotRated, type StockPrice, type StockProfile, type StockQuote, type StockRating, type StockRatingResponse, type StockSocialDominance, type Story, type StoryCluster, type StoryTimelineEntry, TemporarilyUnavailableError, type TickerHolders, type TrackerEvent, type TrackerFilter, type TrackerGeoEntry, type TrackerGetParams, type TrackerHeadlineMetric, type TrackerListResponse, type TrackerListing, type TrackerMetricValue, type TrackerSignal, type TrackerSnapshot, type TrackerSnapshotResponse, type TrackerSourceRef, type TrackerTableRow, type TrackerTimeSeriesPoint, type TtmFundamentals, VERSION, type WeightedConsensus, type WeightedNetFlow, SentiSense as default };
package/dist/index.mjs CHANGED
@@ -96,6 +96,10 @@ var Analyst = class {
96
96
  /**
97
97
  * Get recent analyst upgrade/downgrade actions for a ticker, newest first.
98
98
  * Free users receive the 3 most recent.
99
+ *
100
+ * Each row carries `priceTarget`, the target the firm stated with the action, and
101
+ * `priorPriceTarget`, the target it moved from (PRO; `null` on free preview rows,
102
+ * `null` when the firm stated none or kept its target unchanged).
99
103
  */
100
104
  async actions(ticker, options) {
101
105
  return this.client.get(
@@ -115,6 +119,10 @@ var Analyst = class {
115
119
  /**
116
120
  * Get market-wide recent analyst actions across all covered tickers, newest first.
117
121
  * Free users receive the 5 most recent.
122
+ *
123
+ * Rows carry the same `priceTarget` and `priorPriceTarget` as {@link actions} (PRO;
124
+ * `null` on free preview rows). This feed does not check for stock splits, so for a
125
+ * stock that split inside the window, read its targets from {@link actions}.
118
126
  */
119
127
  async marketActivity(options) {
120
128
  return this.client.get("/api/v1/analyst/activity", options);
@@ -1142,6 +1150,19 @@ var Stocks = class {
1142
1150
  async getSimilar(ticker, options) {
1143
1151
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/similar`, options);
1144
1152
  }
1153
+ /**
1154
+ * List the ETFs that hold a stock, heaviest weight first.
1155
+ *
1156
+ * Resolves to a bare array (no preview envelope) on every tier, sorted by `weightPct`
1157
+ * descending, then `etfTicker` ascending. A ticker no tracked fund holds, or an unknown
1158
+ * ticker, resolves to `[]` rather than throwing. Only funds SentiSense tracks with a
1159
+ * holdings file are searched, and some funds' holdings are partial, so the list is not
1160
+ * every fund in the market. `ticker` is case-insensitive. Counts against the monthly
1161
+ * quota like other data endpoints.
1162
+ */
1163
+ async getEtfs(ticker, options) {
1164
+ return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/etfs`, options);
1165
+ }
1145
1166
  /** Get company profile (CEO, sector, industry, market data). */
1146
1167
  async getProfile(ticker, options) {
1147
1168
  return this.client.get(`/api/v1/stocks/${encodeURIComponent(ticker)}/profile`, options);
@@ -1515,7 +1536,7 @@ function serializeTrackerParams(params) {
1515
1536
  }
1516
1537
 
1517
1538
  // src/version.ts
1518
- var VERSION = "0.75.1";
1539
+ var VERSION = "0.77.0";
1519
1540
 
1520
1541
  // src/client.ts
1521
1542
  var DEFAULT_BASE_URL = "https://app.sentisense.ai";