sentisense 0.60.0 → 0.61.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 +2 -0
- package/dist/cli.cjs +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.mts +122 -4
- package/dist/index.d.ts +122 -4
- package/dist/index.mjs +1 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/dist/index.d.mts
CHANGED
|
@@ -510,6 +510,23 @@ interface GetFundamentalsOptions {
|
|
|
510
510
|
fiscalPeriod?: string;
|
|
511
511
|
fiscalYear?: number;
|
|
512
512
|
}
|
|
513
|
+
/**
|
|
514
|
+
* The open-interest follow-up for one contract, as carried by an aggregate's `unusualOi`
|
|
515
|
+
* list: the same fields an unusual contract carries, keyed by symbol.
|
|
516
|
+
*/
|
|
517
|
+
interface OptionsOiFollowUp {
|
|
518
|
+
/** Exchange-style option symbol. */
|
|
519
|
+
contract?: string;
|
|
520
|
+
oiPrior?: number;
|
|
521
|
+
oiNext?: number;
|
|
522
|
+
oiChange?: number;
|
|
523
|
+
/** Net open-interest change: opened, closed, mixed, pending, or unmatched. */
|
|
524
|
+
oiConfirmation?: "opened" | "closed" | "mixed" | "pending" | "unmatched";
|
|
525
|
+
/** Open-interest observation time in UTC epoch seconds. */
|
|
526
|
+
oiObservedAt?: number;
|
|
527
|
+
/** Which chain supplied the observed open interest. */
|
|
528
|
+
oiVintage?: "prior_settle" | "settled" | "next_session";
|
|
529
|
+
}
|
|
513
530
|
/**
|
|
514
531
|
* One session's aggregate options activity for a ticker.
|
|
515
532
|
*
|
|
@@ -565,6 +582,17 @@ interface OptionsAggregate {
|
|
|
565
582
|
contracts?: number;
|
|
566
583
|
/** Largest unusual-contract premium this session; zero when none qualified. */
|
|
567
584
|
maxUnusualPremium?: number;
|
|
585
|
+
/**
|
|
586
|
+
* Premium of the session's highlight contract: the largest qualifying premium with an
|
|
587
|
+
* expiry at least one day after the session. Zero when the session was evaluated and none
|
|
588
|
+
* qualified; absent on sessions recorded before this rule existed.
|
|
589
|
+
*/
|
|
590
|
+
maxUnusualPremiumEx0dte?: number;
|
|
591
|
+
/**
|
|
592
|
+
* Open-interest follow-up for the session's unusual contracts, plus its highlight contract
|
|
593
|
+
* when that is not one of them. Absent until the follow-up has been read.
|
|
594
|
+
*/
|
|
595
|
+
unusualOi?: OptionsOiFollowUp[];
|
|
568
596
|
}
|
|
569
597
|
/**
|
|
570
598
|
* Percentile context for {@link OptionsAggregate}, against that ticker's own trailing
|
|
@@ -620,11 +648,69 @@ interface OptionsUnusualContract {
|
|
|
620
648
|
/** Which chain supplied the observed open interest. */
|
|
621
649
|
oiVintage?: "prior_settle" | "settled" | "next_session";
|
|
622
650
|
}
|
|
651
|
+
/**
|
|
652
|
+
* A ticker's row on today's intraday options board, reduced to counts and the board's own
|
|
653
|
+
* clock. It carries no contract symbol, strike, price or premium.
|
|
654
|
+
*
|
|
655
|
+
* The board is rebuilt every 15 minutes during the session from 15-minute delayed chains;
|
|
656
|
+
* the contract-level board itself is in the SentiSense app, not the API.
|
|
657
|
+
*/
|
|
658
|
+
interface OptionsIntradayFlow {
|
|
659
|
+
/** Contracts on the ticker's row passing the unusual rule so far this session, up to 5. */
|
|
660
|
+
unusualCount?: number;
|
|
661
|
+
/** Earliest board cycle that flagged one of them, `"HH:mm ET"`. Absent when none. */
|
|
662
|
+
firstSeenEt?: string;
|
|
663
|
+
/** `firstSeenEt` as Unix epoch seconds. */
|
|
664
|
+
firstSeenAt?: number;
|
|
665
|
+
/**
|
|
666
|
+
* Percentile (0-100) of the ticker's intraday highlight contract against its own history.
|
|
667
|
+
* Present only for highlighted tickers, and absent while that history holds fewer than 60
|
|
668
|
+
* sessions.
|
|
669
|
+
*/
|
|
670
|
+
flowPctl1y?: number;
|
|
671
|
+
/** The board's snapshot time, `"HH:mm ET"`. */
|
|
672
|
+
asOfEt?: string;
|
|
673
|
+
/**
|
|
674
|
+
* The same instant as Unix epoch seconds. Unlike the dossier's own `asOf`, which is an ISO
|
|
675
|
+
* date, this one is a timestamp.
|
|
676
|
+
*/
|
|
677
|
+
asOf?: number;
|
|
678
|
+
/** `true` while the board updates during the session, `false` once it has stopped. */
|
|
679
|
+
live?: boolean;
|
|
680
|
+
/** How far the board's chain data trails the market, in minutes. */
|
|
681
|
+
delayMinutes?: number;
|
|
682
|
+
}
|
|
683
|
+
/**
|
|
684
|
+
* Where the intraday options board lives and who can open it. Describes the board, not the
|
|
685
|
+
* data: `apiData` is `false` because its rows are app-only.
|
|
686
|
+
*/
|
|
687
|
+
interface OptionsIntradayBoardCapability {
|
|
688
|
+
/** `true` when the app offers the board. */
|
|
689
|
+
available?: boolean;
|
|
690
|
+
/**
|
|
691
|
+
* Who can open the board in the app: `"signed_in_pro"` (any signed-in PRO account) or
|
|
692
|
+
* `"power_user"` (an early-access group). New values may appear.
|
|
693
|
+
*/
|
|
694
|
+
access?: "signed_in_pro" | "power_user" | (string & {});
|
|
695
|
+
/** `false`: the board's rows are app-only, and the API serves only the derived fields. */
|
|
696
|
+
apiData?: boolean;
|
|
697
|
+
/** The board's data delay, in minutes. */
|
|
698
|
+
delayMinutes?: number;
|
|
699
|
+
/** The Options page in the app. */
|
|
700
|
+
url?: string;
|
|
701
|
+
}
|
|
702
|
+
/** Product capabilities that ride the options responses. */
|
|
703
|
+
interface OptionsCapabilities {
|
|
704
|
+
intradayBoard?: OptionsIntradayBoardCapability;
|
|
705
|
+
}
|
|
623
706
|
/**
|
|
624
707
|
* The options dossier for one stock or ETF, from `client.stocks.getOptionsSummary()`.
|
|
625
708
|
*
|
|
626
709
|
* End of day, not live: it describes the latest completed session and refreshes the
|
|
627
|
-
* following morning.
|
|
710
|
+
* following morning. The exception is the intraday session fields (`intradayFlow`,
|
|
711
|
+
* `largePrintCount`, `largestPrintPctl`, `capabilities`), which are the same on every tier,
|
|
712
|
+
* previews included, and are omitted when their source is absent: `intradayFlow` before the
|
|
713
|
+
* day's first board or when the ticker has no row on it.
|
|
628
714
|
*/
|
|
629
715
|
interface OptionsSummary {
|
|
630
716
|
/** Session the dossier describes, ISO calendar day. */
|
|
@@ -643,6 +729,20 @@ interface OptionsSummary {
|
|
|
643
729
|
oiWalls?: OptionsOiWalls;
|
|
644
730
|
/** Top contracts by premium. */
|
|
645
731
|
unusual?: OptionsUnusualContract[];
|
|
732
|
+
/** The ticker's row on today's intraday board. */
|
|
733
|
+
intradayFlow?: OptionsIntradayFlow;
|
|
734
|
+
/**
|
|
735
|
+
* Large prints for the ticker (one contract's fills clustered into a single order after the
|
|
736
|
+
* close) in the latest published prints session, up to 25; `0` when it has none.
|
|
737
|
+
*/
|
|
738
|
+
largePrintCount?: number;
|
|
739
|
+
/**
|
|
740
|
+
* Highest percentile (0-100) among those prints, each print's premium against the ticker's
|
|
741
|
+
* own trailing prints. Absent when none is scored.
|
|
742
|
+
*/
|
|
743
|
+
largestPrintPctl?: number;
|
|
744
|
+
/** Where the intraday board lives and who can open it. */
|
|
745
|
+
capabilities?: OptionsCapabilities;
|
|
646
746
|
}
|
|
647
747
|
/** Trailing window for `client.stocks.getOptionsHistory()`. */
|
|
648
748
|
type OptionsHistoryWindow = "1y" | "2y" | "5y";
|
|
@@ -789,7 +889,10 @@ interface OptionsHighlight {
|
|
|
789
889
|
* `coverageCount` describe the stock board only; the four `etf`-prefixed fields describe
|
|
790
890
|
* the ETF board and are omitted entirely when a build has no ETF rows.
|
|
791
891
|
*
|
|
792
|
-
* End of day, not live: `asOf` is the latest completed session.
|
|
892
|
+
* End of day, not live: `asOf` is the latest completed session. The exception is
|
|
893
|
+
* `intradayActiveCount`, `intradayRanking` and `capabilities`, which summarize today's
|
|
894
|
+
* intraday board across stocks, are the same on every tier, and are omitted before the day's
|
|
895
|
+
* first board.
|
|
793
896
|
*/
|
|
794
897
|
interface OptionsOverview {
|
|
795
898
|
/** Session the build describes, ISO calendar day. */
|
|
@@ -820,6 +923,21 @@ interface OptionsOverview {
|
|
|
820
923
|
etfCoverageCount?: number;
|
|
821
924
|
/** Full ETF board size on a FREE response, mirroring what the envelope's `totalCount` does for stocks. */
|
|
822
925
|
etfTotalCount?: number;
|
|
926
|
+
/** When this board was built, Unix epoch seconds (UTC). Pair it with `asOf`. */
|
|
927
|
+
builtAt?: number;
|
|
928
|
+
/**
|
|
929
|
+
* The rule the stock `highlights` were chosen by, `"ex0dte-v1"`. Absent when that list was
|
|
930
|
+
* built before the rule existed.
|
|
931
|
+
*/
|
|
932
|
+
highlightPolicy?: string;
|
|
933
|
+
/** The same for `etfHighlights`. */
|
|
934
|
+
etfHighlightPolicy?: string;
|
|
935
|
+
/** Stocks on today's intraday board with at least one unusual contract so far. Stock board only. */
|
|
936
|
+
intradayActiveCount?: number;
|
|
937
|
+
/** Up to 25 of those tickers, most unusual for their own history first. */
|
|
938
|
+
intradayRanking?: string[];
|
|
939
|
+
/** Where the intraday board lives and who can open it. */
|
|
940
|
+
capabilities?: OptionsCapabilities;
|
|
823
941
|
}
|
|
824
942
|
/** The seven dimensions the composite is blended from, by stable `key`. */
|
|
825
943
|
type RatingDimensionKey = "crowd" | "smart_money" | "options" | "analysts" | "fundamentals" | "earnings" | "technicals";
|
|
@@ -4277,6 +4395,6 @@ declare class APIError extends SentiSenseError {
|
|
|
4277
4395
|
constructor(message: string, status: number, code?: string);
|
|
4278
4396
|
}
|
|
4279
4397
|
|
|
4280
|
-
declare const VERSION = "0.
|
|
4398
|
+
declare const VERSION = "0.61.0";
|
|
4281
4399
|
|
|
4282
|
-
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 AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, 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 EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, 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 GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, 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 OptionsAggregate, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, 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 ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, 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 TrackerGeoEntry, 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 };
|
|
4400
|
+
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 AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, 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 EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, 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 GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, 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 OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, 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 ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, 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 TrackerGeoEntry, 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
|
@@ -510,6 +510,23 @@ interface GetFundamentalsOptions {
|
|
|
510
510
|
fiscalPeriod?: string;
|
|
511
511
|
fiscalYear?: number;
|
|
512
512
|
}
|
|
513
|
+
/**
|
|
514
|
+
* The open-interest follow-up for one contract, as carried by an aggregate's `unusualOi`
|
|
515
|
+
* list: the same fields an unusual contract carries, keyed by symbol.
|
|
516
|
+
*/
|
|
517
|
+
interface OptionsOiFollowUp {
|
|
518
|
+
/** Exchange-style option symbol. */
|
|
519
|
+
contract?: string;
|
|
520
|
+
oiPrior?: number;
|
|
521
|
+
oiNext?: number;
|
|
522
|
+
oiChange?: number;
|
|
523
|
+
/** Net open-interest change: opened, closed, mixed, pending, or unmatched. */
|
|
524
|
+
oiConfirmation?: "opened" | "closed" | "mixed" | "pending" | "unmatched";
|
|
525
|
+
/** Open-interest observation time in UTC epoch seconds. */
|
|
526
|
+
oiObservedAt?: number;
|
|
527
|
+
/** Which chain supplied the observed open interest. */
|
|
528
|
+
oiVintage?: "prior_settle" | "settled" | "next_session";
|
|
529
|
+
}
|
|
513
530
|
/**
|
|
514
531
|
* One session's aggregate options activity for a ticker.
|
|
515
532
|
*
|
|
@@ -565,6 +582,17 @@ interface OptionsAggregate {
|
|
|
565
582
|
contracts?: number;
|
|
566
583
|
/** Largest unusual-contract premium this session; zero when none qualified. */
|
|
567
584
|
maxUnusualPremium?: number;
|
|
585
|
+
/**
|
|
586
|
+
* Premium of the session's highlight contract: the largest qualifying premium with an
|
|
587
|
+
* expiry at least one day after the session. Zero when the session was evaluated and none
|
|
588
|
+
* qualified; absent on sessions recorded before this rule existed.
|
|
589
|
+
*/
|
|
590
|
+
maxUnusualPremiumEx0dte?: number;
|
|
591
|
+
/**
|
|
592
|
+
* Open-interest follow-up for the session's unusual contracts, plus its highlight contract
|
|
593
|
+
* when that is not one of them. Absent until the follow-up has been read.
|
|
594
|
+
*/
|
|
595
|
+
unusualOi?: OptionsOiFollowUp[];
|
|
568
596
|
}
|
|
569
597
|
/**
|
|
570
598
|
* Percentile context for {@link OptionsAggregate}, against that ticker's own trailing
|
|
@@ -620,11 +648,69 @@ interface OptionsUnusualContract {
|
|
|
620
648
|
/** Which chain supplied the observed open interest. */
|
|
621
649
|
oiVintage?: "prior_settle" | "settled" | "next_session";
|
|
622
650
|
}
|
|
651
|
+
/**
|
|
652
|
+
* A ticker's row on today's intraday options board, reduced to counts and the board's own
|
|
653
|
+
* clock. It carries no contract symbol, strike, price or premium.
|
|
654
|
+
*
|
|
655
|
+
* The board is rebuilt every 15 minutes during the session from 15-minute delayed chains;
|
|
656
|
+
* the contract-level board itself is in the SentiSense app, not the API.
|
|
657
|
+
*/
|
|
658
|
+
interface OptionsIntradayFlow {
|
|
659
|
+
/** Contracts on the ticker's row passing the unusual rule so far this session, up to 5. */
|
|
660
|
+
unusualCount?: number;
|
|
661
|
+
/** Earliest board cycle that flagged one of them, `"HH:mm ET"`. Absent when none. */
|
|
662
|
+
firstSeenEt?: string;
|
|
663
|
+
/** `firstSeenEt` as Unix epoch seconds. */
|
|
664
|
+
firstSeenAt?: number;
|
|
665
|
+
/**
|
|
666
|
+
* Percentile (0-100) of the ticker's intraday highlight contract against its own history.
|
|
667
|
+
* Present only for highlighted tickers, and absent while that history holds fewer than 60
|
|
668
|
+
* sessions.
|
|
669
|
+
*/
|
|
670
|
+
flowPctl1y?: number;
|
|
671
|
+
/** The board's snapshot time, `"HH:mm ET"`. */
|
|
672
|
+
asOfEt?: string;
|
|
673
|
+
/**
|
|
674
|
+
* The same instant as Unix epoch seconds. Unlike the dossier's own `asOf`, which is an ISO
|
|
675
|
+
* date, this one is a timestamp.
|
|
676
|
+
*/
|
|
677
|
+
asOf?: number;
|
|
678
|
+
/** `true` while the board updates during the session, `false` once it has stopped. */
|
|
679
|
+
live?: boolean;
|
|
680
|
+
/** How far the board's chain data trails the market, in minutes. */
|
|
681
|
+
delayMinutes?: number;
|
|
682
|
+
}
|
|
683
|
+
/**
|
|
684
|
+
* Where the intraday options board lives and who can open it. Describes the board, not the
|
|
685
|
+
* data: `apiData` is `false` because its rows are app-only.
|
|
686
|
+
*/
|
|
687
|
+
interface OptionsIntradayBoardCapability {
|
|
688
|
+
/** `true` when the app offers the board. */
|
|
689
|
+
available?: boolean;
|
|
690
|
+
/**
|
|
691
|
+
* Who can open the board in the app: `"signed_in_pro"` (any signed-in PRO account) or
|
|
692
|
+
* `"power_user"` (an early-access group). New values may appear.
|
|
693
|
+
*/
|
|
694
|
+
access?: "signed_in_pro" | "power_user" | (string & {});
|
|
695
|
+
/** `false`: the board's rows are app-only, and the API serves only the derived fields. */
|
|
696
|
+
apiData?: boolean;
|
|
697
|
+
/** The board's data delay, in minutes. */
|
|
698
|
+
delayMinutes?: number;
|
|
699
|
+
/** The Options page in the app. */
|
|
700
|
+
url?: string;
|
|
701
|
+
}
|
|
702
|
+
/** Product capabilities that ride the options responses. */
|
|
703
|
+
interface OptionsCapabilities {
|
|
704
|
+
intradayBoard?: OptionsIntradayBoardCapability;
|
|
705
|
+
}
|
|
623
706
|
/**
|
|
624
707
|
* The options dossier for one stock or ETF, from `client.stocks.getOptionsSummary()`.
|
|
625
708
|
*
|
|
626
709
|
* End of day, not live: it describes the latest completed session and refreshes the
|
|
627
|
-
* following morning.
|
|
710
|
+
* following morning. The exception is the intraday session fields (`intradayFlow`,
|
|
711
|
+
* `largePrintCount`, `largestPrintPctl`, `capabilities`), which are the same on every tier,
|
|
712
|
+
* previews included, and are omitted when their source is absent: `intradayFlow` before the
|
|
713
|
+
* day's first board or when the ticker has no row on it.
|
|
628
714
|
*/
|
|
629
715
|
interface OptionsSummary {
|
|
630
716
|
/** Session the dossier describes, ISO calendar day. */
|
|
@@ -643,6 +729,20 @@ interface OptionsSummary {
|
|
|
643
729
|
oiWalls?: OptionsOiWalls;
|
|
644
730
|
/** Top contracts by premium. */
|
|
645
731
|
unusual?: OptionsUnusualContract[];
|
|
732
|
+
/** The ticker's row on today's intraday board. */
|
|
733
|
+
intradayFlow?: OptionsIntradayFlow;
|
|
734
|
+
/**
|
|
735
|
+
* Large prints for the ticker (one contract's fills clustered into a single order after the
|
|
736
|
+
* close) in the latest published prints session, up to 25; `0` when it has none.
|
|
737
|
+
*/
|
|
738
|
+
largePrintCount?: number;
|
|
739
|
+
/**
|
|
740
|
+
* Highest percentile (0-100) among those prints, each print's premium against the ticker's
|
|
741
|
+
* own trailing prints. Absent when none is scored.
|
|
742
|
+
*/
|
|
743
|
+
largestPrintPctl?: number;
|
|
744
|
+
/** Where the intraday board lives and who can open it. */
|
|
745
|
+
capabilities?: OptionsCapabilities;
|
|
646
746
|
}
|
|
647
747
|
/** Trailing window for `client.stocks.getOptionsHistory()`. */
|
|
648
748
|
type OptionsHistoryWindow = "1y" | "2y" | "5y";
|
|
@@ -789,7 +889,10 @@ interface OptionsHighlight {
|
|
|
789
889
|
* `coverageCount` describe the stock board only; the four `etf`-prefixed fields describe
|
|
790
890
|
* the ETF board and are omitted entirely when a build has no ETF rows.
|
|
791
891
|
*
|
|
792
|
-
* End of day, not live: `asOf` is the latest completed session.
|
|
892
|
+
* End of day, not live: `asOf` is the latest completed session. The exception is
|
|
893
|
+
* `intradayActiveCount`, `intradayRanking` and `capabilities`, which summarize today's
|
|
894
|
+
* intraday board across stocks, are the same on every tier, and are omitted before the day's
|
|
895
|
+
* first board.
|
|
793
896
|
*/
|
|
794
897
|
interface OptionsOverview {
|
|
795
898
|
/** Session the build describes, ISO calendar day. */
|
|
@@ -820,6 +923,21 @@ interface OptionsOverview {
|
|
|
820
923
|
etfCoverageCount?: number;
|
|
821
924
|
/** Full ETF board size on a FREE response, mirroring what the envelope's `totalCount` does for stocks. */
|
|
822
925
|
etfTotalCount?: number;
|
|
926
|
+
/** When this board was built, Unix epoch seconds (UTC). Pair it with `asOf`. */
|
|
927
|
+
builtAt?: number;
|
|
928
|
+
/**
|
|
929
|
+
* The rule the stock `highlights` were chosen by, `"ex0dte-v1"`. Absent when that list was
|
|
930
|
+
* built before the rule existed.
|
|
931
|
+
*/
|
|
932
|
+
highlightPolicy?: string;
|
|
933
|
+
/** The same for `etfHighlights`. */
|
|
934
|
+
etfHighlightPolicy?: string;
|
|
935
|
+
/** Stocks on today's intraday board with at least one unusual contract so far. Stock board only. */
|
|
936
|
+
intradayActiveCount?: number;
|
|
937
|
+
/** Up to 25 of those tickers, most unusual for their own history first. */
|
|
938
|
+
intradayRanking?: string[];
|
|
939
|
+
/** Where the intraday board lives and who can open it. */
|
|
940
|
+
capabilities?: OptionsCapabilities;
|
|
823
941
|
}
|
|
824
942
|
/** The seven dimensions the composite is blended from, by stable `key`. */
|
|
825
943
|
type RatingDimensionKey = "crowd" | "smart_money" | "options" | "analysts" | "fundamentals" | "earnings" | "technicals";
|
|
@@ -4277,6 +4395,6 @@ declare class APIError extends SentiSenseError {
|
|
|
4277
4395
|
constructor(message: string, status: number, code?: string);
|
|
4278
4396
|
}
|
|
4279
4397
|
|
|
4280
|
-
declare const VERSION = "0.
|
|
4398
|
+
declare const VERSION = "0.61.0";
|
|
4281
4399
|
|
|
4282
|
-
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 AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, 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 EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, 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 GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, 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 OptionsAggregate, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, 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 ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, 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 TrackerGeoEntry, 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 };
|
|
4400
|
+
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 AnalystEstimatesResponse, type AnalystFirmRating, type AnalystFirmTenure, type AnalystNote, type AnalystProfile, type AnalystRatingBuckets, type AssetMetadata, AuthenticationError, type CalendarMeta, type ChartData, type ChartDataPoint, type ClusterBuy, type CompanyKpisData, type CongressTrade, DeepHistoryUnavailableError, type Document, type DocumentSearchResponse, type DocumentSource, 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 EntitySearchResult, type EntitySearchType, type EtfAggregateCoverage, type EtfAnalystAggregate, type EtfAnalystContributor, type EtfHolding, type EtfHoldings, type EtfInfo, type EtfInsiderAggregate, type EtfInsiderContributor, type EtfScreenerExecuteResponse, type EtfScreenerRow, type EtfSentimentAggregate, type EtfSentimentReading, 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 GetHoldersOptions, type GetInsiderOptions, type GetInsightsOptions, type GetLatestInsightsOptions, type GetOptionsHistoryOptions, type GetPoliticianActivityOptions, type GetPoliticianDirectoryOptions, type GetPoliticianMemberOptions, type GetPoliticiansOptions, type GetRankedEarningsOptions, type GetRecentEarningsOptions, type GetStockInsightsRangeOptions, type GetUserInsightsOptions, type Holder, type HolderNotableChanges, type IndexConstituent, type IndexHistoryPoint, type IndexHistoryResponse, type IndexListResponse, type IndexListing, type IndexSnapshot, type InsiderActivityResponse, type InsiderActivitySummary, type InsiderTrade, type Insight, type InsightPreviewResponse, type InstitutionList, type InstitutionListResponse, 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 OptionsAggregate, type OptionsCapabilities, type OptionsContext, type OptionsHighlight, type OptionsHistory, type OptionsHistoryWindow, type OptionsIntradayBoardCapability, type OptionsIntradayFlow, type OptionsOiFollowUp, type OptionsOiWalls, type OptionsOverview, type OptionsOverviewRow, type OptionsSummary, type OptionsUnusualContract, type OptionsWall, 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 ShortInterest, type ShortVolume, type SimilarStock, type StockDetail, type StockEntity, 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 TrackerGeoEntry, 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 };
|