Catalogs¶
The catalogs hold the vocabulary of the API: the ids in sport.id, league.id, period, a
market's type and book.id, and a scoresheet's stat key. Every catalog answers
{"data": [...]}.
| Catalog | Route | Key |
|---|---|---|
| Sports | GET /v1/catalog/sports |
Not needed |
| Leagues | GET /v1/catalog/leagues |
Needed |
| Periods | GET /v1/catalog/periods |
Not needed |
| Market groups | GET /v1/catalog/market-groups |
Not needed |
| Market types | GET /v1/catalog/market-types |
Not needed |
| Stat keys | GET /v1/catalog/stat-keys |
Not needed |
| Books | GET /v1/catalog/books |
Needed |
Cache them and refresh them daily. Ids are never renamed or reused. New ids may appear at any time: ignore an id you do not know, or refetch the catalog when a message carries one. The lists below are those of version 1.0.0; the routes are always the authority.
Sports¶
| Id | Name |
|---|---|
soccer |
Soccer |
basketball |
Basketball |
american_football |
American Football |
ice_hockey |
Ice Hockey |
baseball |
Baseball |
tennis |
Tennis |
golf |
Golf |
volleyball |
Volleyball |
beach_volleyball |
Beach Volleyball |
handball |
Handball |
futsal |
Futsal |
table_tennis |
Table Tennis |
badminton |
Badminton |
aussie_rules |
Australian Rules Football |
rugby_union |
Rugby Union |
rugby_league |
Rugby League |
rugby |
Rugby |
rugby_sevens |
Rugby Sevens |
cricket |
Cricket |
darts |
Darts |
snooker |
Snooker |
boxing |
Boxing |
mma |
Mixed Martial Arts |
motorsport |
Motorsport |
cycling |
Cycling |
esports |
Esports |
politics |
Politics |
entertainment |
Entertainment |
rugby is a game whose source does not say whether it is union or league; rugby_sevens has its own
regulation time (2 x 7 minutes).
Leagues¶
GET /v1/catalog/leagues (example) lists the leagues of what the
products of your key hold now: the games on their boards, and the scoresheets and verdicts still
kept (up to 30 days).
| Field | What it is |
|---|---|
id |
lg_…, the same in every product |
name |
Display name |
country |
ISO 3166-1 alpha-2, or null |
sport |
The sport's id |
Leagues have no fixed list. A league with none of that is not listed until it has some again, with the same id: keep the names you have seen. Every event, scoresheet and grading carries its league's name too.
A game that only the sportsbooks list, in a competition we cannot name for sure, is published
under its sport's generic league (for example Soccer).
Periods¶
GET /v1/catalog/periods: {id, name, description}.
| Id | Name | What it covers |
|---|---|---|
match |
Match | The whole event as the sport counts it: regular time in soccer; overtime included in basketball, American football, ice hockey (and shoot-out) and baseball (extra innings). |
regulation |
Regulation Time | Regular time only: no overtime, extra innings or shoot-out. |
1h |
1st Half | The first half. |
2h |
2nd Half | The second half; in basketball and American football it includes overtime. |
f5 |
First 5 Innings | Innings 1 to 5. |
f7 |
First 7 Innings | Innings 1 to 7. |
outright |
Outright | The whole competition named in the market. |
q1 |
1st Quarter | The 1st quarter only. |
q2 |
2nd Quarter | The 2nd quarter only. |
q3 |
3rd Quarter | The 3rd quarter only. |
q4 |
4th Quarter | The 4th quarter only. |
p1 |
1st Period | The 1st period only. |
p2 |
2nd Period | The 2nd period only. |
p3 |
3rd Period | The 3rd period only. |
i1 |
1st Inning | The 1st inning only. |
i2 |
2nd Inning | The 2nd inning only. |
i3 |
3rd Inning | The 3rd inning only. |
i4 |
4th Inning | The 4th inning only. |
i5 |
5th Inning | The 5th inning only. |
i6 |
6th Inning | The 6th inning only. |
i7 |
7th Inning | The 7th inning only. |
i8 |
8th Inning | The 8th inning only. |
i9 |
9th Inning | The 9th inning only. |
i10 |
10th Inning | The 10th inning only. |
i11 |
11th Inning | The 11th inning only. |
i12 |
12th Inning | The 12th inning only. |
i13 |
13th Inning | The 13th inning only. |
i14 |
14th Inning | The 14th inning only. |
i15 |
15th Inning | The 15th inning only. |
ot1 |
1st Overtime | The 1st overtime period only. |
ot2 |
2nd Overtime | The 2nd overtime period only. |
ot3 |
3rd Overtime | The 3rd overtime period only. |
ot4 |
4th Overtime | The 4th overtime period only. |
et1 |
1st Extra Time Half | The 1st half of extra time only. |
et2 |
2nd Extra Time Half | The 2nd half of extra time only. |
set1 |
1st Set | The 1st set only. |
set2 |
2nd Set | The 2nd set only. |
set3 |
3rd Set | The 3rd set only. |
set4 |
4th Set | The 4th set only. |
set5 |
5th Set | The 5th set only. |
round1 |
1st Round | The 1st round only. |
round2 |
2nd Round | The 2nd round only. |
round3 |
3rd Round | The 3rd round only. |
round4 |
4th Round | The 4th round only. |
map1 |
1st Map | The 1st map only. |
map2 |
2nd Map | The 2nd map only. |
map3 |
3rd Map | The 3rd map only. |
map4 |
4th Map | The 4th map only. |
map5 |
5th Map | The 5th map only. |
race |
Race | The race the event is. A multi-race pool covers the races listed in its raceEventIds. |
match is the whole event as the sport counts it: regular time in soccer; overtime included in
basketball, American football and ice hockey (shoot-out included), and extra innings in baseball.
regulation is regular time only. outright is the period of every futures market. A sport only
uses the periods it has: a soccer market is never q1.
Market groups¶
Every market type belongs to one group, for building tabs. Filter an event or the stream with
groups, for example ?groups=player.
| Id | Name |
|---|---|
game |
Game lines and game props |
team |
Markets about one team |
stats |
Match statistics other than the score (corners, cards, shots, yards…) |
player |
Player props |
futures |
Futures and outrights |
racing |
Racing pools |
Market forms¶
Each market type has a form, which says how to read its selections:
| Form | Selections |
|---|---|
1x2 |
home, away, draw |
12 |
home, away |
dc |
home_or_draw, draw_or_away, home_or_away |
hcp |
home, away, each with its own line |
ou |
over, under at the market's line |
yn |
yes, no |
oe |
odd, even |
wnb |
The opponent of the market's participant (home or away) and draw; stakes are returned if the named team wins |
team_first |
home, away, or another outcome by name (such as "No Goal"); line numbers the goal, point or game |
named |
One selection per outcome, by its name, with side: other (correct score, bands, margins, half-time/full-time) |
contest |
One selection per competitor, with side: participant (futures) |
player_ou |
One market per player and line: over, under |
player_yn |
One market per player: yes, no |
player_exact |
One market per player: one selection per exact figure (side: exact, the figure in line) |
player_band |
One market per player: one selection per band (side: range, the band in range) |
player_winner |
One selection per player (side: participant), plus outcomes such as "No Goalscorer" (side: other) |
Market types¶
GET /v1/catalog/market-types (example):
| Field | What it is |
|---|---|
id |
The type's id: a market's type |
name |
Display name |
form |
How to read its selections (above) |
description |
What it settles on, when the name does not say it all; or null |
namesBySport |
Sport id → the name it takes in that sport, where it differs |
group |
Its market group |
gradedPeriodsBySport |
Sport id → the periods where we grade it. See Where we grade |
gradedLeaguesBySport |
Sport id → the leagues where we measured that it is graded, for the types that need it |
The last column below says which product a market of the type is in before the game starts. In
play, every type is in live, except horse racing's, which are only in racing.
Game lines and game props (game)¶
| Id | Name | Form | Before the game |
|---|---|---|---|
match_result |
Match Result | 1x2 |
pregame |
moneyline |
Moneyline | 12 |
pregame |
double_chance |
Double Chance | dc |
pregame |
draw_no_bet |
Draw No Bet | 12 |
pregame |
spread |
Spread | hcp |
pregame |
asian_handicap |
Asian Handicap | hcp |
pregame |
to_qualify |
To Qualify | 12 |
props |
extra_time_result |
Extra Time Result | 1x2 |
props |
extra_time_total |
Extra Time Total | ou |
props |
will_there_be_a_draw |
Will There Be A Draw | yn |
props |
correct_score |
Correct Score | named |
props |
halftime_fulltime |
Half Time / Full Time | named |
props |
halftime_fulltime_double_chance |
Half Time / Full Time Double Chance | named |
props |
exact_margin |
Exact Margin | named |
props |
winning_margin |
Winning Margin | named |
props |
to_win_by |
To Win By | named |
props |
result_and_both_teams_to_score |
Result And Both Teams To Score | named |
props |
result_and_total |
Result And Total | named |
props |
double_chance_and_total |
Double Chance And Total | named |
props |
result_at_minute |
Result At Minute | 1x2 |
props |
most_periods_won |
Most Periods Won | 1x2 |
props |
highest_scoring_half |
Highest Scoring Half | named |
props |
highest_scoring_period |
Highest Scoring Period | named |
props |
first_scoring_team_wins |
First Scoring Team Wins | yn |
props |
lead_after_every_quarter |
Lead After Every Quarter | team_first |
props |
total |
Total | ou |
pregame |
odd_even |
Odd/Even | oe |
props |
exact_total |
Exact Total | named |
props |
total_band |
Total Bands | named |
props |
both_teams_to_score |
Both Teams To Score | yn |
props |
own_goal |
Own Goal | yn |
props |
penalty_awarded |
Penalty Awarded | yn |
props |
first_team_to_score |
First Team To Score | team_first |
props |
last_team_to_score |
Last Team To Score | team_first |
props |
next_goal |
Next Goal | team_first |
props |
race_to |
Race To | team_first |
props |
game_winner |
Game Winner | team_first |
props |
first_goal_time |
First Goal Time | named |
props |
goal_before |
Goal Before | named |
props |
goal_after |
Goal After | named |
props |
first_score_method |
First Score Method | named |
props |
first_score_team_and_method |
First Score Team And Method | named |
props |
first_10_minutes_total |
Total First 10 Minutes | ou |
props |
set_spread |
Set Spread | hcp |
pregame |
total_sets |
Total Sets | ou |
pregame |
highest_scoring_quarter |
Team With Highest Scoring Quarter | 1x2 |
props |
total_touchdowns |
Total Touchdowns | ou |
props |
total_field_goals |
Total Field Goals | ou |
props |
exact_touchdowns |
Exact Touchdowns | named |
props |
longest_field_goal |
Longest Field Goal | ou |
props |
shortest_field_goal |
Shortest Field Goal | ou |
props |
longest_touchdown |
Longest Touchdown | ou |
props |
shortest_touchdown |
Shortest Touchdown | ou |
props |
largest_lead |
Largest Lead | ou |
props |
safety |
Safety | yn |
props |
octopus |
Octopus | yn |
props |
special_teams_or_defensive_touchdown |
Special Teams Or Defensive Touchdown | yn |
props |
three_unanswered_scores |
Either Team To Score 3 Unanswered Times | yn |
props |
two_point_conversion |
Successful Two Point Conversion | yn |
props |
score_in_last_two_minutes |
Score In Last 2 Minutes | yn |
props |
scoreless_quarter |
Scoreless Quarter | yn |
props |
both_teams_touchdown_each_half |
Both Teams 1+ Touchdowns In Each Half | yn |
props |
first_timeout |
Team To Call First Timeout | team_first |
props |
first_accepted_penalty |
Team To Commit First Accepted Penalty | team_first |
props |
first_coaches_challenge |
Team To Have First Coach's Challenge | team_first |
props |
Markets about one team (team)¶
| Id | Name | Form | Before the game |
|---|---|---|---|
win_no_bet |
Win No Bet | wnb |
props |
win_and_total |
To Win And Total | named |
props |
win_from_behind |
Win From Behind | yn |
props |
win_both_halves |
Win Both Halves | yn |
props |
win_either_half |
Win Either Half | yn |
props |
win_to_nil |
Win To Nil | yn |
props |
score_first_and_win |
Score First And Win | yn |
props |
team_total |
Team Total | ou |
pregame |
team_odd_even |
Team Odd/Even | oe |
props |
team_exact_total |
Team Exact Total | named |
props |
team_total_band |
Team Total Bands | named |
props |
clean_sheet |
Clean Sheet | yn |
props |
score_in_both_halves |
To Score In Both Halves | yn |
props |
score_in_every_quarter |
To Score In Every Quarter | yn |
props |
team_touchdowns |
Team Touchdowns | ou |
props |
team_field_goals |
Team Field Goals | ou |
props |
team_corners |
Team Corners | ou |
props |
team_cards |
Team Cards | ou |
props |
team_shots_on_target |
Team Shots On Target | ou |
props |
team_offsides |
Team Offsides | ou |
props |
team_throw_ins |
Team Throw-ins | ou |
props |
team_tackles |
Team Tackles | ou |
props |
Match statistics other than the score (corners, cards, shots, yards…) (stats)¶
| Id | Name | Form | Before the game |
|---|---|---|---|
total_corners |
Total Corners | ou |
props |
corners_result |
Corners Result | 1x2 |
props |
corners_spread |
Corners Spread | hcp |
props |
corners_odd_even |
Corners Odd/Even | oe |
props |
corners_double_chance |
Corners Double Chance | dc |
props |
race_to_corners |
Race To Corners | team_first |
props |
last_corner |
Last Corner | team_first |
props |
total_cards |
Total Cards | ou |
props |
cards_spread |
Cards Spread | hcp |
props |
most_cards |
Most Cards | 1x2 |
props |
last_card |
Last Card | team_first |
props |
total_red_cards |
Total Red Cards | ou |
props |
total_shots_on_target |
Total Shots On Target | ou |
props |
shots_on_target_spread |
Shots On Target Spread | hcp |
props |
offsides_spread |
Offsides Spread | hcp |
props |
most_shots_on_target |
Most Shots On Target | 1x2 |
props |
total_offsides |
Total Offsides | ou |
props |
total_throw_ins |
Total Throw-ins | ou |
props |
throw_ins_spread |
Throw-ins Spread | hcp |
props |
total_goal_kicks |
Total Goal Kicks | ou |
props |
total_fouls |
Total Fouls | ou |
props |
fouls_spread |
Fouls Spread | hcp |
props |
most_fouls |
Most Fouls | 1x2 |
props |
total_tackles |
Total Tackles | ou |
props |
most_three_pointers |
Most Three Pointers | 1x2 |
props |
most_assists |
Most Assists | 1x2 |
props |
most_rebounds |
Most Rebounds | 1x2 |
props |
total_hits |
Total Hits | ou |
props |
most_hits |
Most Hits | 1x2 |
props |
total_passing_yards |
Total Passing Yards | ou |
props |
total_passing_touchdowns |
Total Passing Touchdowns | ou |
props |
total_rushing_yards |
Total Rushing Yards | ou |
props |
total_rushing_attempts |
Total Rushing Attempts | ou |
props |
total_rushing_touchdowns |
Total Rushing Touchdowns | ou |
props |
total_pass_completions |
Total Pass Completions | ou |
props |
total_pass_attempts |
Total Pass Attempts | ou |
props |
total_turnovers |
Total Turnovers | ou |
props |
total_punts |
Total Punts | ou |
props |
Player props (player)¶
| Id | Name | Form | Before the game |
|---|---|---|---|
first_goalscorer |
First Goalscorer | player_winner |
props |
last_goalscorer |
Last Goalscorer | player_winner |
props |
team_first_goalscorer |
Team First Goalscorer | player_winner |
props |
team_last_goalscorer |
Team Last Goalscorer | player_winner |
props |
next_touchdown_scorer |
Next Touchdown Scorer | player_winner |
props |
team_next_touchdown_scorer |
Team Next Touchdown Scorer | player_winner |
props |
team_last_touchdown_scorer |
Team Last Touchdown Scorer | player_winner |
props |
most_points |
Player With Most Points | player_winner |
props |
anytime_goalscorer |
Anytime Goalscorer | player_yn |
props |
player_2plus_goals |
Player To Score 2+ Goals | player_yn |
props |
player_3plus_goals |
Player To Score 3+ Goals | player_yn |
props |
anytime_touchdown_scorer |
Anytime Touchdown Scorer | player_yn |
props |
last_touchdown_scorer |
Last Touchdown Scorer | player_winner |
props |
top_goalscorer |
Top Goalscorer | player_winner |
props |
top_points_scorer |
Top Points Scorer | player_winner |
props |
first_basket_scorer |
First Basket Scorer | player_winner |
props |
most_passing_yards |
Player With Most Passing Yards | player_winner |
props |
most_receiving_yards |
Player With Most Receiving Yards | player_winner |
props |
most_rushing_yards |
Player With Most Rushing Yards | player_winner |
props |
most_receptions |
Player With Most Receptions | player_winner |
props |
first_card_player |
Player To Receive First Card | player_winner |
props |
player_to_be_booked |
Player To Be Booked | player_yn |
props |
player_to_be_sent_off |
Player To Be Sent Off | player_yn |
props |
player_goal_outside_box |
Player To Score From Outside The Box | player_yn |
props |
player_header_goal |
Player To Score With A Header | player_yn |
props |
player_double_double |
Player Double Double | player_yn |
props |
player_triple_double |
Player Triple Double | player_yn |
props |
player_1plus_hits |
Player To Record A Hit | player_yn |
props |
player_2plus_hits |
Player To Record 2+ Hits | player_yn |
props |
player_3plus_hits |
Player To Record 3+ Hits | player_yn |
props |
player_points |
Player Points | player_ou |
props |
player_points_exact |
Player Exact Points | player_exact |
props |
player_points_band |
Player Points Bands | player_band |
props |
player_rebounds |
Player Rebounds | player_ou |
props |
player_rebounds_exact |
Player Exact Rebounds | player_exact |
props |
player_rebounds_band |
Player Rebounds Bands | player_band |
props |
player_assists |
Player Assists | player_ou |
props |
player_assists_exact |
Player Exact Assists | player_exact |
props |
player_assists_band |
Player Assists Bands | player_band |
props |
player_steals |
Player Steals | player_ou |
props |
player_steals_exact |
Player Exact Steals | player_exact |
props |
player_blocks |
Player Blocks | player_ou |
props |
player_turnovers |
Player Turnovers | player_ou |
props |
player_threes_made |
Player Three Pointers Made | player_ou |
props |
player_threes_made_exact |
Player Exact Three Pointers Made | player_exact |
props |
player_threes_attempted |
Player Three Point Attempts | player_ou |
props |
player_twos_attempted |
Player Two Point Attempts | player_ou |
props |
player_points_assists |
Player Points + Assists | player_ou |
props |
player_points_assists_band |
Player Points + Assists Bands | player_band |
props |
player_points_rebounds |
Player Points + Rebounds | player_ou |
props |
player_points_rebounds_band |
Player Points + Rebounds Bands | player_band |
props |
player_rebounds_assists |
Player Rebounds + Assists | player_ou |
props |
player_rebounds_assists_band |
Player Rebounds + Assists Bands | player_band |
props |
player_points_rebounds_assists |
Player Points + Rebounds + Assists | player_ou |
props |
player_points_rebounds_assists_band |
Player Points + Rebounds + Assists Bands | player_band |
props |
player_steals_blocks |
Player Steals + Blocks | player_ou |
props |
player_goals |
Player Goals | player_ou |
props |
player_goals_exact |
Player Exact Goals | player_exact |
props |
player_shots |
Player Shots | player_ou |
props |
player_shots_on_goal |
Player Shots On Goal | player_ou |
props |
player_saves |
Player Saves | player_ou |
props |
player_plus_minus |
Player Plus/Minus | player_ou |
props |
player_powerplay_points |
Player Powerplay Points | player_ou |
props |
player_goals_assists |
Player Goals + Assists | player_ou |
props |
player_fouls_committed |
Player Fouls Committed | player_ou |
props |
player_fouls_won |
Player Fouls Won | player_ou |
props |
player_offsides |
Player Offsides | player_ou |
props |
player_cards |
Player Cards | player_ou |
props |
player_solo_tackles |
Player Solo Tackles | player_ou |
props |
player_passing_yards |
Player Passing Yards | player_ou |
props |
player_passing_yards_band |
Player Passing Yards Bands | player_band |
props |
player_passing_touchdowns |
Player Passing Touchdowns | player_ou |
props |
player_passing_touchdowns_exact |
Player Exact Passing Touchdowns | player_exact |
props |
player_pass_completions |
Player Pass Completions | player_ou |
props |
player_pass_completions_exact |
Player Exact Pass Completions | player_exact |
props |
player_pass_attempts |
Player Pass Attempts | player_ou |
props |
player_pass_attempts_exact |
Player Exact Pass Attempts | player_exact |
props |
player_interceptions |
Player Interceptions | player_ou |
props |
player_interceptions_exact |
Player Exact Interceptions | player_exact |
props |
player_receiving_yards |
Player Receiving Yards | player_ou |
props |
player_receiving_yards_band |
Player Receiving Yards Bands | player_band |
props |
player_receptions |
Player Receptions | player_ou |
props |
player_receptions_exact |
Player Exact Receptions | player_exact |
props |
player_rushing_yards |
Player Rushing Yards | player_ou |
props |
player_rushing_yards_band |
Player Rushing Yards Bands | player_band |
props |
player_rushing_attempts |
Player Rushing Attempts | player_ou |
props |
player_rushing_attempts_exact |
Player Exact Rushing Attempts | player_exact |
props |
player_rush_receiving_yards |
Player Rushing + Receiving Yards | player_ou |
props |
player_pass_rush_yards |
Player Passing + Rushing Yards | player_ou |
props |
player_touchdowns |
Player Touchdowns | player_ou |
props |
player_rushing_touchdowns |
Player Rushing Touchdowns | player_ou |
props |
player_receiving_touchdowns |
Player Receiving Touchdowns | player_ou |
props |
player_longest_reception |
Player Longest Reception | player_ou |
props |
player_longest_rush |
Player Longest Rush | player_ou |
props |
player_longest_pass_completion |
Player Longest Pass Completion | player_ou |
props |
player_kicking_points |
Player Kicking Points | player_ou |
props |
player_field_goals |
Player Field Goals Made | player_ou |
props |
player_extra_points |
Player Extra Points Made | player_ou |
props |
player_sacks |
Player Sacks | player_ou |
props |
player_hits |
Player Hits | player_ou |
props |
player_total_bases |
Player Total Bases | player_ou |
props |
player_home_runs |
Player Home Runs | player_ou |
props |
player_singles |
Player Singles | player_ou |
props |
player_doubles |
Player Doubles | player_ou |
props |
player_triples |
Player Triples | player_ou |
props |
player_stolen_bases |
Player Stolen Bases | player_ou |
props |
player_runs |
Player Runs | player_ou |
props |
player_strikeouts |
Player Strikeouts (Pitcher) | player_ou |
props |
player_earned_runs |
Player Earned Runs (Pitcher) | player_ou |
props |
player_hits_runs_rbis |
Player Hits + Runs + RBIs | player_ou |
props |
Futures and outrights (futures)¶
| Id | Name | Form | Before the game |
|---|---|---|---|
outright_winner |
Outright Winner | contest |
futures |
top_2_finish |
Top 2 Finish | contest |
futures |
top_3_finish |
Top 3 Finish | contest |
futures |
top_4_finish |
Top 4 Finish | contest |
futures |
top_6_finish |
Top 6 Finish | contest |
futures |
top_10_finish |
Top 10 Finish | contest |
futures |
podium_finish |
Podium Finish | contest |
futures |
points_finish |
Points Finish | contest |
futures |
to_reach_final |
To Reach The Final | contest |
futures |
to_reach_playoffs |
To Reach The Playoffs | contest |
futures |
to_be_relegated |
To Be Relegated | contest |
futures |
not_to_be_relegated |
Not To Be Relegated | contest |
futures |
to_finish_bottom |
To Finish Bottom | contest |
futures |
best_regular_season_record |
Best Regular Season Record | contest |
futures |
winning_conference |
Winning Conference | contest |
futures |
winning_division |
Winning Division | contest |
futures |
winning_nation |
Winning Nation | contest |
futures |
winning_constructor |
Winning Constructor | contest |
futures |
winner_nationality |
Nationality Of The Winner | contest |
futures |
highest_scoring_team |
Highest Scoring Team | contest |
futures |
lowest_scoring_team |
Lowest Scoring Team | contest |
futures |
highest_scoring_game |
Highest Scoring Game | contest |
futures |
Horse racing (racing)¶
Pari-mutuel pools: see Horse racing.
| Id | Name | Form | Before the game |
|---|---|---|---|
win |
Win | runner |
racing |
place |
Place | runner |
racing |
show |
Show | runner |
racing |
exacta |
Exacta | ordered |
racing |
quinella |
Quinella | unordered |
racing |
trifecta |
Trifecta | ordered |
racing |
superfecta |
Superfecta | ordered |
racing |
forecast |
Forecast | ordered |
racing |
tricast |
Tricast | ordered |
racing |
daily_double |
Daily Double | multi_race |
racing |
pick_3 |
Pick 3 | multi_race |
racing |
pick_4 |
Pick 4 | multi_race |
racing |
pick_5 |
Pick 5 | multi_race |
racing |
pick_6 |
Pick 6 | multi_race |
racing |
pick_7 |
Pick 7 | multi_race |
racing |
Stat keys¶
The keys of a scoresheet's stats (per team) and of its players[].stats (per player).
GET /v1/catalog/stat-keys: {id, name, description, scopes}, where scopes lists team,
player or both.
| Id | Name | Scope | What it counts |
|---|---|---|---|
corners |
Corners | team | Corner kicks taken. |
yellowCards |
Yellow Cards | team | Yellow cards shown; a second yellow counts here and as a red card. |
redCards |
Red Cards | team | Red cards shown, a second yellow included. |
shots |
Shots | team, player | Shots, on target or not. Ice hockey players: shots on goal. |
shotsOnTarget |
Shots on Target | team, player | Shots on target. |
fouls |
Fouls | team | Fouls committed. |
offsides |
Offsides | team | Offsides called. |
possession |
Possession | team | Share of possession, in percent. |
throwIns |
Throw-ins | team | Throw-ins taken. |
goalkeeperSaves |
Goalkeeper Saves | team | Saves by the goalkeeper. |
aces |
Aces | team | Aces served. |
doubleFaults |
Double Faults | team | Double faults served. |
points |
Points | player | Points scored. Ice hockey: goals plus assists. |
goals |
Goals | player | Goals scored. |
assists |
Assists | player | Assists. |
rebounds |
Rebounds | player | Total rebounds. |
steals |
Steals | player | Steals. |
blocks |
Blocks | player | Blocked shots. |
turnovers |
Turnovers | player | Turnovers. |
threesMade |
Three Pointers Made | player | Three-point field goals made. |
threesAttempted |
Three Pointers Attempted | player | Three-point field goals attempted. |
hits |
Hits | team, player | Baseball: base hits. Ice hockey: body checks. |
runs |
Runs | player | Runs scored by the batter. |
rbi |
Runs Batted In | player | Runs batted in. |
homeRuns |
Home Runs | player | Home runs. |
singles |
Singles | player | Singles. |
doubles |
Doubles | player | Doubles. |
triples |
Triples | player | Triples. |
totalBases |
Total Bases | player | Total bases. |
stolenBases |
Stolen Bases | player | Stolen bases. |
walks |
Walks | player | Walks drawn by the batter. |
atBats |
At Bats | player | At bats. |
strikeouts |
Strikeouts | player | Strikeouts thrown by the pitcher. |
earnedRuns |
Earned Runs | player | Earned runs allowed by the pitcher. |
plusMinus |
Plus/Minus | player | Plus/minus. |
powerPlayGoals |
Power Play Goals | player | Goals scored on the power play. |
blockedShots |
Blocked Shots | player | Opponents' shots blocked. |
penaltyMinutes |
Penalty Minutes | player | Penalty minutes. |
saves |
Saves | player | Saves by the goaltender. |
goalsAgainst |
Goals Against | player | Goals allowed by the goaltender. |
shotsAgainst |
Shots Against | player | Shots faced by the goaltender. |
passingYards |
Passing Yards | team, player | Passing yards. |
passingTouchdowns |
Passing Touchdowns | player | Touchdown passes thrown. |
interceptionsThrown |
Interceptions Thrown | player | Passes intercepted. |
rushingAttempts |
Rushing Attempts | team, player | Rushing attempts. |
rushingYards |
Rushing Yards | team, player | Rushing yards. |
rushingTouchdowns |
Rushing Touchdowns | player | Rushing touchdowns. |
longestRush |
Longest Rush | player | Longest rush, in yards. |
receptions |
Receptions | team, player | Passes caught. |
receivingYards |
Receiving Yards | player | Receiving yards. |
receivingTouchdowns |
Receiving Touchdowns | player | Receiving touchdowns. |
longestReception |
Longest Reception | player | Longest reception, in yards. |
targets |
Targets | player | Passes thrown to the player. |
tackles |
Tackles | player | Total tackles. |
soloTackles |
Solo Tackles | player | Solo tackles. |
sacks |
Sacks | team, player | Sacks. |
tacklesForLoss |
Tackles for Loss | player | Tackles for a loss. |
passesDefended |
Passes Defended | player | Passes defended. |
interceptions |
Interceptions | team, player | Passes intercepted by the defender; per team, by the defense. |
touchdowns |
Touchdowns | team, player | Touchdowns scored, every kind. |
Books¶
The catalog lists the books we carry. GET /v1/catalog/books
(example) gives those whose lines the products of your key carry
now: the book of a market (see Sportsbooks). New books may be added
at any time.
| Field | What it is |
|---|---|
id |
bk_…. Ours, and it never changes |
name |
The book's public name |
region |
us: licensed in a US state; offshore: serving US bettors from abroad; null when not known for certain |
Where we grade¶
For the grading add-on, each market type says where we commit to a verdict on our own lines. The sportsbooks' markets are not graded.
gradedPeriodsBySport¶
Sport id → the periods in which every market of the type gets a verdict, or is held with a
reason, the same in live, pregame and props:
{"id": "total", "gradedPeriodsBySport": {"soccer": ["match", "1h", "2h"], "ice_hockey": ["match", "regulation", "p1", "p2", "p3"]}}
- Listed: we grade those markets: each selection gets a verdict, or is held with a reason. A game whose scoresheet is never confirmed gets no verdicts (see When verdicts come).
- Not listed: we do not commit to a verdict. Settle those markets yourself from the
scoresheet; some may still get a verdict, be held or be given
void. - A period is listed only when every market of the type in it is graded. When only some lines
are (one minute of
result_at_minute, say), the period is left out. - It is said per sport, not per league. A league whose results do not carry what a market needs
(the score of each period, match statistics such as corners or cards, the goal timeline) gets no
verdict on those markets:
livenormally does not offer them there; before the game they are offered, and get no verdict and noheldentry. A whole-game market read on the periods (half time/full time, win both halves) also needs the score of each period: before the game, in such a league, it is held withmarket_not_graded. - For a player's statistics (points, yards, hits… as over/under, exact figures or bands) we
grade only the whole game: those types list
matchand no partial period. futuresis never graded: its types have an emptygradedPeriodsBySport.- It covers every sport and period the API can publish, also combinations no sport offers today.
- It follows our grader: it grows when we add one, and loses entries when we stop grading a type.
gradedLeaguesBySport¶
A soccer player's goals and cards (anytime_goalscorer, first_goalscorer, player_goals,
player_goals_exact, player_to_be_booked, player_cards, player_to_be_sent_off…) can only be
graded when we know whether the player played, and, for a card bet made before the game, whether
he started. How often we know depends on the league. For these types the catalog also lists, per
sport, the league ids where we measured that the selections get their verdict:
{"id": "anytime_goalscorer", "gradedLeaguesBySport": {"soccer": ["lg_gj5cykmzaqw2svl7"]}}
- over the last 30 days, at least 10 games of the league offered the type, and at least 95% of their selections got a verdict when the game was settled;
- a selection given
voida day after the game because nobody could tell does not count as graded; - measured on the selections made before the game, over the games settled more than three days ago; the same grader settles the live ones;
- a league with less history is not listed. An empty list means no league has passed yet, not that the type is graded everywhere.
It is measured once a day, so a league may enter or leave the list from one day to the next.
Offer these types where the list names the league, and settle them yourself elsewhere. Every
other type has an empty gradedLeaguesBySport: gradedPeriodsBySport says it all.