Instructions
Search Entities
search-entities
Search for teams, people, competitions, bookmakers, channels, or markets by name and category. Use this first when a user mentions a specific sports entity and you need its ID.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
entity_name |
string |
Yes |
Entity name or search phrase. |
|
entity_category |
string |
Yes |
Type of entity to search for. |
TEAM, PERSON, COMPETITION, BOOKIE, CHANNEL, MARKET
|
language_code |
string |
No |
Language used for translated labels and localized fields. If omitted, search runs across all translations. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
sports |
array |
No |
Sports filter. Applies when searching teams or competitions. |
{"enum":["FOOTBALL","BASKETBALL","BASEBALL","ICE_HOCKEY","TENNIS","HANDBALL","GOLF","RUGBY","AMERICAN_FOOTBALL","CRICKET","VOLLEYBALL","FORMULA_1"],"type":"string"}
|
team_kind |
string |
No |
Team kind filter. Only applies when searching teams. |
CLUB, COLLEGE, NATIONAL
|
gender |
string |
No |
Gender filter. Applies when searching teams or competitions. |
FEMALE, MALE, MIXED
|
age |
string |
No |
Age filter. Applies when searching teams or competitions. |
A_TEAM, U23, U21, U20, U19, U18, U17, U16, U15, U14, U13
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code filter, e.g. AT or DE. Applies when searching teams, competitions, or people. |
Pattern: ^[A-Z]{2}$
|
Response
response
object
{ }
search_id
object | null
{ }
required
nullable
country
object
{ }
current_team
object
{ }
short_name
string | null
nullable
current_role
object
{ }
Get Bookie Info
get-bookie-info
Get general information for one or more bookmakers by ID, including supported betting markets, safety and licences, payment methods, apps & features and customer service.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
bookie_ids |
array |
Yes |
Bookmaker IDs to retrieve. Maximum 10 IDs. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used to filter country-specific bookmaker metadata, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
bookies
array
[ ]
required
item
object
{ }
id
integer | null
nullable
name
string | null
nullable
primary_color
string | null
nullable
secondary_color
string | null
nullable
background_color
string | null
nullable
year_of_foundation
integer | null
nullable
customer_services
string
required
payment_methods
string
required
betting_markets
string
required
licenses
array
[ ]
required
item
object
{ }
official_owner
string | null
nullable
number
string | null
nullable
url
string | null
nullable
authority
string | null
nullable
country_codes
array | null
[ ]
nullable
subdivision_codes
array
[ ]
required
Get Bookie Ratings
get-bookie-ratings
Get ratings for one or more bookmakers including localized rating and category details.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
Yes |
Application ID used to retrieve bookmaker ratings. |
|
bookie_ids |
array |
Yes |
Bookmaker IDs to retrieve ratings for. Maximum 10 IDs. |
{"type":"integer"}
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
bookies
array
[ ]
required
item
object
{ }
id
integer | null
nullable
name
string | null
nullable
ratings
array
[ ]
required
item
object
{ }
id
integer | null
nullable
application_id
integer | null
nullable
bookie_id
integer | null
nullable
rating
number | null
nullable
text
string | null
nullable
title
string | null
nullable
url
string | null
nullable
category
object | null
{ }
nullable
is_summary
boolean | null
nullable
kind
string | null
nullable
kind_kind
string | null
nullable
name
string | null
nullable
type
string | null
nullable
type_kind
string | null
nullable
Get Bookie Reviews
get-bookie-reviews
Get reviews for one or more bookmakers including review articles, review categories, and reviewer details.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
Yes |
Application ID used to retrieve bookmaker reviews. |
|
bookie_ids |
array |
Yes |
Bookmaker IDs to retrieve reviews for. Maximum 10 IDs. |
{"type":"integer"}
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
bookies
array
[ ]
required
item
object
{ }
id
integer | null
nullable
name
string | null
nullable
reviews
array
[ ]
required
item
object
{ }
id
integer | null
nullable
bookie_id
integer | null
nullable
language_id
string | null
nullable
application_id
integer | null
nullable
reviewer_id
integer | null
nullable
go_link_tags
string | null
nullable
is_active
boolean | null
nullable
created_at
string | null
nullable
updated_at
string | null
nullable
reviewer
object
{ }
id
integer | null
nullable
first_name
string | null
nullable
last_name
string | null
nullable
created_at
string | null
nullable
updated_at
string | null
nullable
image
object | null
{ }
nullable
id
integer | null
nullable
url
string | null
nullable
articles
array
[ ]
required
item
object
{ }
id
integer | null
nullable
review_id
integer | null
nullable
category_id
integer | null
nullable
text
string | null
nullable
short_text
string | null
nullable
rating
integer | null
nullable
video_url
string | null
nullable
created_at
string | null
nullable
updated_at
string | null
nullable
category
object | null
{ }
nullable
id
integer | null
nullable
kind
string | null
nullable
kind_kind
string | null
nullable
name
string | null
nullable
order_by
integer | null
nullable
Get Bookie Odds Boosts
get-bookie-odds-boosts
Get current odds boost and enhanced-odds promotions. Use when the user asks for boosted odds, enhanced prices, or bookmaker-specific promotional odds.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
No |
Application ID used when resolving go links. |
|
bookie_ids |
array |
No |
Bookmaker IDs used to filter odds boosts. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific odds boosts, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
promotions
array
[ ]
required
item
object
{ }
terms_conditions
string | null
nullable
expires_at
string | null
nullable
bookie
object
{ }
promotion_type
object
{ }
promotion_odds_boosts
array
[ ]
item
object
{ }
original_odd
number | null
nullable
original_odd_decimal
number | null
nullable
enhanced_odd
number | null
nullable
enhanced_odd_decimal
number | null
nullable
max_stake
number | null
nullable
available_for
string | null
nullable
available_for_kind
string | null
nullable
currency
object
{ }
sign
string | null
nullable
matches_associations
array
[ ]
item
object
{ }
betting_market_outcome_associations
array
[ ]
item
object
{ }
betting_market_outcome_id
integer
person_id
integer | null
nullable
go_links
array
[ ]
item
object
{ }
promotion_url
string | null
nullable
is_active
boolean | null
nullable
bookie_id
integer | null
nullable
application_id
integer | null
nullable
Get Bookie Promotions
get-bookie-promotions
Get bookmaker promotions for a country, bookmaker, or set of matches. Use for special offers, odds boosts, and match-specific promotions.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
No |
Application ID used when resolving go links. |
|
match_ids |
array |
No |
Match IDs used to filter promotions. |
{"type":"integer"}
|
bookie_ids |
array |
No |
Bookmaker IDs used to filter promotions. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific promotions, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
include_expired |
boolean |
No |
Whether to include expired promotions. Defaults to false. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
promotions
array
[ ]
required
item
object
{ }
terms_conditions
string | null
nullable
promotion_type_id
integer
expires_at
string | null
nullable
display_after
string | null
nullable
bookie
object
{ }
promotion_type
object
{ }
promotion_odds_boosts
array
[ ]
item
object
{ }
original_odd
number | null
nullable
original_odd_decimal
number | null
nullable
enhanced_odd
number | null
nullable
enhanced_odd_decimal
number | null
nullable
max_stake
number | null
nullable
available_for
string | null
nullable
available_for_kind
string | null
nullable
currency
object
{ }
sign
string | null
nullable
matches_associations
array
[ ]
item
object
{ }
betting_market_outcome_associations
array
[ ]
item
object
{ }
betting_market_outcome_id
integer
person_id
integer | null
nullable
go_links
array
[ ]
item
object
{ }
promotion_url
string | null
nullable
is_active
boolean | null
nullable
bookie_id
integer | null
nullable
application_id
integer | null
nullable
Get Bookie Bonuses
get-bookie-bonuses
Get active bookmaker bonus offers for a country. Use for welcome bonuses, free bets, cashback, casino bonuses, maximum bonus amounts, and rollover requirements.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
No |
Application ID used when resolving go links. |
|
bookie_ids |
array |
No |
Bookmaker IDs used to filter bonus offers. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific bonus offers, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
bonus_types |
array |
No |
Bonus types used to filter bonus offers. |
{"enum":["FIRST_DEPOSIT","CASHBACK","RELOAD","FRIENDSHIP","FREE_BET","MOBILE","COMBO"],"type":"string"}
|
bonus_kind |
string |
No |
Limits bonus offers to betting or casino bonuses. Defaults to BETTING. |
BETTING, CASINO
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
bonuses
array
[ ]
required
item
object
{ }
percentage
number | null
nullable
max_bonus
number | null
nullable
go_links
array
[ ]
item
object
{ }
bonus_url
string | null
nullable
is_active
boolean | null
nullable
bookie_id
integer | null
nullable
application_id
integer | null
nullable
_computed
object
{ }
effective_value
string
required
Get Competition Standings
get-competition-standings
Get current standings for a competition. Use for league tables, group tables, team ranks, points, and qualification or relegation zones.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
competition_id |
integer |
Yes |
Competition ID. |
|
team_ids |
array |
No |
Team IDs used to filter standings to specific teams. |
{"type":"integer"}
|
round_ids |
array |
No |
Round IDs used to restrict standings to specific rounds. |
{"type":"integer"}
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
message
string
Present when standings cannot be resolved.
competition
object
{ }
current_season_id
integer | null
nullable
current_match_day
integer | null
nullable
round_standings
array
[ ]
item
object
{ }
round
object
{ }
required
round_mode_id
integer | null
nullable
table_mode_id
integer | null
nullable
standings
array
[ ]
required
item
object
{ }
last_rank
integer | null
nullable
team
object
{ }
short_name
string | null
nullable
standing_group
object
{ }
zones
array
[ ]
required
item
object
{ }
color
string | null
nullable
label
string | null
nullable
Get Matches
get-matches
Get past and upcoming matches for a team, a competition, or both. Provide at least one of team_id or competition_id. Use for schedules, recent results, and upcoming fixtures. Use date filtering OR limit filtering.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_id |
integer |
No |
Team ID. |
|
competition_id |
integer |
No |
Competition ID. |
|
date_from |
string |
No |
Inclusive start date in YYYY-MM-DD format used to anchor upcoming fixtures from this date onward. |
Pattern: ^\d{4}-\d{2}-\d{2}$
|
date_to |
string |
No |
Inclusive end date in YYYY-MM-DD format used to anchor past matches up to this date. |
Pattern: ^\d{4}-\d{2}-\d{2}$
|
past_match_limit |
integer |
No |
Number of recent completed matches to return. Use 0 to skip past matches. Maximum 50. |
|
upcoming_match_limit |
integer |
No |
Number of upcoming fixtures to return. Use 0 to skip future matches. Maximum 50. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to interpret date input or date filters and convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
past_matches
array
[ ]
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
round
object
{ }
upcoming_matches
array
[ ]
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
round
object
{ }
Get Top Live Matches
get-top-live-matches
Get the most important currently live matches, sorted by ELO score descending. Use for live-match discovery, live scores, match minutes, and top live events by competition or collection.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
competition_ids |
array |
No |
Competition IDs used to filter matches. |
{"type":"integer"}
|
competition_collection_id |
integer |
No |
Competition collection or group ID used to filter matches when specific competition IDs are not provided. Defaults to the configured top competition collection. |
|
limit |
integer |
No |
Maximum number of matches to return. Defaults to 10. Maximum 25. |
|
application_id |
integer |
No |
Application ID used when filtering matches. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
matches
array
[ ]
required
item
object
{ }
score
number | null
nullable
live
boolean | null
nullable
live_status
string | null
nullable
minute
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
Get Top Daily Matches
get-top-daily-matches
Get the most important matches for a date, sorted by ELO score descending. Use for "biggest matches today" style questions, with optional live matches and inline 1x2 odds.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
competition_ids |
array |
No |
Competition IDs used to filter matches. |
{"type":"integer"}
|
competition_collection_id |
integer |
No |
Competition collection or group ID used to filter matches when specific competition IDs are not provided. Defaults to the configured top competition collection. |
|
limit |
integer |
No |
Maximum number of matches to return. Defaults to 10. Maximum 25. |
|
date |
string |
No |
Date in YYYY-MM-DD format. |
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific odds, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
include_live |
boolean |
No |
Whether to include live matches in addition to upcoming matches. Defaults to true. |
|
include_odds |
boolean |
No |
Whether to include inline 1x2 odds in the response. Defaults to false. |
|
application_id |
integer |
No |
Application ID used when filtering matches. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to interpret date input or date filters and convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
matches
array
[ ]
required
item
object
{ }
score
number | null
nullable
live
boolean | null
nullable
live_status
string | null
nullable
minute
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
bets
array
[ ]
item
object
{ }
odd
number | null
nullable
previous_odd
number | null
nullable
trend
string | null
nullable
bookie
object
{ }
market
object
{ }
deep_link_url
string | null
nullable
Resolve Match
resolve-match
Resolve a match ID from one team or two teams, optionally within a date range. Use this when the user describes a fixture indirectly and you need the best matching match_id for follow-up tools.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_a_id |
integer |
Yes |
First team ID. |
|
team_b_id |
integer |
No |
Second team ID or opponent team ID. |
|
date_from |
string |
No |
Inclusive start date in YYYY-MM-DD format. |
Pattern: ^\d{4}-\d{2}-\d{2}$
|
date_to |
string |
No |
Inclusive end date in YYYY-MM-DD format. |
Pattern: ^\d{4}-\d{2}-\d{2}$
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to interpret date input or date filters and convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
matches
array
[ ]
required
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
Get Match Preview
get-match-preview
Get combined previews for one or more matches, including teams, score state, odds, channels, and optional standings.
Provide match IDs directly or team IDs to resolve each team's next match. Use instead of multiple separate calls when complete previews are needed.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
match_ids |
array |
No |
Match IDs. Maximum 10 IDs. |
{"type":"integer"}
|
team_ids |
array |
No |
Team IDs used to resolve each team's next match. Maximum 10 IDs. |
{"type":"integer"}
|
bookie_ids |
array |
No |
Bookmaker IDs used to filter odds and resolve links. If omitted, default bookmakers are used. Maximum 15 IDs. |
{"type":"integer"}
|
market_ids |
array |
No |
Betting market IDs used to filter odds. If omitted, the default 1x2 market is used. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific odds and channels, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
include_standings |
boolean |
No |
Whether to include standings for the match competition. Defaults to true. |
|
include_channels |
boolean |
No |
Whether to include broadcast and streaming channel data. Defaults to true. |
|
application_id |
integer |
No |
Application ID used when resolving bookmaker deep links. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
data
array
[ ]
required
item
object
{ }
match
object | null
{ }
required
nullable
minute
integer | null
nullable
attendance
integer | null
nullable
place_id
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
short_name
string | null
nullable
away_team
object
{ }
required
short_name
string | null
nullable
competition
object
{ }
current_season_id
integer | null
nullable
round
object
{ }
order
integer | null
nullable
round_mode_id
integer | null
nullable
match_score
object
{ }
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_half_time
integer | null
nullable
away_score_half_time
integer | null
nullable
channels
array
[ ]
item
object
{ }
association_name
string | null
nullable
coverage
string | null
nullable
is_streaming
boolean | null
nullable
form
object
{ }
home
array
[ ]
required
item
object
{ }
teams
object
{ }
required
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
required
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
competition
object
{ }
required
away
array
[ ]
required
item
object
{ }
teams
object
{ }
required
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
required
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
competition
object
{ }
required
momentum
object
{ }
home
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
away
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
h2h
array
[ ]
item
object
{ }
teams
object
{ }
required
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
required
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
competition
object
{ }
required
bets
array
[ ]
item
object
{ }
odd
number | null
nullable
previous_odd
number | null
nullable
trend
string | null
nullable
bookie
object
{ }
market
object
{ }
deep_link_url
string | null
nullable
standings
array
[ ]
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Get Match Betting Tips
get-match-betting-tips
Generate heuristic betting tips for one or more matches from recent form, head-to-head history, and current odds.
Provide match IDs directly or team IDs to resolve each team's next match. Use for evidence-based betting ideas, not guaranteed predictions.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
match_ids |
array |
No |
Match IDs to analyze. Maximum 10 IDs. |
{"type":"integer"}
|
team_ids |
array |
No |
Team IDs used to resolve each team's next match. Maximum 10 IDs. |
{"type":"integer"}
|
bookie_ids |
array |
No |
Bookmaker IDs used to retrieve odds. If omitted, default primary bookmakers are used. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific betting tips and odds, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
application_id |
integer |
No |
Application ID used when resolving bookmaker deep links. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
data
array
[ ]
required
item
object
{ }
match
object
{ }
required
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
competition
object
{ }
momentum
object
{ }
required
home
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
away
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
h2h
array
[ ]
required
item
object
{ }
teams
object
{ }
required
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
required
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
competition
object
{ }
required
odds
array
[ ]
required
item
object
{ }
odd
number | null
nullable
market
object
{ }
bookie
object
{ }
deep_link_url
string | null
nullable
tips
array
[ ]
required
item
object
{ }
confidence
string
required
reasoning
string
required
odd
number | null
nullable
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Get Match Odds
get-match-odds
Get bookmaker odds for one or more matches. Use for odds comparison across bookmakers, markets, and countries.
Provide match IDs directly or team IDs to resolve each team's next match.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
match_ids |
array |
No |
Match IDs. Maximum 10 IDs. |
{"type":"integer"}
|
team_ids |
array |
No |
Team IDs used to resolve each team's next match. Maximum 10 IDs. |
{"type":"integer"}
|
market_ids |
array |
No |
Betting market IDs used to filter odds. If omitted, the default 1x2 market is used. |
{"type":"integer"}
|
bookie_ids |
array |
No |
Bookmaker IDs used to filter odds. If omitted, default bookmakers are used. Maximum 15 IDs. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific odds, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
include_deeplinks |
boolean |
No |
Whether to include resolved bookmaker deep links in the response. Defaults to true. |
|
application_id |
integer |
No |
Application ID used when resolving bookmaker deep links. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
data
array
[ ]
required
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
competition
object
{ }
round
object
{ }
bets
array
[ ]
required
item
object
{ }
odd
number | null
nullable
previous_odd
number | null
nullable
trend
string | null
nullable
bookie
object
{ }
market
object
{ }
deep_link_url
string | null
nullable
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Get Match Channels
get-match-channels
Get broadcast and streaming channel availability for one or more matches.
Provide match IDs directly or team IDs to resolve each team's next match.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
application_id |
integer |
No |
Application ID used when resolving go links. |
|
match_ids |
array |
No |
Match IDs. Maximum 10 IDs. |
{"type":"integer"}
|
team_ids |
array |
No |
Team IDs used to resolve each team's next match. Maximum 10 IDs. |
{"type":"integer"}
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific channels, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
data
array
[ ]
required
item
object
{ }
match_date
string | null
nullable
teams
object
{ }
required
home_team
object
{ }
required
away_team
object
{ }
required
channels
array
[ ]
required
item
object
{ }
go_links
array
[ ]
item
object
{ }
channel_url
string | null
nullable
is_active
boolean | null
nullable
bookie_id
integer | null
nullable
application_id
integer | null
nullable
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Build Single Match Parlay
build-single-match-parlay
Build a heuristic single-match parlay, also known as a same-game parlay or bet builder. Use when the user wants multiple compatible legs from the same match at a chosen risk level.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
match_id |
integer |
Yes |
Match ID. |
|
bookie_ids |
array |
No |
Bookmaker IDs used to retrieve odds and resolve links. If omitted, default primary bookmakers are used. |
{"type":"integer"}
|
application_id |
integer |
No |
Application ID used when resolving bookmaker deep links. |
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific bets and odds, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
risk_level |
string |
No |
Controls how conservative or aggressive the generated parlay should be. Defaults to moderate. |
safe, moderate, aggressive, high_risk
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
match
object
{ }
required
teams
object
{ }
home_team
object
{ }
required
short_name
string | null
nullable
away_team
object
{ }
required
short_name
string | null
nullable
competition
object
{ }
round
object
{ }
risk_level
string
required
momentum
object
{ }
required
home
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
away
object
{ }
required
goals_scored_avg
number
required
goals_conceded_avg
number
required
over_2_5_rate
number
required
over_3_5_rate
number
required
btts_rate
number
required
clean_sheet_rate
number
required
scoring_streak
integer
required
parlays
array
[ ]
required
item
object
{ }
bookie
object
{ }
required
multi_deep_link_url
string | null
nullable
legs
array
[ ]
required
item
object
{ }
match_id
integer
required
market
string | null
nullable
market_id
integer
required
selection
string
required
trend
string | null
nullable
deep_link_url
string | null
nullable
combined_odds
number
required
implied_probability
number
required
build_risk_level
string
required
goalscorer_odds
array
[ ]
item
object
{ }
deep_link_url
string | null
nullable
Build Multi Match Parlay
build-multi-match-parlay
Build a heuristic multi-match parlay, also known as an accumulator or acca. Use when the user wants one suggested leg per match combined into a multi-match bet.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
match_ids |
array |
Yes |
Match IDs to include in the multi-match parlay. Provide between 2 and 10 IDs. |
{"type":"integer"}
|
bookie_ids |
array |
No |
Bookmaker IDs used to retrieve odds and resolve links. If omitted, default primary bookmakers are used. |
{"type":"integer"}
|
market_ids |
array |
No |
Betting market IDs to consider for leg selection and multi deep-link resolution. If omitted, default supported markets are used. |
{"type":"integer"}
|
application_id |
integer |
No |
Application ID used when resolving bookmaker deep links. |
|
country_code |
string |
No |
ISO 3166-1 alpha-2 uppercase country code used for country-specific betting tips and odds, e.g. AT or DE. |
Pattern: ^[A-Z]{2}$
|
risk_level |
string |
No |
Controls how conservative or aggressive the generated multi-match parlay should be. Defaults to moderate. |
safe, moderate, aggressive, high_risk
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
matches
array
[ ]
required
item
object
{ }
teams
object
{ }
home_team
object
{ }
required
short_name
string | null
nullable
away_team
object
{ }
required
short_name
string | null
nullable
competition
object
{ }
round
object
{ }
risk_level
string
required
momentum
object
required
Momentum objects keyed by runtime team ID. Each value contains the standard team momentum metrics.
Additional properties may be present.
parlays
array
[ ]
required
item
object
{ }
bookie
object
{ }
required
multi_deep_link_url
string | null
nullable
legs
array
[ ]
required
item
object
{ }
match_id
integer
required
match_label
string
required
market
string | null
nullable
market_id
integer
required
selection
string
required
trend
string | null
nullable
deep_link_url
string | null
nullable
form
object
{ }
required
leg_count
integer
required
combined_odds
number
required
implied_probability
number
required
build_risk_level
string
required
correlation_warnings
array
[ ]
required
Get Person Statistics
get-person-statistics
Get person profiles and competition-season statistics for one or more persons by ID. Use for athlete, player, driver, or other person-level performance questions, and optionally filter by competitions to isolate league, cup, club, national-team, or sport-specific stats.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
person_ids |
array |
Yes |
Person IDs whose profiles and statistics should be returned. Maximum 30 IDs. |
{"type":"integer"}
|
limit |
integer |
No |
Maximum number of competition-season statistics entries to return. |
|
competition_ids |
array |
No |
Competition IDs used to restrict person statistics. |
{"type":"integer"}
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
players
array
[ ]
required
item
object
{ }
player
object
{ }
full_name
string | null
nullable
first_name
string | null
nullable
last_name
string | null
nullable
position_1
string | null
nullable
position_1_kind
string | null
nullable
preferred_side
string | null
nullable
birth_date
string | null
nullable
birth_place
string | null
nullable
height
number | null
nullable
weight
number | null
nullable
country
object
{ }
current_team
object
{ }
stats_by_season
array
[ ]
item
object
{ }
season
object
{ }
_computed
object
{ }
required
minutes_per_appearance
number
Get Person Info
get-person-info
Get person profiles with club and national-team histories for one or more persons by ID. Use for athletes, players, coaches, and other persons.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
person_ids |
array |
Yes |
Person IDs to retrieve. Maximum 30 IDs. |
{"type":"integer"}
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
persons
array
[ ]
required
item
object
{ }
first_name
string | null
nullable
last_name
string | null
nullable
full_name
string | null
nullable
birth_date
string | null
nullable
birth_place
string | null
nullable
gender
string | null
nullable
hair
string | null
nullable
height
number | null
nullable
position_1
string | null
nullable
position_1_kind
string | null
nullable
position_2
string | null
nullable
position_2_kind
string | null
nullable
preferred_side
string | null
nullable
shoe_size
number | null
nullable
skin
string | null
nullable
weight
number | null
nullable
died
boolean | null
nullable
death_date
string | null
nullable
current_role
object | null
{ }
nullable
kind
string | null
nullable
kind_kind
string | null
nullable
current_team
object | null
{ }
nullable
id
integer | null
nullable
name
string | null
nullable
club_team_history
array
[ ]
required
item
object
{ }
start
string | null
nullable
end
string | null
nullable
shirt_number
integer | string | null
nullable
team_id
integer | null
nullable
team_name
string | null
nullable
team_age_name
string | null
nullable
role_kind
string | null
nullable
role_kind_kind
string | null
nullable
national_team_history
array
[ ]
required
item
object
{ }
start
string | null
nullable
end
string | null
nullable
shirt_number
integer | string | null
nullable
team_id
integer | null
nullable
team_name
string | null
nullable
team_age_name
string | null
nullable
role_kind
string | null
nullable
role_kind_kind
string | null
nullable
Get Teams Head To Head Record
get-teams-head-to-head-record
Get historical head-to-head results between two teams. Use for questions about past meetings, rivalry records, win/draw/loss balance, and goal totals.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_a_id |
integer |
Yes |
First team ID. |
|
team_b_id |
integer |
Yes |
Second team ID or opponent team ID. |
|
past_match_limit |
integer |
No |
Number of past head-to-head matches to return. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
total_goals
integer
required
avg_goals_per_match
number
required
matches
array
[ ]
required
item
object
{ }
teams
object
{ }
home_team
object
{ }
required
short_name
string | null
nullable
away_team
object
{ }
required
short_name
string | null
nullable
match_score
object
{ }
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
competition
object
{ }
round
object
{ }
Get Team Form
get-team-form
Get recent completed matches and upcoming fixtures for one or more teams across their competitions. Use for form checks before a match or when the relevant competitions are not known.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_ids |
array |
Yes |
Team IDs. Maximum 10 IDs. |
{"type":"integer"}
|
competition_ids |
array |
No |
Competition IDs to filter results. If omitted, relevant competitions are auto-resolved for each team. |
{"type":"integer"}
|
past_match_limit |
integer |
No |
Number of recent completed matches to return per team. Use 0 to skip past matches. |
|
upcoming_match_limit |
integer |
No |
Number of upcoming fixtures to return per team. Use 0 to skip future matches. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
timezone |
string |
No |
IANA timezone ID used to convert returned datetime fields, e.g. Europe/Vienna. If omitted, UTC is used. |
|
Response
response
object
{ }
teams
array
[ ]
required
item
object
{ }
team
object
{ }
required
short_name
string | null
nullable
past_matches
array
[ ]
required
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
round
object
{ }
upcoming_matches
array
[ ]
required
item
object
{ }
match_day
integer | null
nullable
teams
object
{ }
home_team
object
{ }
required
away_team
object
{ }
required
match_score
object
{ }
home_score_half_time
integer | null
nullable
home_score_full_time
integer | null
nullable
away_score_full_time
integer | null
nullable
home_score_final
integer | null
nullable
away_score_final
integer | null
nullable
home_score_final_only_regular_goals
integer | null
nullable
away_score_final_only_regular_goals
integer | null
nullable
home_score_over_time
integer | null
nullable
home_score_penalties
integer | null
nullable
away_score_half_time
integer | null
nullable
away_score_over_time
integer | null
nullable
away_score_penalties
integer | null
nullable
competition
object
{ }
round
object
{ }
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Get Team Statistics
get-team-statistics
Get season-level team performance statistics for one or more teams. Use for statistical comparisons such as shots, duels, fouls, cards, and possession-related metrics.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_ids |
array |
Yes |
Team IDs. |
{"type":"integer"}
|
season_count |
integer |
No |
Number of seasons to include. |
|
competition_id |
integer |
No |
Competition ID used to restrict statistics to one competition. |
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
teams
array
[ ]
required
item
object
{ }
team
object
{ }
required
short_name
string | null
nullable
stats_by_season
array
[ ]
required
item
object
{ }
duels_won_percentage
number | null
nullable
season
object
{ }
_computed_per_match
object
{ }
required
Get Team Roster
get-team-roster
Get rosters for one or more teams, including current players and staff. Use for questions about squad members, coaches, managers, staff, roster membership, or who currently belongs to a team.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
team_ids |
array |
Yes |
Team IDs. Maximum 10 IDs. |
{"type":"integer"}
|
personnel_type |
string |
No |
Limits the response to staff or players. |
STAFF, PLAYERS
|
language_code |
string |
No |
Language used for translated labels and localized fields. |
en, de, da, el, es, fr, hu, it, nl, pl, pt, tr
|
Response
response
object
{ }
teams
array
[ ]
required
item
object
{ }
team
object
{ }
required
kind
string | null
nullable
staff
array
[ ]
item
object
{ }
full_name
string | null
nullable
first_name
string | null
nullable
last_name
string | null
nullable
role
string | null
nullable
role_category
string | null
nullable
nationality
string | null
nullable
current_team
object | null
{ }
nullable
players
array
[ ]
item
object
{ }
full_name
string | null
nullable
first_name
string | null
nullable
last_name
string | null
nullable
role
string | null
nullable
role_category
string | null
nullable
nationality
string | null
nullable
current_team
object | null
{ }
nullable
errors
array
[ ]
required
item
object
{ }
context
object
required
Additional properties may be present.
Execute Graphql Query
execute-graphql-query
Execute a GraphQL query against the E2 GraphQL endpoint. Use this only when the dedicated sports tools do not cover the requested data.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
query |
string |
Yes |
GraphQL query string to execute. |
|
Response
This tool returns JSON. A formal output schema is not declared.
Introspect Graphql Schema
introspect-graphql-schema
Inspect a GraphQL schema type such as Query, Mutation, or another named type. Use this before writing a custom GraphQL query when the schema is not already known.
readOnlyHint: true
Parameters
| Name |
Type |
Required |
Description |
Constraints |
type_name |
string |
Yes |
GraphQL type name to introspect. |
|
Response
This tool returns JSON. A formal output schema is not declared.