propline 0.56.0 → 0.58.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.cts CHANGED
@@ -571,6 +571,42 @@ interface ResolutionSummary {
571
571
  top_markets: ResolutionSummaryMarket[];
572
572
  [k: string]: unknown;
573
573
  }
574
+ /** One book's row in the sportsbook accuracy report. */
575
+ interface BookAccuracyRow {
576
+ key: string;
577
+ title: string;
578
+ /** Graded props scored for this book. */
579
+ props: number;
580
+ /** Brier score of the book's de-vigged closing prices (lower = better). */
581
+ brier: number;
582
+ /** Brier score of the other books' consensus on the same lines. */
583
+ consensus_brier: number;
584
+ /** Skill vs the market in basis points; > 0 = closer to the result. */
585
+ skill_bp: number;
586
+ /** 95% confidence interval for skill_bp. */
587
+ skill_ci95_bp: [number, number];
588
+ verdict: "beats_market" | "trails_market" | "in_line";
589
+ /** The book's average overround, in percent. */
590
+ margin_pct: number;
591
+ [k: string]: unknown;
592
+ }
593
+ /** Response of GET /v1/books/accuracy. A pricing report, not a profit claim. */
594
+ interface BookAccuracyReport {
595
+ days: number;
596
+ sport: string | null;
597
+ method: string;
598
+ total_props: number;
599
+ books: BookAccuracyRow[];
600
+ by_sport: Record<string, BookAccuracyRow[]>;
601
+ by_market: Record<string, BookAccuracyRow[]>;
602
+ [k: string]: unknown;
603
+ }
604
+ interface BookAccuracyOptions {
605
+ /** Look-back window, 7-120 (default 30). */
606
+ days?: number;
607
+ /** Optional sport key, e.g. "baseball_mlb". */
608
+ sport?: string;
609
+ }
574
610
  interface PlayerStat {
575
611
  player_name: string;
576
612
  team_abbr: string;
@@ -893,6 +929,8 @@ interface PlayerGame {
893
929
  }
894
930
  interface PlayerGameLog {
895
931
  player_name: string;
932
+ /** Stable cross-book player id (e.g. `"mlb:677951"`); null when none yet. */
933
+ player_id: string | null;
896
934
  sport_key: string;
897
935
  /** Echo of the `opponent` filter, or null. */
898
936
  opponent: string | null;
@@ -1664,6 +1702,13 @@ interface GetEventEvOptions {
1664
1702
  * on a +600 anytime scorer. The response echoes it as `devig_method`.
1665
1703
  */
1666
1704
  devig?: "multiplicative" | "shin";
1705
+ /**
1706
+ * Override the fair-line anchor: one book or a list tried IN ORDER per
1707
+ * line, from `pinnacle`, `polymarket`, `kalshi`, `bovada`, `smarkets`.
1708
+ * A line none of them anchors is dropped; any other value is a 400.
1709
+ * Omit for the default order.
1710
+ */
1711
+ fairSource?: string | string[];
1667
1712
  }
1668
1713
  interface GetEventBestLineOptions {
1669
1714
  /**
@@ -1977,6 +2022,14 @@ declare class PropLine {
1977
2022
  * @param days Look-back window, 1-90 (default 30).
1978
2023
  */
1979
2024
  getResolutionSummary(days?: number): Promise<ResolutionSummary>;
2025
+ /**
2026
+ * Sportsbook accuracy report (free tier): each book's closing player-prop
2027
+ * prices, de-vigged and scored against the real result and against the
2028
+ * other books on the same line. `skill_bp` > 0 = closer to the result than
2029
+ * the market average; `margin_pct` = the book's average overround.
2030
+ * A pricing report, never a profit claim.
2031
+ */
2032
+ getBookAccuracy(options?: BookAccuracyOptions): Promise<BookAccuracyReport>;
1980
2033
  /**
1981
2034
  * Get raw player/team box-score stats (book-agnostic, free tier).
1982
2035
  *
@@ -2054,6 +2107,9 @@ declare class PropLine {
2054
2107
  * built from {@link getPlayerHistory} or {@link getPlayerTrends}. Carries
2055
2108
  * no line, price or grade.
2056
2109
  *
2110
+ * `playerName` may also be a stable `player_id` (e.g. `"mlb:677951"`),
2111
+ * which skips name matching; the response carries it back as `player_id`.
2112
+ *
2057
2113
  * @example
2058
2114
  * ```ts
2059
2115
  * const log = await client.getPlayerGames("baseball_mlb", "Aaron Judge", { limit: 10 });
@@ -2461,6 +2517,6 @@ declare const Bookmakers: {
2461
2517
  readonly PRIZEPICKS: "prizepicks";
2462
2518
  };
2463
2519
  type BookmakerKey = (typeof Bookmakers)[keyof typeof Bookmakers];
2464
- declare const VERSION = "0.56.0";
2520
+ declare const VERSION = "0.58.0";
2465
2521
 
2466
- export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
2522
+ export { AuthError, type BestLine, type BestLineSide, type BestPrice, type BookAccuracyOptions, type BookAccuracyReport, type BookAccuracyRow, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
package/dist/index.d.ts CHANGED
@@ -571,6 +571,42 @@ interface ResolutionSummary {
571
571
  top_markets: ResolutionSummaryMarket[];
572
572
  [k: string]: unknown;
573
573
  }
574
+ /** One book's row in the sportsbook accuracy report. */
575
+ interface BookAccuracyRow {
576
+ key: string;
577
+ title: string;
578
+ /** Graded props scored for this book. */
579
+ props: number;
580
+ /** Brier score of the book's de-vigged closing prices (lower = better). */
581
+ brier: number;
582
+ /** Brier score of the other books' consensus on the same lines. */
583
+ consensus_brier: number;
584
+ /** Skill vs the market in basis points; > 0 = closer to the result. */
585
+ skill_bp: number;
586
+ /** 95% confidence interval for skill_bp. */
587
+ skill_ci95_bp: [number, number];
588
+ verdict: "beats_market" | "trails_market" | "in_line";
589
+ /** The book's average overround, in percent. */
590
+ margin_pct: number;
591
+ [k: string]: unknown;
592
+ }
593
+ /** Response of GET /v1/books/accuracy. A pricing report, not a profit claim. */
594
+ interface BookAccuracyReport {
595
+ days: number;
596
+ sport: string | null;
597
+ method: string;
598
+ total_props: number;
599
+ books: BookAccuracyRow[];
600
+ by_sport: Record<string, BookAccuracyRow[]>;
601
+ by_market: Record<string, BookAccuracyRow[]>;
602
+ [k: string]: unknown;
603
+ }
604
+ interface BookAccuracyOptions {
605
+ /** Look-back window, 7-120 (default 30). */
606
+ days?: number;
607
+ /** Optional sport key, e.g. "baseball_mlb". */
608
+ sport?: string;
609
+ }
574
610
  interface PlayerStat {
575
611
  player_name: string;
576
612
  team_abbr: string;
@@ -893,6 +929,8 @@ interface PlayerGame {
893
929
  }
894
930
  interface PlayerGameLog {
895
931
  player_name: string;
932
+ /** Stable cross-book player id (e.g. `"mlb:677951"`); null when none yet. */
933
+ player_id: string | null;
896
934
  sport_key: string;
897
935
  /** Echo of the `opponent` filter, or null. */
898
936
  opponent: string | null;
@@ -1664,6 +1702,13 @@ interface GetEventEvOptions {
1664
1702
  * on a +600 anytime scorer. The response echoes it as `devig_method`.
1665
1703
  */
1666
1704
  devig?: "multiplicative" | "shin";
1705
+ /**
1706
+ * Override the fair-line anchor: one book or a list tried IN ORDER per
1707
+ * line, from `pinnacle`, `polymarket`, `kalshi`, `bovada`, `smarkets`.
1708
+ * A line none of them anchors is dropped; any other value is a 400.
1709
+ * Omit for the default order.
1710
+ */
1711
+ fairSource?: string | string[];
1667
1712
  }
1668
1713
  interface GetEventBestLineOptions {
1669
1714
  /**
@@ -1977,6 +2022,14 @@ declare class PropLine {
1977
2022
  * @param days Look-back window, 1-90 (default 30).
1978
2023
  */
1979
2024
  getResolutionSummary(days?: number): Promise<ResolutionSummary>;
2025
+ /**
2026
+ * Sportsbook accuracy report (free tier): each book's closing player-prop
2027
+ * prices, de-vigged and scored against the real result and against the
2028
+ * other books on the same line. `skill_bp` > 0 = closer to the result than
2029
+ * the market average; `margin_pct` = the book's average overround.
2030
+ * A pricing report, never a profit claim.
2031
+ */
2032
+ getBookAccuracy(options?: BookAccuracyOptions): Promise<BookAccuracyReport>;
1980
2033
  /**
1981
2034
  * Get raw player/team box-score stats (book-agnostic, free tier).
1982
2035
  *
@@ -2054,6 +2107,9 @@ declare class PropLine {
2054
2107
  * built from {@link getPlayerHistory} or {@link getPlayerTrends}. Carries
2055
2108
  * no line, price or grade.
2056
2109
  *
2110
+ * `playerName` may also be a stable `player_id` (e.g. `"mlb:677951"`),
2111
+ * which skips name matching; the response carries it back as `player_id`.
2112
+ *
2057
2113
  * @example
2058
2114
  * ```ts
2059
2115
  * const log = await client.getPlayerGames("baseball_mlb", "Aaron Judge", { limit: 10 });
@@ -2461,6 +2517,6 @@ declare const Bookmakers: {
2461
2517
  readonly PRIZEPICKS: "prizepicks";
2462
2518
  };
2463
2519
  type BookmakerKey = (typeof Bookmakers)[keyof typeof Bookmakers];
2464
- declare const VERSION = "0.56.0";
2520
+ declare const VERSION = "0.58.0";
2465
2521
 
2466
- export { AuthError, type BestLine, type BestLineSide, type BestPrice, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
2522
+ export { AuthError, type BestLine, type BestLineSide, type BestPrice, type BookAccuracyOptions, type BookAccuracyReport, type BookAccuracyRow, type Bookmaker, type BookmakerKey, Bookmakers, type CalcEventEvOptions, type ClosingBookmaker, type ClosingMarket, type ClosingOutcome, type ClvBetInput, type ClvGradeResponse, type ClvGradedBet, type ClvSummary, type ContextResponse, type CreateWebhookOptions, type DepthLevel, type DfsPayoutTier, type DfsPayoutsResponse, type DfsPlayPayout, type EvLine, type EvOutcome, type Event, type EventBestLineResponse, type EventEvCalcResponse, type EventEvResponse, type EventProjectionsResponse, type ExportOddsHistoryOptions, type ExportResolvedPropsOptions, type FuturesEvent, type FuturesMarket, type FuturesOutcome, type GetDfsPayoutsOptions, type GetEventBestLineOptions, type GetEventEvOptions, type GetEventProjectionsOptions, type GetMlbGrandSalamiOptions, type GetMovementOptions, type GetNhlDailyGoalsTotalOptions, type GetOddsClosingOptions, type GetOddsHistoryOptions, type GetOddsOptions, type GetPlayerGamesOptions, type GetPlayerHistoryOptions, type GetPlayerTrendsOptions, type GetResultsOptions, type GetScoresOptions, type GetStatsOptions, type HitRateSplit, type LineMovementPrice, type LineMovementWebhookPayload, type ListWebhookDeliveriesOptions, type Market, type MarketSummary, type MlbGrandSalamiBook, type MlbGrandSalamiResponse, type MovementBookmaker, type MovementMarket, type MovementOutcome, type MovementResponse, type NhlDailyGoalsTotalBook, type NhlDailyGoalsTotalResponse, type OddsClosingResponse, type OddsHistoryBookmaker, type OddsHistoryMarket, type OddsHistoryOutcome, type OddsHistoryResponse, type OddsResponse, type Outcome, type OutcomeSnapshot, type PeriodFilter, type PlayerGame, type PlayerGameLog, type PlayerHistoryEntry, type PlayerHistoryResponse, type PlayerMarketTrend, type PlayerSearchResponse, type PlayerSearchResult, type PlayerStat, type PlayerTrends, type ProjectionRow, PropLine, PropLineError, type PropLineErrorInfo, type PropLineOptions, type QuotaStatus, RateLimitError, type ReplayEvent, type ReplayPage, type ReplayWebhookEventsOptions, type ResolutionSummary, type ResolutionSummaryMarket, type ResolutionSummarySport, type ResolvedOutcome, type ResultsMarket, type ResultsResponse, type ScoreEvent, type SearchPlayersOptions, type SgpBookError, type SgpLegInput, type SgpLegQuote, type SgpMultiQuoteResponse, type SgpQuoteResponse, type Sport, type StatsResponse, type SteamMove, type SteamWebhookPayload, type StreamOptions, type TrendLastGame, type TrendStreak, type UpdateWebhookOptions, VERSION, type VerifySignatureOptions, type WeatherInfo, type Webhook, type WebhookDelivery, type WebhookEventType };
package/dist/index.js CHANGED
@@ -327,6 +327,18 @@ var PropLine = class {
327
327
  { params: { days: String(days) } }
328
328
  );
329
329
  }
330
+ /**
331
+ * Sportsbook accuracy report (free tier): each book's closing player-prop
332
+ * prices, de-vigged and scored against the real result and against the
333
+ * other books on the same line. `skill_bp` > 0 = closer to the result than
334
+ * the market average; `margin_pct` = the book's average overround.
335
+ * A pricing report, never a profit claim.
336
+ */
337
+ getBookAccuracy(options = {}) {
338
+ const params = { days: String(options.days ?? 30) };
339
+ if (options.sport) params.sport = options.sport;
340
+ return this._request("GET", "/books/accuracy", { params });
341
+ }
330
342
  /**
331
343
  * Get raw player/team box-score stats (book-agnostic, free tier).
332
344
  *
@@ -471,6 +483,9 @@ var PropLine = class {
471
483
  * built from {@link getPlayerHistory} or {@link getPlayerTrends}. Carries
472
484
  * no line, price or grade.
473
485
  *
486
+ * `playerName` may also be a stable `player_id` (e.g. `"mlb:677951"`),
487
+ * which skips name matching; the response carries it back as `player_id`.
488
+ *
474
489
  * @example
475
490
  * ```ts
476
491
  * const log = await client.getPlayerGames("baseball_mlb", "Aaron Judge", { limit: 10 });
@@ -615,6 +630,9 @@ var PropLine = class {
615
630
  params.bookmakers = Array.isArray(options.bookmakers) ? options.bookmakers.join(",") : options.bookmakers;
616
631
  }
617
632
  if (options.devig) params.devig = options.devig;
633
+ if (options.fairSource) {
634
+ params.fair_source = Array.isArray(options.fairSource) ? options.fairSource.join(",") : options.fairSource;
635
+ }
618
636
  return this._request(
619
637
  "GET",
620
638
  `/sports/${encodeURIComponent(sport)}/events/${encodeURIComponent(String(eventId))}/ev`,
@@ -1108,7 +1126,7 @@ var Bookmakers = {
1108
1126
  POLYMARKET: "polymarket",
1109
1127
  PRIZEPICKS: "prizepicks"
1110
1128
  };
1111
- var VERSION = "0.56.0";
1129
+ var VERSION = "0.58.0";
1112
1130
  export {
1113
1131
  AuthError,
1114
1132
  Bookmakers,