Skip to content

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: live normally does not offer them there; before the game they are offered, and get no verdict and no held entry. 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 with market_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 match and no partial period.
  • futures is never graded: its types have an empty gradedPeriodsBySport.
  • 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 void a 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.