> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymarket.us/llms.txt
> Use this file to discover all available pages before exploring further.
# Sports Schema
> Common instrument fields for safely identifying sports markets
This page documents the strongly-typed fields on the instrument that should be used to identify a sports market. **Do not parse the instrument symbol or slug** — symbol formats are not part of the public contract and may change. Always identify markets using the fields below.
## Section 1: Common Identifying Fields
The following fields appear on every sports instrument. Together they uniquely describe the sport, league, event, period, market type, and handicap of a contract.
### Field Reference
| Field | Location | Type | Description |
| --------------------- | ---------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `event_start_time` | `metadata` | Timestamp (UTC) | Scheduled start time of the underlying event. Updated in place when a game is rescheduled. |
| `event_subcategory` | `metadata` | Enum | The sport. Values: `BASKETBALL`, `FOOTBALL`, `BASEBALL`, `SOCCER`, etc. |
| `outcome_type` | `metadata` | Enum | The market structure. Still present on every instrument, but **do not use it for market mapping** — use `market_sport_type` instead. See the enum list below. |
| `market_sport_type` | `metadata` | Enum | The fully-qualified market type, including sport, participant scope, and game period. **Always populated on every sports instrument**, including full-game spreads, totals, and outright winners. See the enum list below. |
| `outcome_strike` | `metadata` | String (numeric) | The handicap or threshold for the market. Unsigned magnitude — the side the contract pays out on is encoded by `long_participant_id`. For a Cleveland +3.5 spread, this is `"3.5"`. For an over/under total of 4.5, this is `"4.5"`. Empty/`"0.0"` for moneylines. |
| `long_participant_id` | `metadata` | String | Globally unique ID of the side the contract pays out on (e.g. `mlb-cle`). Only populated on individual game markets (moneylines, spreads, totals, props) — do not rely on it for futures. |
### `outcome_type` Enum
The market structure of a sports instrument.
| Value | Meaning |
| ------------------ | ---------------------------------------------------------------------- |
| `moneyline` | Win/lose market (no handicap). |
| `spreads` | Point/goal/run handicap market. |
| `totals` | Over/under combined-score market. |
| `props` | Player or team prop. |
| `futures` | Season-long or event-long futures market. |
| `drawable_outcome` | Exclusive group market that admits a draw (e.g. 3-way soccer outcome). |
### `market_sport_type` Enum
The fully-qualified market type, including sport, participant scope, and game period. This field is populated on **every** sports instrument — full-game spreads, totals, and outright winners included — so you can treat it as the single source of truth for any market. **You no longer need to check `outcome_type` to map a market**; `market_sport_type` alone is sufficient. Some values are registered before their first listing; treat every value in this table as one that can appear on an instrument.
| Value | Sport | Scope | Period | Type |
| --------------------------------------------------------- | ------------ | ------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `baseball_player_home_runs` | Baseball | Player | Full game | Home runs prop |
| `baseball_player_strikeouts` | Baseball | Player | Full game | Strikeouts prop |
| `baseball_player_hits` | Baseball | Player | Full game | Hits prop |
| `baseball_player_total_bases` | Baseball | Player | Full game | Total bases prop |
| `baseball_player_hits_runs_rbis` | Baseball | Player | Full game | Hits + runs + RBIs prop |
| `baseball_player_rbis` | Baseball | Player | Full game | RBIs prop |
| `baseball_player_stolen_bases` | Baseball | Player | Full game | Stolen bases prop |
| `baseball_player_outs` | Baseball | Player | Full game | Pitcher outs prop |
| `baseball_player_earned_runs_allowed` | Baseball | Player | Full game | Earned runs allowed prop |
| `baseball_player_hits_allowed` | Baseball | Player | Full game | Hits allowed prop |
| `baseball_player_walks_allowed` | Baseball | Player | Full game | Walks allowed prop |
| `baseball_team_first_inning_run` | Baseball | Team | 1st inning | Run scored |
| `baseball_team_inning1_winner` | Baseball | Team | 1st inning | Inning winner |
| `baseball_team_inning2_winner` | Baseball | Team | 2nd inning | Inning winner |
| `baseball_team_inning3_winner` | Baseball | Team | 3rd inning | Inning winner |
| `baseball_team_inning4_winner` | Baseball | Team | 4th inning | Inning winner |
| `baseball_team_inning5_winner` | Baseball | Team | 5th inning | Inning winner |
| `baseball_team_inning6_winner` | Baseball | Team | 6th inning | Inning winner |
| `baseball_team_inning7_winner` | Baseball | Team | 7th inning | Inning winner |
| `baseball_team_inning8_winner` | Baseball | Team | 8th inning | Inning winner |
| `baseball_team_inning9_winner` | Baseball | Team | 9th inning | Inning winner |
| `baseball_game_extra_innings` | Baseball | Game | Full game | Extra innings yes/no |
| `baseball_team_first_five_winner` | Baseball | Team | First 5 innings | Prop |
| `baseball_team_first_five_spread` | Baseball | Team | First 5 innings | Spread |
| `baseball_team_first_five_total` | Baseball | Team | First 5 innings | Total |
| `baseball_team_full_game_winner` | Baseball | Team | Full game | Moneyline |
| `baseball_team_full_game_spread` | Baseball | Team | Full game | Spread |
| `baseball_team_full_game_total` | Baseball | Team | Full game | Total |
| `baseball_team_total_runs` | Baseball | Team | Full game | Selected-team runs total |
| `basketball_player_points` | Basketball | Player | Full game | Points prop |
| `basketball_player_assists` | Basketball | Player | Full game | Assists prop |
| `basketball_player_rebounds` | Basketball | Player | Full game | Rebounds prop |
| `basketball_player_threes` | Basketball | Player | Full game | Three-pointers prop |
| `basketball_player_steals` | Basketball | Player | Full game | Steals prop |
| `basketball_player_blocks` | Basketball | Player | Full game | Blocks prop |
| `basketball_player_double_double` | Basketball | Player | Full game | Double-double yes/no |
| `basketball_player_triple_double` | Basketball | Player | Full game | Triple-double yes/no |
| `basketball_team_first_half_winner` | Basketball | Team | First half | Prop |
| `basketball_team_first_half_spread` | Basketball | Team | First half | Spread |
| `basketball_team_first_half_total` | Basketball | Team | First half | Total |
| `basketball_team_second_half_winner` | Basketball | Team | Second half | Prop |
| `basketball_team_second_half_spread` | Basketball | Team | Second half | Spread |
| `basketball_team_second_half_total` | Basketball | Team | Second half | Total |
| `basketball_team_first_quarter_spread` | Basketball | Team | 1st quarter | Spread |
| `basketball_team_first_quarter_total` | Basketball | Team | 1st quarter | Total |
| `basketball_team_second_quarter_spread` | Basketball | Team | 2nd quarter | Spread |
| `basketball_team_second_quarter_total` | Basketball | Team | 2nd quarter | Total |
| `basketball_team_third_quarter_spread` | Basketball | Team | 3rd quarter | Spread |
| `basketball_team_third_quarter_total` | Basketball | Team | 3rd quarter | Total |
| `basketball_team_fourth_quarter_spread` | Basketball | Team | 4th quarter | Spread |
| `basketball_team_fourth_quarter_total` | Basketball | Team | 4th quarter | Total |
| `basketball_game_overtime` | Basketball | Game | Full game | Overtime yes/no |
| `basketball_team_full_game_winner` | Basketball | Team | Full game | Moneyline |
| `basketball_team_full_game_spread` | Basketball | Team | Full game | Spread |
| `basketball_team_full_game_total` | Basketball | Team | Full game | Total |
| `football_team_full_game_winner` | Football | Team | Full game | Moneyline |
| `football_team_full_game_spread` | Football | Team | Full game | Spread |
| `football_team_full_game_total` | Football | Team | Full game | Total |
| `football_player_touchdowns` | Football | Player | Full game | Touchdowns from scrimmage prop (passing touchdowns excluded) |
| `football_player_rushing_yards` | Football | Player | Full game | Rushing yards prop |
| `football_player_passing_yards` | Football | Player | Full game | Passing yards prop |
| `football_player_receiving_yards` | Football | Player | Full game | Receiving yards prop |
| `football_player_passing_touchdowns` | Football | Player | Full game | Passing touchdowns prop |
| `football_player_scrimmage_yards` | Football | Player | Full game | Scrimmage yards prop (rushing plus receiving yards) |
| `football_player_receptions` | Football | Player | Full game | Receptions prop |
| `football_player_passer_rating` | Football | Player | Full game | Passer rating prop |
| `football_player_interceptions_thrown` | Football | Player | Full game | Interceptions thrown prop |
| `football_player_sacks` | Football | Player | Full game | Sacks prop |
| `football_player_defensive_interceptions` | Football | Player | Full game | Defensive interceptions prop |
| `football_player_field_goals_made` | Football | Player | Full game | Field goals made prop |
| `football_player_50_plus_yard_field_goals_made` | Football | Player | Full game | 50+ yard field goals made prop |
| `football_player_fantasy_points_ppr` | Football | Player | Full game | Fantasy points prop (PPR scoring) |
| `football_player_first_touchdown` | Football | Player | Full game | Scores the first touchdown yes/no |
| `football_player_most_passing_yards` | Football | Player | Full game | Most passing yards in the game yes/no |
| `football_player_most_rushing_yards` | Football | Player | Full game | Most rushing yards in the game yes/no |
| `football_player_most_receiving_yards` | Football | Player | Full game | Most receiving yards in the game yes/no |
| `football_player_passing_attempts` | Football | Player | Full game | Passing attempts prop |
| `football_player_passing_completions` | Football | Player | Full game | Passing completions prop |
| `football_player_rushing_attempts` | Football | Player | Full game | Rushing attempts prop |
| `football_player_longest_rush` | Football | Player | Full game | Longest rush yards prop |
| `football_player_longest_reception` | Football | Player | Full game | Longest reception yards prop |
| `football_player_team_first_touchdown` | Football | Player | Full game | Scores the selected team's first touchdown yes/no (passing touchdowns excluded) |
| `football_team_first_half_winner` | Football | Team | First half | Winner |
| `football_team_second_half_winner` | Football | Team | Second half | Winner |
| `football_team_first_quarter_winner` | Football | Team | 1st quarter | Winner |
| `football_team_second_quarter_winner` | Football | Team | 2nd quarter | Winner |
| `football_team_third_quarter_winner` | Football | Team | 3rd quarter | Winner |
| `football_team_fourth_quarter_winner` | Football | Team | 4th quarter | Winner |
| `football_team_first_half_spread` | Football | Team | First half | Spread |
| `football_team_second_half_spread` | Football | Team | Second half | Spread |
| `football_team_first_quarter_spread` | Football | Team | 1st quarter | Spread |
| `football_team_second_quarter_spread` | Football | Team | 2nd quarter | Spread |
| `football_team_third_quarter_spread` | Football | Team | 3rd quarter | Spread |
| `football_team_fourth_quarter_spread` | Football | Team | 4th quarter | Spread |
| `football_game_first_half_total` | Football | Game | First half | Combined-points total |
| `football_game_second_half_total` | Football | Game | Second half | Combined-points total |
| `football_game_first_quarter_total` | Football | Game | 1st quarter | Combined-points total |
| `football_game_second_quarter_total` | Football | Game | 2nd quarter | Combined-points total |
| `football_game_third_quarter_total` | Football | Game | 3rd quarter | Combined-points total |
| `football_game_fourth_quarter_total` | Football | Game | 4th quarter | Combined-points total |
| `football_team_points_full_game_total` | Football | Team | Full game | Selected-team points total |
| `football_team_first_half_total` | Football | Team | First half | Selected-team points total |
| `football_team_second_half_total` | Football | Team | Second half | Selected-team points total |
| `football_game_exact_margin` | Football | Game | Full game | Winning team and exact-margin bucket |
| `football_game_race_to_points` | Football | Game | Full game | First team to reach the points target (legs: each team plus Neither Team); `outcome_strike` carries the target (7, 14, 21, 28, or 35) |
| `football_game_highest_scoring_quarter` | Football | Game | Full game | Highest-scoring quarter |
| `football_game_possession_winner` | Football | Team | Full game | Time-of-possession winner |
| `football_game_tie` | Football | Game | Full game | Game ends in a tie yes/no |
| `football_game_first_score` | Football | Game | Full game | First scoring team/type |
| `football_game_first_half_first_score` | Football | Game | First half | First scoring team/type |
| `football_game_second_half_first_score` | Football | Game | Second half | First scoring team/type |
| `football_game_first_touchdown` | Football | Game | Full game | First touchdown team |
| `football_game_first_half_first_touchdown` | Football | Game | First half | First touchdown team |
| `football_game_second_half_first_touchdown` | Football | Game | Second half | First touchdown team |
| `football_game_last_score` | Football | Game | Full game | Last scoring team |
| `football_game_last_touchdown` | Football | Game | Full game | Last touchdown team |
| `football_game_first_half_both_teams_score_points` | Football | Game | First half | Both teams score points |
| `football_game_second_half_both_teams_score_points` | Football | Game | Second half | Both teams score points |
| `football_game_first_quarter_both_teams_score_points` | Football | Game | 1st quarter | Both teams score points |
| `football_game_second_quarter_both_teams_score_points` | Football | Game | 2nd quarter | Both teams score points |
| `football_game_third_quarter_both_teams_score_points` | Football | Game | 3rd quarter | Both teams score points |
| `football_game_fourth_quarter_both_teams_score_points` | Football | Game | 4th quarter | Both teams score points |
| `football_game_both_teams_score_touchdown` | Football | Game | Full game | Both teams score a touchdown |
| `football_game_first_half_both_teams_score_touchdown` | Football | Game | First half | Both teams score a touchdown |
| `football_game_second_half_both_teams_score_touchdown` | Football | Game | Second half | Both teams score a touchdown |
| `football_game_first_quarter_both_teams_score_touchdown` | Football | Game | 1st quarter | Both teams score a touchdown |
| `football_game_second_quarter_both_teams_score_touchdown` | Football | Game | 2nd quarter | Both teams score a touchdown |
| `football_game_third_quarter_both_teams_score_touchdown` | Football | Game | 3rd quarter | Both teams score a touchdown |
| `football_game_fourth_quarter_both_teams_score_touchdown` | Football | Game | 4th quarter | Both teams score a touchdown |
| `football_game_total_defensive_special_teams_touchdowns` | Football | Game | Full game | Defensive and special-teams touchdowns total |
| `football_team_total_touchdowns` | Football | Team | Full game | Selected-team touchdowns total |
| `football_game_total_touchdowns` | Football | Game | Full game | Combined touchdowns total |
| `football_game_total_pass_touchdowns` | Football | Game | Full game | Combined passing touchdowns total (also reserved for combined receiving touchdowns) |
| `football_game_total_rush_touchdowns` | Football | Game | Full game | Combined rushing touchdowns total |
| `football_game_total_pass_yards` | Football | Game | Full game | Combined passing yards total (also reserved for combined receiving yards) |
| `football_game_total_rush_yards` | Football | Game | Full game | Combined rushing yards total |
| `football_game_total_offensive_yards` | Football | Game | Full game | Combined offensive yards total |
| `football_game_total_turnovers` | Football | Game | Full game | Combined turnovers total |
| `football_game_total_interceptions` | Football | Game | Full game | Combined defensive interceptions total |
| `football_game_total_fourth_down_conversions` | Football | Game | Full game | Combined fourth-down conversions total |
| `football_game_total_two_point_conversions` | Football | Game | Full game | Successful two-point conversion yes/no (total with a 0.5 line) |
| `football_team_total_pass_touchdowns` | Football | Team | Full game | Selected-team passing touchdowns total (also used for receiving touchdowns) |
| `football_team_total_rush_touchdowns` | Football | Team | Full game | Selected-team rushing touchdowns total |
| `football_team_total_pass_yards` | Football | Team | Full game | Selected-team passing yards total (also used for receiving yards) |
| `football_team_total_rush_yards` | Football | Team | Full game | Selected-team rushing yards total |
| `football_team_total_scrimmage_yards` | Football | Team | Full game | Selected-team scrimmage yards total |
| `football_team_total_receptions` | Football | Team | Full game | Selected-team receptions total |
| `football_team_total_takeaways` | Football | Team | Full game | Selected-team takeaways total |
| `football_team_total_defensive_interceptions` | Football | Team | Full game | Selected-team defensive interceptions total |
| `football_team_total_sacks` | Football | Team | Full game | Selected-team sacks total |
| `football_team_total_field_goals_made` | Football | Team | Full game | Selected-team field goals made total |
| `football_team_total_40_plus_yard_field_goals_made` | Football | Team | Full game | Selected-team 40+ yard field goals made total |
| `football_team_total_offensive_yards` | Football | Team | Full game | Selected-team offensive yards total |
| `football_team_total_first_downs` | Football | Team | Full game | Selected-team first downs total |
| `football_team_total_fourth_down_conversions` | Football | Team | Full game | Selected-team fourth-down conversions total |
| `football_team_total_defensive_special_teams_touchdowns` | Football | Team | Full game | Selected-team defensive and special-teams touchdowns total |
| `football_game_pick_six` | Football | Game | Full game | Pick six scored yes/no |
| `football_game_kickoff_punt_return_touchdown` | Football | Game | Full game | Kickoff or punt return touchdown yes/no |
| `football_game_overtime` | Football | Game | Full game | Overtime yes/no |
| `football_game_safety` | Football | Game | Full game | Safety scored yes/no |
| `football_game_onside_kick_attempt` | Football | Game | Full game | Onside kick attempted yes/no |
| `football_game_double_result` | Football | Game | Full game | Halftime/full-time result combination (9 outcomes) |
| `football_next_team_touchdown` | Football | Game | Full game | Live in-game market: team that scores the next touchdown (legs: each team plus No TD); a new three-leg product lists after each touchdown; regulation only |
| `football_next_team_field_goal` | Football | Game | Full game | Live in-game market: team that scores the next made field goal (legs: each team plus No FG); a new three-leg product lists after each made field goal; regulation only |
| `soccer_team_full_time_winner` | Soccer | Team | Full time | Moneyline (3-way) |
| `soccer_team_full_game_spread` | Soccer | Team | Full game | Spread |
| `soccer_team_full_game_total` | Soccer | Game | Full game | Total goals across **both** teams (combined) |
| `soccer_game_btts` | Soccer | Game | Full game | Both teams to score |
| `soccer_game_first_team_to_score` | Soccer | Game | Full game | First team to score |
| `soccer_game_exact_score` | Soccer | Game | Full game | Exact score |
| `soccer_game_to_advance` | Soccer | Team | Tie/match | To advance |
| `soccer_team_first_half_winner` | Soccer | Team | First half | Prop |
| `soccer_team_first_half_spread` | Soccer | Team | First half | Spread |
| `soccer_team_first_half_total` | Soccer | Game | First half | Total goals across **both** teams (combined) |
| `soccer_game_first_half_btts` | Soccer | Game | First half | Both teams to score, first-half goals only |
| `soccer_game_first_half_first_team_to_score` | Soccer | Game | First half | First team to score, first-half goals only |
| `soccer_game_total_corners` | Soccer | Game | Full game | Total corners across **both** teams (combined) |
| `soccer_team_second_half_winner` | Soccer | Team | Second half | Prop |
| `soccer_team_second_half_spread` | Soccer | Team | Second half | Spread |
| `soccer_team_second_half_total` | Soccer | Game | Second half | Total goals across **both** teams (combined) |
| `soccer_game_second_half_btts` | Soccer | Game | Second half | Both teams to score, second-half goals only |
| `soccer_game_second_half_first_team_to_score` | Soccer | Game | Second half | First team to score, second-half goals only |
| `soccer_team_total_goals` | Soccer | Team | Full game | Total goals for a **single** team |
| `soccer_team_total_goals_first_half` | Soccer | Team | First half | Total goals for a **single** team |
| `soccer_game_total_goals_odd_even` | Soccer | Game | Full game | Total goals odd/even |
| `soccer_game_first_half_exact_score` | Soccer | Game | First half | Exact score |
| `soccer_player_goals` | Soccer | Player | Full game | Goals prop |
| `soccer_player_assists` | Soccer | Player | Full game | Assists prop |
| `soccer_player_shots` | Soccer | Player | Full game | Shots prop |
| `soccer_player_shots_on_target` | Soccer | Player | Full game | Shots on target prop |
| `soccer_player_goalkeeper_saves` | Soccer | Player | Full game | Goalkeeper saves prop |
| `soccer_player_goals_plus_assists` | Soccer | Player | Full game | Goals + assists prop |
| `soccer_team_total_corners` | Soccer | Team | Full game | Total corners for a **single** team |
| `soccer_game_corners_odd_even` | Soccer | Game | Full game | Corners odd/even |
| `soccer_game_goes_to_extra_time` | Soccer | Game | Full time | Will the match go to extra time (knockout) |
| `soccer_team_extra_time_spread` | Soccer | Team | Extra time | Spread — extra-time goals only |
| `soccer_game_extra_time_total` | Soccer | Game | Extra time | Total goals across **both** teams, extra time only |
| `soccer_game_extra_time_btts` | Soccer | Game | Extra time | Both teams to score in extra time |
| `soccer_game_extra_time_first_team_to_score` | Soccer | Game | Extra time | First team to score in extra time |
| `hockey_team_full_game_winner` | Hockey | Team | Full game | Moneyline |
| `hockey_team_full_game_spread` | Hockey | Team | Full game | Spread (puck line) |
| `hockey_team_full_game_total` | Hockey | Team | Full game | Total |
| `hockey_game_overtime` | Hockey | Game | Full game | Overtime yes/no |
| `hockey_game_double_overtime` | Hockey | Game | Full game | Double overtime yes/no |
| `hockey_player_goals` | Hockey | Player | Full game | Goals prop |
| `hockey_player_assists` | Hockey | Player | Full game | Assists prop |
| `hockey_player_points` | Hockey | Player | Full game | Points prop |
| `tennis_match_winner` | Tennis | Player | Match | Moneyline |
| `tennis_match_games_spread` | Tennis | Player | Match | Games spread |
| `tennis_match_sets_spread` | Tennis | Player | Match | Sets spread |
| `tennis_match_total_games` | Tennis | Match | Match | Total games |
| `tennis_match_total_sets` | Tennis | Match | Match | Total sets |
| `tennis_match_exact_score` | Tennis | Match | Match | Exact set score |
| `tennis_set_1_winner` | Tennis | Player | Set 1 | Set winner |
| `tennis_set_2_winner` | Tennis | Player | Set 2 | Set winner |
| `tennis_set_3_winner` | Tennis | Player | Set 3 | Set winner |
| `table_tennis_match_winner` | Table tennis | Player | Match | Moneyline |
| `table_tennis_set_1_winner` | Table tennis | Player | Set 1 | Set winner |
| `table_tennis_set_2_winner` | Table tennis | Player | Set 2 | Set winner |
| `table_tennis_set_3_winner` | Table tennis | Player | Set 3 | Set winner |
| `table_tennis_set_4_winner` | Table tennis | Player | Set 4 | Set winner |
| `cricket_match_winner` | Cricket | Team | Match | Moneyline |
| `ufc_fight_winner` | UFC | Fighter | Fight | Moneyline |
| `ufc_method_of_victory` | UFC | Fighter | Fight | Method of victory |
| `ufc_go_the_distance` | UFC | Game | Fight | Go the distance yes/no |
| `ufc_round_of_victory` | UFC | Fighter | Fight | Round of victory |
| `ufc_round_of_finish` | UFC | Fight | Fight | Round of finish |
| `ufc_method_of_finish` | UFC | Fight | Fight | Method of finish |
| `boxing_match_winner` | Boxing | Fighter | Fight | Moneyline |
| `darts_match_winner` | Darts | Player | Match | Moneyline |
| `pickleball_match_winner` | Pickleball | Team | Match | Moneyline |
| `lacrosse_team_full_game_winner` | Lacrosse | Team | Full game | Moneyline |
| `esports_match_winner` | Esports | Team | Match | Moneyline |
| `esports_map_winner_1` | Esports | Team | Map 1 | Prop |
| `esports_map_winner_2` | Esports | Team | Map 2 | Prop |
| `esports_map_winner_3` | Esports | Team | Map 3 | Prop |
| `esports_map_winner_4` | Esports | Team | Map 4 | Prop |
| `esports_game_winner_1` | Esports | Team | Game 1 | Prop |
| `esports_game_winner_2` | Esports | Team | Game 2 | Prop |
| `esports_game_winner_3` | Esports | Team | Game 3 | Prop |
| `esports_game_winner_4` | Esports | Team | Game 4 | Prop |
| `esports_series_map_handicap` | Esports | Team | Match | Maps handicap (spread) across the series |
| `esports_series_total_maps` | Esports | Match | Match | Total maps in the series |
| `esports_series_game_handicap` | Esports | Team | Match | Games handicap (spread) across the series |
| `esports_series_total_games` | Esports | Match | Match | Total games in the series |
| `esports_map_rounds_handicap_1` | Esports | Team | Map 1 | Rounds handicap (spread) |
| `esports_map_rounds_handicap_2` | Esports | Team | Map 2 | Rounds handicap (spread) |
| `esports_map_rounds_handicap_3` | Esports | Team | Map 3 | Rounds handicap (spread) |
| `esports_map_rounds_handicap_4` | Esports | Team | Map 4 | Rounds handicap (spread) |
| `esports_map_total_rounds_1` | Esports | Match | Map 1 | Total rounds |
| `esports_map_total_rounds_2` | Esports | Match | Map 2 | Total rounds |
| `esports_map_total_rounds_3` | Esports | Match | Map 3 | Total rounds |
| `esports_map_total_rounds_4` | Esports | Match | Map 4 | Total rounds |
| `esports_game_first_blood_1` | Esports | Team | Game 1 | First blood |
| `esports_game_first_blood_2` | Esports | Team | Game 2 | First blood |
| `esports_game_first_blood_3` | Esports | Team | Game 3 | First blood |
| `esports_game_first_blood_4` | Esports | Team | Game 4 | First blood |
| `esports_game_total_kills_1` | Esports | Match | Game 1 | Total kills |
| `esports_game_total_kills_2` | Esports | Match | Game 2 | Total kills |
| `esports_game_total_kills_3` | Esports | Match | Game 3 | Total kills |
| `esports_game_total_kills_4` | Esports | Match | Game 4 | Total kills |
| `esports_game_kills_odd_even_1` | Esports | Match | Game 1 | Total kills odd/even |
| `esports_game_kills_odd_even_2` | Esports | Match | Game 2 | Total kills odd/even |
| `esports_game_kills_odd_even_3` | Esports | Match | Game 3 | Total kills odd/even |
| `esports_game_kills_odd_even_4` | Esports | Match | Game 4 | Total kills odd/even |
Esports map markets (`esports_map_*`) apply to round-based titles such as Counter-Strike 2 and Valorant. Esports game markets (`esports_game_*`) apply to titles played as a series of games such as League of Legends and Dota 2. Series markets (`esports_series_*`) cover the whole best-of series.
The `market_sport_type` enum is the source of truth for sport, period, and prop variants, and is now guaranteed to be present on every instrument. When in doubt about which value applies to a market you're seeing, use this field rather than parsing the symbol.
### Generic Values
Four generic values are also registered. Each has the same market structure as the matching `outcome_type` value. They appear on instruments that carry no sport-specific value: instruments created before the sport-specific values existed, hand-listed markets, and sports that do not yet have their own winner, spread, or total type. Treat them as valid `market_sport_type` values and map them by structure: `moneyline` is a 2-way winner, `spreads` is a handicap, `totals` is an over/under, and `drawable_outcome` is a 3-way winner that admits a draw. These values carry no sport or period, so read the sport from `event_subcategory`. On Retail data, `sportsMarketType` shows the `outcome_type` value (for example `futures`) when the instrument carries no `market_sport_type` at all.
| Value | Meaning |
| ------------------ | ---------------------------------------------------------------------- |
| `moneyline` | 2-way winner market without a sport-specific type. |
| `spreads` | Handicap market without a sport-specific type. |
| `totals` | Over/under market without a sport-specific type. |
| `drawable_outcome` | 3-way winner market that admits a draw, without a sport-specific type. |
***
## Football Market Metadata
Use structured metadata rather than parsing an NFL instrument ID. Markets for the same game share an `event_id` containing the canonical game slug without a contract prefix. `event_product_id` is the exchange's event-level product grouping and is not a substitute for `event_id`; `product_id` groups the strikes or outcomes belonging to one market product.
For NFL game props, use this tuple as the canonical lookup and deduplication key:
```text theme={null}
event_external_id_sportradar + market_sport_type + long_participant_id + short_participant_id + outcome_strike
```
Participant IDs can be empty for game-wide totals. For player props, also use `external_participant_id` to resolve and validate the player.
| Field | Meaning |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| `event_id` | Canonical game slug shared by every market for the same NFL game. |
| `event_product_id` | Exchange event-level product grouping; do not use it in place of `event_id`. |
| `event_external_id_sportradar` | Sportradar game ID used for creation, querying, scores, and settlement. |
| `product_id` | Groups the strikes or outcomes belonging to one market product. |
| `market_sport_type` | Specific football market classification. |
| `outcome_type` | `moneyline`, `spreads`, or `totals` for primary lines; `props` for secondary game and player markets. |
| `prop_type` | `team` or `player`; NFL player props use `player`. |
| `outcome_strike` | Line, threshold, or binary outcome. Required and included in the deduplication key. |
| `long_participant_id` / `short_participant_id` | Canonical team IDs in `nfl-` format. |
| `external_participant_id` | Sportradar player ID for player props, or the selected provider team ID where applicable. |
| `interval_start` / `interval_end` | Exact-margin bucket boundaries used for display and settlement. |
### Football Metadata Profiles
In addition to `event_id`, `event_external_id_sportradar`, `market_sport_type`, and `product_id`, use the fields required by the market's profile:
| Profile | Additional required metadata |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| Game + line | `outcome_strike`; participant IDs are not required. |
| Game/team + line | `long_participant_id`, `short_participant_id`, `outcome_strike`. |
| Team + line | `long_participant_id`, usually `external_participant_id`, `outcome_strike`. |
| Player + line | `external_participant_id`, `long_participant_id`, `prop_type=player`, `outcome_strike`. |
| Game + outcome | `outcome_strike`; exact-margin markets also need `interval_start`, `interval_end`, and sort order. |
| Game + binary strike | `outcome_strike` plus the `market_sport_type` that encodes the period and statistic. |
Race-to-points markets (`football_game_race_to_points`) are mutually exclusive team-outcome products, like the first-score markets. Each points target (7, 14, 21, 28, 35) is one product with three instruments: away team, home team, and Neither Team. `outcome_strike` carries the points target on all three legs. `long_participant_id` names the team on the team legs and is absent on the Neither Team leg; `short_participant_id` is not set.
Live next-touchdown and next-field-goal markets (`football_next_team_touchdown`, `football_next_team_field_goal`) re-list during the game. Each touchdown or field-goal number is one product with three instruments: away team, home team, and No TD or No FG. The first instance lists at kickoff, a new instance lists after each confirmed touchdown or made field goal, and none lists in overtime. Successive instances share `market_sport_type`, `event_id`, and participant IDs, so the canonical deduplication key above does not separate them. Use `product_id` (`-next-team-td-`, `-next-team-fg-`) or the `touchdown_number` / `field_goal_number` metadata field instead. On these legs `outcome_strike` holds the team abbreviation or `no-td` / `no-fg`, not a number.
***
## Section 2: Identifying Markets
Use this table as a recipe book for identifying a specific market type from instrument metadata. **Match on `market_sport_type` alone** — it fully identifies any market (structure and period), so you no longer need to check `outcome_type`.
| To identify... | `market_sport_type` |
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Full-game moneyline** | `_team_full_game_winner` (soccer uses `soccer_team_full_time_winner`, a 3-way market) |
| **Full-game spread** | `_team_full_game_spread` |
| **Full-game total** | `_team_full_game_total` |
| **MLB first-5-innings moneyline** | `baseball_team_first_five_winner` |
| **MLB first-5-innings spread** | `baseball_team_first_five_spread` |
| **MLB first-5-innings total** | `baseball_team_first_five_total` |
| **MLB first-inning run** | `baseball_team_first_inning_run` |
| **MLB inning winner (innings 1–9)** | `baseball_team_inning1_winner` through `baseball_team_inning9_winner` — derive the inning number from this enum value, not the instrument ID |
| **MLB player home runs prop** | `baseball_player_home_runs` |
| **MLB player strikeouts prop** | `baseball_player_strikeouts` |
| **MLB player RBIs prop** | `baseball_player_rbis` |
| **MLB player stolen bases prop** | `baseball_player_stolen_bases` |
| **MLB selected-team total runs** | `baseball_team_total_runs` |
| **NBA first-half moneyline** | `basketball_team_first_half_winner` |
| **NBA first-half spread** | `basketball_team_first_half_spread` |
| **NBA first-half total** | `basketball_team_first_half_total` |
| **NBA player points prop** | `basketball_player_points` |
| **NBA player assists prop** | `basketball_player_assists` |
| **NFL player anytime touchdown prop** | `football_player_touchdowns` |
| **NFL player rushing yards prop** | `football_player_rushing_yards` |
| **NFL player passing yards prop** | `football_player_passing_yards` |
| **NFL player receiving yards prop** | `football_player_receiving_yards` |
| **NFL player passing touchdowns prop** | `football_player_passing_touchdowns` |
| **NFL player fantasy points (PPR) prop** | `football_player_fantasy_points_ppr` |
| **NFL race to X points** | `football_game_race_to_points` (`outcome_strike` carries the points target; three legs per target: away team, home team, Neither Team) |
| **NFL live next touchdown / next field goal** | `football_next_team_touchdown` / `football_next_team_field_goal` |
| **Table tennis set winner (sets 1–4)** | `table_tennis_set_1_winner` through `table_tennis_set_4_winner` |
| **Esports series handicap and total** | `esports_series_map_handicap` / `esports_series_total_maps` (map-based titles), `esports_series_game_handicap` / `esports_series_total_games` (game-based titles) |
| **Boxing, darts, pickleball, or lacrosse winner** | `boxing_match_winner`, `darts_match_winner`, `pickleball_match_winner`, `lacrosse_team_full_game_winner` |
### Worked Example: Cleveland/Detroit Over 4.5 Total
A full-game total on the May 21 Cleveland Guardians vs Detroit Tigers MLB game:
```json theme={null}
{
"symbol": "tsc-mlb-cle-det-2026-05-21-4pt5",
"metadata": {
"event_id": "mlb-cle-det-2026-05-21",
"event_start_time": "2026-05-21 17:10:00+00",
"event_subcategory": "BASEBALL",
"outcome_type": "totals",
"market_sport_type": "baseball_team_full_game_total",
"outcome_strike": "4.5",
"long_participant_id": "mlb-cle",
"long_participant_name": "Cleveland Guardians",
"short_participant_id": "mlb-det"
}
}
```
To safely interpret this contract:
1. `market_sport_type = "baseball_team_full_game_total"` → full-game total. (`outcome_type` is also present but you don't need it.)
2. `event_subcategory = "BASEBALL"` → MLB game.
3. `outcome_strike = "4.5"` → over/under line is 4.5 combined runs.
4. The contract resolves "Over" if the combined score is 4.5 or more, otherwise "Under".
### Worked Example: Cleveland +3.5 Spread
A full-game run-line spread on the May 20 Cleveland Guardians vs Detroit Tigers MLB game:
```json theme={null}
{
"symbol": "asc-mlb-cle-det-2026-05-20-pos-3pt5",
"metadata": {
"event_id": "mlb-cle-det-2026-05-20",
"event_start_time": "2026-05-20 22:40:00+00",
"event_subcategory": "BASEBALL",
"outcome_type": "spreads",
"market_sport_type": "baseball_team_full_game_spread",
"outcome_strike": "3.5",
"long_participant_id": "mlb-cle",
"long_participant_name": "Cleveland Guardians",
"short_participant_id": "mlb-det"
}
}
```
To safely interpret this contract:
1. `market_sport_type = "baseball_team_full_game_spread"` → full-game spread. (`outcome_type` is also present but you don't need it.)
2. `long_participant_id = "mlb-cle"` → the contract pays out on Cleveland.
3. `outcome_strike = "3.5"` → handicap magnitude is 3.5 runs.
4. The contract resolves to Cleveland if Cleveland wins, or loses by fewer than 3.5 runs.
***
## Best Practices
* **Never parse the symbol or slug** to determine market type, period, or handicap. Symbol formats are not part of the public contract.
* **Map on `market_sport_type` alone.** It is guaranteed on every instrument — full-game, sub-period, and prop alike — and fully identifies the market. `outcome_type` is still present on the instrument, but **do not rely on it for mapping** (it is subject to change); the sole exception is futures, which carry no `market_sport_type` and are identified by `outcome_type = "futures"`.
* **Treat `outcome_strike` as a string** in client code and convert to your numeric type. The value is unsigned — the spread direction is determined by `long_participant_id`.
* **Cache and version your enum mappings.** New `market_sport_type` values are announced in the [changelog](/changelog) and rolled out in preprod before production. Subscribe to the RSS feed to be notified before new enums appear in production. An instrument can carry a value that is not yet in this inventory: treat an unknown value as a prop, fall back to `outcome_type` for its structure, and watch the changelog for the new value.
* **Subscribe to instrument updates** via the streaming APIs to catch new instruments as they are listed.