Version: 1.0
Catalogue API
Catalogue
The Catalogue presents the entire FairPlay Technologies sporting view in a simple hierarchical tree. You can traverse to the point(s) you are interested in.
This Catalogue covers most sporting events and compares odds across 100+ global sportsbooks. Your API-Key will define what sportsbooks you have access to view.
Concepts
| Level | Description | Example(s) |
|---|---|---|
| Category | A category is the top level of our catalogue. A category could be a sport, or a country-specific sport grouping for example, Football is split into UK Football, European Football and more. | UK Football, International Horse Racing |
| Event | Events are bound to an category. Events are a high-level wrapper around a collection of subevents. Typically, an event will correspond to a sporting competition. An event is typically a long-lived concept entity that can span years. For simplicity, we re-use events year-on-year. For example, English Premier League Matches is reused each year. | English Premier League Matches, 2023-08-23|Ascot |
| Subevent | Subevents are bound to an event and are typically short-lived (besides Outrights). Subevents correspond to matches or specific races. | Arsenal v Manchester United, 2023-08-23|Ascot#15:20 |
| Market | Subevents can contain many markets. A Market is a collection of Bets. The marketTypeId is a distinct identifier of specific market types. | Win Market, To Finish 2nd |
| Bet | A Market can contain any number of Bets. A Bet would typically be a participant in the subevent and market. | Arsenal, Frankel |
| Odds | Each Bet will contain the prices of each Sportsbook. The Odds container contains information about the price in various formats and the status of the price. | 16/5 |
Supported Sportsbooks
UK
- bet365
- SkyBet
- Paddy Power
- William Hill
- 888Sport
- Betfair
- Bet Victor
- Coral
- Unibet
- Spreadex
- BetFred
- BetMGM
- BoyleSports
- 10 Bet
- Star Sports
- BetUK
- Sporting Index
- LiveScore
- QuinnBet
- BetWay
- Ladbrokes
- Bet Goodwin
- Pari Match
- VBet
- Tote
- Betfair Exchange
- Matchbook Exchange
Spain
- TonyBet
- Codere
- Sportium
- William Hill
- LeoVegas
- Gran Madrid
- Marca
- 888Sport
- BetWay
- bwin
- Betfair
- bet365
- Betfair Exchange
Italy
- bet365
- GoldBet
- BetWay
- Sisal
- Snai
- BetFlag
- William Hill
- Betfair
- Lottomatica
- NetBet
- LeoVegas
- Planetwin365
- Novibet
- Pokerstars Sports
North America
- Draft Kings
- Fanduel
- BetMGM
- bet365
- Caesars Sportsbook
- PointsBet
- Bodega
- Unibet
- BetRivers
- WynnBet
Authentication
- API Key: apiKey
Value for the api_key query parameter.
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | API-KEY |