🏛️ Price

An object representing the prices for a particular marketSelection and book organized with a nested serialization.


{
    "eventId": "EVNT_14368855fdbb4b14965536d04c50dcbb",
    "markets": [
        {
            "id": "MKT_945039fb0b3b49c18b27f69d98826ee6",
            "name": "Moneyline",
            "marketOffers": [
                {
                    "id": "MKTO_51d113568d6c483895a9d7e1d7dbadc0",
                    "player": null,
                    "team": null,
                    "marketSelections": [
                        {
                            "id": "MRKT_3933288e631c4f188c30db34dd52774e",
                            "position": "Arizona Diamondbacks",
                            "positionId": "TEAM_3091d5574798424ab85271e615dd5183",
                            "books": [
                                {
                                    "id": "BOOK_nhLZ9l5DRs6w6KcE2n7vnw",
                                    "abbr": "dk",
                                    "name": "DraftKings",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": -155,
                                            "impliedProbability": 0.6078,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "30589142",
                                                "marketId": "30589142_moneyline",
                                                "selectionId": "30589142_ari"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_c81242f993894e67966b3ccfc4ba3a65",
                                    "abbr": "bs",
                                    "name": "ESPN BET",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": -155,
                                            "impliedProbability": 0.6078,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "1207651",
                                                "marketId": "1207651_ml",
                                                "selectionId": "1207651_ari"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_IPBQaQQTCRxplZx7SYOA",
                                    "abbr": "ca",
                                    "name": "Caesars",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": -160,
                                            "impliedProbability": 0.6154,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "caesars-mlb-12345",
                                                "marketId": "caesars-mlb-12345-ml",
                                                "selectionId": "caesars-mlb-12345-ari"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_pPg9ABaPSj2mL6qoMTKR1A",
                                    "abbr": "mg",
                                    "name": "BetMGM",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": -150,
                                            "impliedProbability": 0.6000,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "13567890",
                                                "marketId": "13567890_ml",
                                                "selectionId": "13567890_ari"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_Rf7xRhS7TKQUl94Xkt5w",
                                    "abbr": "fd",
                                    "name": "Fanduel",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": -154,
                                            "impliedProbability": 0.6063,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "35492839",
                                                "marketId": "42.570304298",
                                                "selectionId": "48009770"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                }
                            ]
                        },
                        {
                            "id": "MRKT_cc429231979c482a99c246ea78240d8d",
                            "position": "Miami Marlins",
                            "positionId": "TEAM_c9ca7e172559411e8d19a3eff02918fb",
                            "books": [
                                {
                                    "id": "BOOK_nhLZ9l5DRs6w6KcE2n7vnw",
                                    "abbr": "dk",
                                    "name": "DraftKings",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": 130,
                                            "impliedProbability": 0.4348,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "30589142",
                                                "marketId": "30589142_moneyline",
                                                "selectionId": "30589142_mia"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_IPBQaQQTCRxplZx7SYOA",
                                    "abbr": "ca",
                                    "name": "Caesars",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": 135,
                                            "impliedProbability": 0.4255,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "caesars-mlb-12345",
                                                "marketId": "caesars-mlb-12345-ml",
                                                "selectionId": "caesars-mlb-12345-mia"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_pPg9ABaPSj2mL6qoMTKR1A",
                                    "abbr": "mg",
                                    "name": "BetMGM",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": 125,
                                            "impliedProbability": 0.4444,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "13567890",
                                                "marketId": "13567890_ml",
                                                "selectionId": "13567890_mia"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_Rf7xRhS7TKQUl94Xkt5w",
                                    "abbr": "fd",
                                    "name": "Fanduel",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": 130,
                                            "impliedProbability": 0.4348,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "35492839",
                                                "marketId": "42.570304298",
                                                "selectionId": "48009771"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                },
                                {
                                    "id": "BOOK_c81242f993894e67966b3ccfc4ba3a65",
                                    "abbr": "bs",
                                    "name": "ESPN BET",
                                    "prices": [
                                        {
                                            "line": 0.0,
                                            "odds": 130,
                                            "impliedProbability": 0.4348,
                                            "main": true,
                                            "live": false,
                                            "marketOfferVolume": null,
                                            "marketSelectionVolume": null,
                                            "bookIds": {
                                                "eventId": "1207651",
                                                "marketId": "1207651_ml",
                                                "selectionId": "1207651_mia"
                                            },
                                            "betPlaceLinks": {
                                                "desktop": "directlink",
                                                "iOS": "directlink",
                                                "android": "directlink"
                                            }
                                        }
                                    ]
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

Endpoints

📜 prices list [BETA]

📈 prices historic summary

📈 prices historic timeseries

eventId (string)

A unique identifier representing the 🎟️ event


markets (hash)

Represents the 📋 Market associated with the prices.

id (string)

The unique identifier associated with the 📋 Market.

name (string)

The name of the 📋 Market.


marketOffers (hash)

Represents the 🛒 MarketOffer associated with the prices.

id (string)

The unique identifier associated with the 🛒 MarketOffer

player (hash)

The ⛹️‍♂️ Player associated with the 🛒 MarketOffer in the case of a player prop. This will include id and fullName.

team (hash)

The 🎽 Team associated with the 🛒 MarketOffer in the case of a team prop. This will include id and fullName.


marketSelections (hash)

Represents the 🏷️ MarketSelectionsassociated with the relevant 🛒 MarketOffer.

id (string)

The unique identifier associated with the 🏷️ MarketSelection.

position (hash)

The name of the position of the 🏷️ MarketSelection. This could be a player, team, Over, Under or any other valid position.

positionId (hash)

If the position is a standardized object like a ⛹️‍♂️ Player or a 🎽 Team this will hold the unique identifier associated with that object.


books (list)

Represents the 📖 Book associated with the relevant Price.

id (string)

The unique identifier associated with the 📖 Book.

abbr (string)

The 2 character abbr of the 📖 Book.

name (string)

The name of the 📖 Book.


prices (list)

Represents the price(s) associated with the 📖 Book and 🏷️ MarketSelection.

line (float)

The line associated with the price.

odds (int)

The odds associated with the line.

impliedProbability (float)

Represents the implied probability of the americanOdds on this price, also equal to the share price for prediction markets.

main (bool)

When false, this price represents an "alt" line.

live (bool)

When true, this price represents a value that has been updated since the event began.

marketOfferVolume (int)

The trading volume associated with the marketOffer at this price (currently only populated for prediction-market books). null when unavailable.

marketSelectionVolume (int)

The trading volume associated with the marketSelection at this price (currently only populated for prediction-market books). null when unavailable.

bookIds (hash)

Sportsbook-native identifiers for the price's event, market, and selection. Useful for cross-referencing odds back to a sportsbook's own data feed.

🔐

Requires the BetPlace product subscription. These fields are only serialized for accounts with BetPlace access.

eventId (string)

The sportsbook-native id for the 🎟️ Event.

marketId (string)

The sportsbook-native id for the 📋 Market.

selectionId (string)

The sportsbook-native id for the 🏷️ MarketSelection.

betPlaceLinks (hash)

Direct links for creating the betslip on a sportsbook. Includes desktop, iOS, and android keys; values may be null when a deeplink is unavailable for that platform.

🔐

Requires the BetPlace product subscription. These fields are only serialized for accounts with BetPlace access.


Historic Prices Endpoints

The historic prices endpoints provide access to historical pricing data for market selections, enabling analysis of line movements, price trends, and market efficiency over time.

📊

Product Required: These endpoints require the historicData product subscription.

Summary Endpoint

📈 prices historic summary returns aggregated price statistics for one or more market selections over a specified time period. Use this endpoint to analyze price ranges, compare sportsbook offerings, and review first vs last price movements.

Query Modes:

  • By Market Selection ID: Query with marketSelectionId to get detailed statistics for a single specific market selection. Provides faster, focused results ideal for deep-diving into a known market.
  • By Player or Team: Query with player or team parameters to get statistics across all market selections matching your filters within a time range. Perfect for broad analysis and market discovery.

Response Structure:
Each market selection includes market details, event information, and per-sportsbook price data with first offer (earliest timestamp), last offer (latest timestamp), high offer (highest line value), and low offer (lowest line value).

Use Cases:

  • Historical market analysis - Review pricing patterns across past events
  • Sportsbook comparison - Compare how different books priced the same market
  • Player/team research - Analyze historical pricing for specific players or teams
  • Line movement summary - Understand price range and movement at a glance

Timeseries Endpoint

📈 prices historic timeseries returns OHLC (Open/High/Low/Close) windowed time series data for a specific market selection. Use this endpoint to chart line movements, analyze price volatility, and study market efficiency over time.

Time Windows:
Specify a rollup parameter to aggregate price data:

  • 5m - 5-minute windows (high-frequency analysis)
  • 15m - 15-minute windows
  • 1h - Hourly windows (standard charting, default)
  • 4h - 4-hour windows
  • 1d - Daily windows (long-term trends)

Carry-Forward Logic:
When no price data exists in a time window, the last known values are carried forward to ensure consistent data points. The bookCount and pricePointCount fields reflect actual data availability, not carried-forward values.

Response Structure:
Each time window includes window timestamps (start and end), OHLC data (open, high, low, close offers with line value, price/odds, sportsbook, and exact timestamp), and metadata (book count and price point count for the window).

Use Cases:

  • Line movement charts - Visualize odds changes with candlestick/OHLC charts
  • Volatility analysis - Identify periods of high price movement
  • Market efficiency - Study how quickly markets adjust to information
  • Arbitrage research - Analyze pricing windows for inefficiencies
  • Trend detection - Identify patterns in market pricing over time