API Endpoints

This endpoint returns by default the next non-expired football predictions.Parameters can be specified to filter by date, by federation, by prediction market

All requests must contain a valid authentication key in the headers.

X-RapidAPI-Key or X-Mashape-Key

get
Predictions

mashape-url or rapidapi-url/api/v2/predictions
This endpoint returns by default the next non-expired football predictions.
Request
Response
Headers
X-RapidAPI-Key
required
string
Provide this header if authenticating via rapidapi.com
X-Mashape-Key
required
string
Provide this header if authenticating via mashape.com
Query Parameters
iso_date
optional
string
Date in YYYY-MM-DD format Day starts at 00:00 London Timezone If not provided returns next predictions for matches about to start in (12h/36h/48h - based on subscription type)
market
optional
string
Check the table below for the accepted values and how it affects the response.
federation
optional
string
Football association, for accepted values check the /api/v2/list-federations
200: OK
Success.
{
"data": [
{
"id": 40838,
"start_date": "2018-12-06T19:00:00",
"season": "2018 - 2019",
"status": "pending",
"home_team": "Feyenoord",
"prediction": "1",
"probabilities": {
"X2": 0.458,
"2": 0.163,
"1X": 0.837,
"1": 0.542,
"12": 0.704,
"X": 0.296
},
"is_expired": false,
"distance_between_teams": 131,
"away_strength": 0.524973751312434,
"federation": "UEFA",
"market": "classic",
"odds": {
"X2": 4.03,
"2": 12.205,
"1X": 1.04,
"1": 1.217,
"12": 1.1,
"X": 6.168
},
"competition_name": "Eredivisie",
"field_length": 105,
"stadium_capacity": 51117,
"last_update_at": "2018-12-04T20:11:57.506000",
"home_strength": 2.31326526289031,
"field_width": 68,
"away_team": "VVV-Venlo",
"result": "",
"competition_cluster": "Netherlands"
},
...
}
404: Not Found
When an invalid request is made the response will return an errors field with the query parameter that causes the error and the message.
{
"data": [],
"errors": {
"iso_date": "Date is 76 hours away. Your subscription allows seeing predictions up to 48 hours ahead."
}
}

Market

Description

Default

classic

Predictions for final match result (1 - home victory / X - draw / 2 - away victory)

Yes

over_25

Predicts whether there will be more than 2.5 goals scored (yes / no)

No

over_35

Predicts whether there will be more than 3.5 goals scored (yes / no)

No

btts

Predicts whether both teams will score ( yes / no )

No

home_over_05

Predicts whether the home team will score more than 0.5 goals (yes / no)

No

home_over_15

Predicts whether the home team will score more than 1.5 goals (yes / no)

No

away_over_05

Predicts whether the away team will score more than 0.5 goals (yes / no)

No

away_over_15

Predicts whether the away team will score more than 1.5 goals (yes / no)

No

get
Prediction Details

mashape-url or rapidapi-url/api/v2/predictions/:id
Grab all available market predictions for a match id
Request
Response
Path Parameters
id
required
string
Match ID
Headers
X-RapidAPI-Key
required
string
Provide this header if authenticating via rapidapi.com
X-Mashape-Key
required
string
Provide this header if authenticating via mashape.com
200: OK
{
"data": [
{
"competition_name": "Eredivisie",
"distance_between_teams": 131,
"id": 40838,
"competition_cluster": "Netherlands",
"stadium_capacity": 51117,
"start_date": "2018-12-06T19:00:00",
"field_length": 105,
"home_strength": 2.31326526289031,
"available_markets": [
"btts",
"over_25",
"away_over_15",
"home_over_15",
"classic",
"home_over_05"
],
"field_width": 68,
"away_team": "VVV-Venlo",
"season": "2018 - 2019",
"last_update_at": "2018-12-04T20:11:57.506000",
"result": "",
"away_strength": 0.524973751312434,
"federation": "UEFA",
"home_team": "Feyenoord",
"is_expired": false,
"prediction_per_market": {
"home_over_05": {
"prediction": "yes",
"status": "pending",
"odds": {
"no": null,
"yes": null
},
"probabilities": {
"no": 0.248,
"yes": 0.752
}
},
"away_over_15": {
"prediction": "no",
"status": "pending",
"odds": {
"no": null,
"yes": null
},
"probabilities": {
"no": 0.706,
"yes": 0.294
}
},
"over_25": {
"prediction": "yes",
"status": "pending",
"odds": {
"no": 2.497,
"yes": 1.493
},
"probabilities": {
"no": 0.377,
"yes": 0.623
}
},
"btts": {
"prediction": "no",
"status": "pending",
"odds": {
"no": 1.708,
"yes": 2.047
},
"probabilities": {
"no": 0.547,
"yes": 0.453
}
},
"home_over_15": {
"prediction": "yes",
"status": "pending",
"odds": {
"no": null,
"yes": null
},
"probabilities": {
"no": 0.238,
"yes": 0.762
}
},
"classic": {
"prediction": "1",
"status": "pending",
"odds": {
"X2": 4.03,
"2": 12.205,
"1X": 1.04,
"1": 1.217,
"12": 1.1,
"X": 6.168
},
"probabilities": {
"X2": 0.458,
"2": 0.163,
"1X": 0.837,
"1": 0.542,
"12": 0.704,
"X": 0.296
}
}
}
}
]
}

get
Performance stats (accuracy)

mashape-url or rapidapi-url/api/v2/performance-stats
Request
Response
Query Parameters
federation
optional
string
Football association, for accepted values check the /api/v2/list-federations the response.
market
optional
string
Check the table above for the accepted values and how it affects the response.
200: OK
{
"data": {
"market": "classic",
"accuracy": {
"last_30_days": 0.6819056785370549,
"last_14_days": 0.6704653371320038,
"yesterday": 0.78125,
"last_7_days": 0.6799242424242424
},
"details": {
"last_30_days": {
"pending": 0,
"lost": 661,
"postponed": 26,
"won": 1417,
"total": 2104
},
"last_14_days": {
"pending": 0,
"lost": 347,
"postponed": 14,
"won": 706,
"total": 1067
},
"yesterday": {
"pending": 0,
"lost": 7,
"postponed": 0,
"won": 25,
"total": 32
},
"last_7_days": {
"pending": 0,
"lost": 169,
"postponed": 7,
"won": 359,
"total": 535
}
}
}
}

get
List Federations

mashape-url or rapidapi-url/api/v2/list-federations
Request
Response
200: OK
{
"data": [
"UEFA",
"AFC",
"CAF",
"CONCACAF",
"OFC",
"CONMEBOL"
]
}

get
List Markets

mashape-url or rapidapi-url/api/v2/list-markets
Request
Response
200: OK
{
"data": {
"all": [
"over_35",
"away_over_15",
"home_over_15",
"classic",
"home_over_05",
"over_25",
"away_over_05",
"btts"
],
"allowed_for_your_subscription": [
"over_35",
"away_over_15",
"home_over_15",
"classic",
"home_over_05",
"over_25",
"away_over_05",
"btts"
]
}
}