Retrieves information about a specific market given a provider. Includes child bets and prices for all bookmakers associated with the API-KEY.

GET 
https://api.fairplaytechnologies.com/catalogue/v1/markets

Retrieves all found markets and bets for given Provider and market type

Request

Query Parameters

providerName SubeventProviderNamerequired

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

Provider Name to search on

providerId stringrequired

Provider Id to search on

marketTypeId int64required

Market type Id to search on

inPlay boolean

Whether to return inplay odds or pregame for matches

bookmakerCode string[]

Bookmaker codes to filter market odds on

Header Parameters

API-KEY stringrequired

API Key

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

200

Returns a Market with child Bets and Prices.

application/json

Schema

Schema

• Array [

subeventId int64required

providerReferences

object[]

Array [

provider SubeventProviderName (string)

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

id string

]

subeventName stringrequired
subeventStartTime stringrequired

subevent starting 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

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.

]

]

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

• ]

Example (from schema)

[
  {
    "subeventId": 191703244,
    "providerReferences": [
      {
        "provider": "SPORT_RADAR",
        "id": "string"
      }
    ],
    "subeventName": "ARC Classic",
    "subeventStartTime": "2021-11-18T23:59:00Z",
    "marketId": 12345,
    "marketName": "Win Market",
    "marketTypeId": 12345,
    "bets": [
      {
        "betId": 155345064,
        "betName": "Mac Jones",
        "providerReferences": [
          {
            "provider": "SPORT_RADAR",
            "id": "string"
          }
        ],
        "line": "-12.0",
        "marketId": 12345,
        "marketName": "Win Market",
        "participantType": "PLAYER",
        "odds": [
          {
            "bookmakerCode": "FB",
            "oddsFractional": "33/1",
            "oddsDecimal": 34.5,
            "oddsUs": "+300",
            "status": "ACTIVE"
          }
        ]
      }
    ],
    "bestLinePair": {
      "lower": "Under 213.5",
      "upper": "Over 213.5"
    }
  }
]

404

Not Found

500

Internal error

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://api.fairplaytechnologies.com/catalogue/v1/markets' \
-H 'Accept: application/json' \
-H 'API-KEY: <API_KEY_VALUE>'

Request Collapse all

Base URL

https://api.fairplaytechnologies.com/catalogue/v1

Auth

apiKey

Parameters

providerName — queryrequired

---SPORT_RADARPAFAIRPLAYOPTA

providerId — queryrequired

marketTypeId — queryrequired

API-KEY — headerrequired

inPlay — query

---truefalse

bookmakerCode — query

Country-Code — header

---USGBITES

Subdivision — header

ResponseClear

Click the Send API Request button above and see the response here!