Skip to main content

Get Odds

GET 

/markets/:marketId

Retrieves all market information and bets for given market ID. This endpoint also returns all the odds from the bookmakers that are available to you.

Request

Path Parameters

    marketId int64required

    ID of market to fetch

    Example: 12345

Query Parameters

    bookmakerCode string[]

    Bookmaker codes to filter market odds on

Header Parameters

    Country-Code string

    Possible values: [US, GB, IT, ES]

    2 character ISO country code

    Subdivision string

    2 character subdivision code e.g. NJ = New Jersey

Responses

Returns a Market with child Bets and Prices.

Schema

    categoryGroupId integerrequired
    categoryGroupName stringrequired
    categoryGroupType string

    Possible values: [TEAM, RACE, PLAYER]

    categoryId integerrequired
    categoryName stringrequired
    eventId int64required
    eventName stringrequired
    subeventId int64required
    inPlay booleanrequired

    subevent inPlay status

    providerReferences

    object[]

  • Array [

  • provider SubeventProviderName (string)

    Possible values: [SPORT_RADAR, PA, FAIRPLAY, OPTA]

    id string
  • ]

  • subeventName stringrequired
    subeventStartTime stringrequired

    subevent starting time in UTC

    subeventEndTime string

    subevent end time in UTC

    marketId int64required
    marketName stringrequired
    marketTypeId int64required

    bets

    object[]

  • Array [

  • betId int64required
    betName stringrequired

    providerReferences

    object[]

  • Array [

  • provider BetProviderName (string)

    Possible values: [SPORT_RADAR, PA, FAIRPLAY]

    id string
  • ]

  • line string
    marketId int64required
    marketName stringrequired
    participantType string

    Possible values: [PLAYER, TEAM]

    odds

    object[]

  • Array [

  • bookmakerCode stringrequired
    oddsFractional stringrequired
    oddsDecimal doublerequired
    oddsUs stringrequired

    The US format of a price

    timestamp string

    the latest timestamp for when the odds were processed

    status stringrequired

    Possible values: [ACTIVE, FAILED, SUSPENDED]

    Whether the Bookmaker is currently offering this price. It could be temporarily unavailable or it may have expired.

    meta

    object

    bookmaker meta information

    betId string
    marketId string
    subeventId string
    eventId string
    categoryId string
    isBestLine boolean

    Whether the bookmakers price is the best line for the market, the best line is based on how close the line pair is together only applies to American Sports

  • ]

  • ]

  • bestLinePair

    object

    closest line pairing based off average decimal odds, supported markets are handicaps/point spread and total points

    lower

    object

    Lower bound bet totals markets will contain under, handicaps will contain minus

    name stringrequired
    id int64required

    upper

    object

    Upper bound bet totals markets will contain over, handicaps will contain plus

    name stringrequired
    id int64required
Loading...