Props Markets States and Messages (Beta)
What is a Kero Props Market?
Section titled “What is a Kero Props Market?”Props are player specific markets that focus on specific player performances across a wide range of different metrics.
Props Market Actions
Section titled “Props Market Actions”-
MARKET_PRICE{"type": "MARKET","sub_type": "PROPS","object": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"outcomes": {"875645": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"id": 875645,"value": 6.5,"type": "OVER","true_pb": 0.4827,"pb": 0.5454,"entities": [{"type": "PLAYER","id": 2869,"name": "Nick Lodolo"}],"alts": [{"value": 3.5,"pb": 0.9684,"true_pb": 0.8834},{"value": 4.5,"pb": 0.8577,"true_pb": 0.7654},{"value": 10.5,"pb": 0.1722,"true_pb": 0.0672}]},"875646": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"id": 875646,"value": 6.5,"type": "UNDER","true_pb": 0.5173,"pb": 0.5799,"entities": [{"type": "PLAYER","id": 2869,"name": "Nick Lodolo"}],"alts": null},"881432": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"id": 881432,"value": 3.5,"type": "UNDER","true_pb": 0.4302,"pb": 0.4948,"entities": [{"type": "PLAYER","id": 2869,"name": "Nick Lodolo"}],"alts": null}}},"action": "MARKET_PRICE","timestamp": 1747883808522}- When received, the client should assume this message contains prices for all outcomes associated with that market id. More specifically, an outcome not included in this message that was previously transmitted is considered suspended/not being quoted
- Next possible actions:
OUTCOME_PRICE,SETTLEMENT
-
OUTCOME_PRICE{"type": "MARKET","sub_type": "PROPS","object": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"id": 875645,"value": 6.5,"type": "OVER","true_pb": 0.4827,"pb": 0.5454,"entities": [{"type": "PLAYER","id": 2869,"name": "Nick Lodolo"}],"tradable": true,"status": "TRADABLE","alts": [{"value": 3.5,"pb": 0.9684,"true_pb": 0.8834,"is_milestone": false,"is_tradable": true},{"value": 4.5,"pb": 0.8577,"true_pb": 0.7654,"is_milestone": false,"is_tradable": true},{"value": 10.5,"pb": 0.1722,"true_pb": 0.0672,"is_milestone": false,"is_tradable": true}]},"action": "OUTCOME_PRICE","timestamp": 1747891145638}- When received, the client should assume this message updates only the given (market_id, outcome_id) pair and leaves all other outcome_ids in the same market unchanged. This message will contain the main line, and any alterative lines we are pricing. Any lines (called outcome values) not appearing in this message are considered suspended/no longer being quoted for the given (market_id, outcome_id) pair.
- Next possible actions:
MARKET_PRICE,SETTLEMENT
-
SETTLEMENT(not always){"type": "MARKET","sub_type": "PROPS","object": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"market_mechanics": "OVER_UNDER","entities": [{"type": "PLAYER","id": 9148,"name": "Huascar Brazoban"},{"type": "TEAM","id": 7997,"name": "Miami Marlins"}],"stat_value": 2.0,"settlement_state": "SETTLED","voided_state": "UNVOIDED","period_state": "FINISHED","winners": [{"outcome_type": "OVER","outcome_id": 874025,"above": null,"below": 1.5},{"outcome_type": "UNDER","outcome_id": 874026,"above": 2.5,"below": null}],"losers": [{"outcome_type": "OVER","outcome_id": 874025,"above": 2.5,"below": null},{"outcome_type": "UNDER","outcome_id": 874026,"above": null,"below": 1.5}],"pushes": [{"outcome_type": "OVER","outcome_id": 874025,"above": 2.0,"below": 2.0},{"outcome_type": "UNDER","outcome_id": 874026,"above": 2.0,"below": 2.0}],"voids":[],"metadata": {}},"action": "SETTLEMENT","timestamp": 1747891145638}- Contains settlement information for a collection of outcomes in a market.
- Next possible actions:
EXPLICIT_SETTLEMENT
-
EXPLICIT_SETTLEMENT{"type": "MARKET","sub_type": "PROPS","object": {"event_id": "7d11a558-5fa1-4c8b-91b6-9b1fce11a36d","market_id": "f668332f-cc84-46a1-9a91-fdd8e5a46bb6","market_type": "PLAYER_STRIKEOUTS","market_span": "FULL","market_span_seq": 1,"market_mechanics": "OVER_UNDER","entities": [{"type": "PLAYER","id": 9148,"name": "Huascar Brazoban"},{"type": "TEAM","id": 7997,"name": "Miami Marlins"}],"stat_value": 2.0,"settlement_state": "SETTLED","winners": [{"outcome_type": "OVER","outcome_id": 874025,"outcome_value": 1.5},{"outcome_type": "OVER","outcome_id": 874025,"outcome_value": 0.5},{"outcome_type": "UNDER","outcome_id": 874026,"outcome_value": 2.5},{"outcome_type": "UNDER","outcome_id": 874026,"outcome_value": 3.5}],"losers": [{"outcome_type": "OVER","outcome_id": 874025,"outcome_value": 2.5},{"outcome_type": "UNDER","outcome_id": 874026,"outcome_value": 1.5}],"pushes": [{"outcome_type": "OVER","outcome_id": 874025,"outcome_value": 2.0},{"outcome_type": "UNDER","outcome_id": 874026,"outcome_value": 2.0}],"voids":[],"metadata": {}},"action": "EXPLICIT_SETTLEMENT","timestamp": 1747891145638}- Contains settlement information for a collection of outcomes in a market including explicit outcome values.
- Next possible actions: None
Props Market And Outcome Types
Section titled “Props Market And Outcome Types”-
PLAYER
Value Outcome Types PLAYER_STRIKEOUTS OVER, UNDER PLAYER_HITS_ALLOWED OVER, UNDER PLAYER_EARNED_RUNS OVER, UNDER PLAYER_WALKS OVER, UNDER PLAYER_SINGLES OVER, UNDER PLAYER_DOUBLES OVER, UNDER PLAYER_TRIPLES OVER, UNDER PLAYER_BASES OVER, UNDER PLAYER_HITS OVER, UNDER PLAYER_RUNS OVER, UNDER PLAYER_RBIS OVER, UNDER PLAYER_HITS_AND_RUNS_AND_RBIS OVER, UNDER PLAYER_HOME_RUNS OVER, UNDER PLAYER_STOLEN_BASES OVER, UNDER PLAYER_BATTING_WALKS OVER, UNDER PLAYER_BATTING_STRIKEOUTS OVER, UNDER PLAYER_RUNS_ALLOWED OVER, UNDER PLAYER_OUTS OVER, UNDER PLAYER_FIRST_TO_HOMERUN OVER, UNDER -
TEAM
Value Outcome Types HOME_TEAM_POINTS OVER, UNDER AWAY_TEAM_POINTS OVER, UNDER HOME_TEAM_HITS OVER, UNDER AWAY_TEAM_HITS OVER, UNDER RACE_TO_1_RUNS HOME, AWAY RACE_TO_2_RUNS HOME, AWAY RACE_TO_3_RUNS HOME, AWAY RACE_TO_4_RUNS HOME, AWAY RACE_TO_5_RUNS HOME, AWAY RACE_TO_6_RUNS HOME, AWAY RACE_TO_7_RUNS HOME, AWAY -
MAIN LINES
Value Outcome Types OVER_UNDER OVER, UNDER HANDICAP HOME, AWAY MONEY_LINE HOME, AWAY ODD_OR_EVEN EVEN, ODD -
MATCH
Value Outcome Types WILL_THERE_BE_EXTRA_INNINGS YES, NO
-
PLAYER
Value Outcome Types PLAYER_POINTS OVER, UNDER PLAYER_REBOUNDS OVER, UNDER PLAYER_ASSISTS OVER, UNDER PLAYER_STEALS OVER, UNDER PLAYER_BLOCKS OVER, UNDER PLAYER_STEALS_BLOCKS OVER, UNDER PLAYER_FREE_THROWS_ATTEMPTED OVER, UNDER PLAYER_TWO_POINTERS_ATTEMPTED OVER, UNDER PLAYER_THREE_POINTERS_ATTEMPTED OVER, UNDER PLAYER_FIELD_GOALS_ATTEMPTED OVER, UNDER PLAYER_TWO_POINTERS_MADE OVER, UNDER PLAYER_THREE_POINTERS_MADE OVER, UNDER PLAYER_FREE_THROWS_MADE OVER, UNDER PLAYER_FIELD_GOALS_MADE OVER, UNDER PLAYER_TURNOVERS OVER, UNDER PLAYER_POINTS_REBOUNDS_ASSISTS OVER, UNDER PLAYER_DOUBLE_DOUBLE OVER, UNDER PLAYER_TRIPLE_DOUBLE OVER, UNDER PLAYER_POINTS_ASSISTS OVER, UNDER PLAYER_POINTS_REBOUNDS OVER, UNDER PLAYER_REBOUNDS_ASSISTS OVER, UNDER PLAYER_FANTASY_POINTS OVER, UNDER PLAYER_FIRST_TO_REBOUND OVER, UNDER PLAYER_FIRST_TO_DEFENSIVE_REBOUND OVER, UNDER PLAYER_FIRST_TO_OFFENSIVE_REBOUND OVER, UNDER PLAYER_FIRST_TO_SCORE OVER, UNDER PLAYER_FIRST_TO_SCORE_FREE_THROW OVER, UNDER PLAYER_FIRST_TO_SCORE_TWO_POINTER OVER, UNDER PLAYER_FIRST_TO_SCORE_THREE_POINTER OVER, UNDER PLAYER_FIRST_TO_ASSIST OVER, UNDER PLAYER_FIRST_TO_ASSIST_TWO_POINTER OVER, UNDER PLAYER_FIRST_TO_ASSIST_THREE_POINTER OVER, UNDER -
TEAM
Value Outcome Types HOME_TEAM_POINTS OVER, UNDER AWAY_TEAM_POINTS OVER, UNDER HOME_TEAM_TURNOVERS OVER, UNDER AWAY_TEAM_TURNOVERS OVER, UNDER HOME_TEAM_REBOUNDS OVER, UNDER AWAY_TEAM_REBOUNDS OVER, UNDER HOME_TEAM_ASSISTS OVER, UNDER AWAY_TEAM_ASSISTS OVER, UNDER HOME_TEAM_STEALS OVER, UNDER AWAY_TEAM_STEALS OVER, UNDER HOME_TEAM_THREE_POINTERS_MADE OVER, UNDER AWAY_TEAM_THREE_POINTERS_MADE OVER, UNDER -
MAIN LINES
Value Outcome Types OVER_UNDER OVER, UNDER HANDICAP HOME, AWAY MONEY_LINE HOME, AWAY ODD_OR_EVEN ODD, EVEN -
MATCH
Value Outcome Types TOTAL_ASSISTS OVER, UNDER TOTAL_BLOCKS OVER, UNDER TOTAL_REBOUNDS OVER, UNDER TOTAL_STEALS OVER, UNDER TOTAL_TURNOVERS OVER, UNDER TOTAL_THREE_POINTERS_MADE OVER, UNDER
-
PLAYER
Value Outcome Types PLAYER_PASSING_YARDS OVER, UNDER PLAYER_RECEIVING_YARDS OVER, UNDER PLAYER_RUSHING_YARDS OVER, UNDER PLAYER_PASSING_TOUCHDOWNS OVER, UNDER PLAYER_RECEIVING_TOUCHDOWNS OVER, UNDER PLAYER_RUSHING_TOUCHDOWNS OVER, UNDER PLAYER_PASSING_COMPLETIONS OVER, UNDER PLAYER_RECEPTIONS OVER, UNDER PLAYER_INTERCEPTIONS OVER, UNDER PLAYER_FIELD_GOALS_MADE OVER, UNDER PLAYER_KICKING_POINTS OVER, UNDER PLAYER_PASSING_AND_RUSHING_YARDS OVER, UNDER PLAYER_RUSHING_AND_RECEIVING_YARDS OVER, UNDER PLAYER_TOUCHDOWNS OVER, UNDER PLAYER_SACKS OVER, UNDER PLAYER_PASSING_ATTEMPTS OVER, UNDER PLAYER_RUSHING_ATTEMPTS OVER, UNDER PLAYER_DEFENSIVE_INTERCEPTIONS OVER, UNDER PLAYER_TACKLES OVER, UNDER PLAYER_ASSISTS OVER, UNDER PLAYER_TACKLES_AND_ASSISTS OVER, UNDER PLAYER_FANTASY_POINTS OVER, UNDER PLAYER_LONGEST_PASSING_COMPLETION OVER, UNDER PLAYER_FUMBLES OVER, UNDER PLAYER_FUMBLES_LOST OVER, UNDER PLAYER_LONGEST_RECEPTION OVER, UNDER PLAYER_LONGEST_RUSH OVER, UNDER PLAYER_FIRST_TOUCHDOWN_SCORER OVER, UNDER PLAYER_LAST_TOUCHDOWN_SCORER OVER, UNDER PLAYER_EXTRA_POINTS_MADE OVER, UNDER -
TEAM
Value Outcome Types TEAM_FIRST_TOUCHDOWN OVER, UNDER TEAM_LAST_TOUCHDOWN OVER, UNDER TEAM_TOTAL_TOUCHDOWNS OVER, UNDER TEAM_DEFENSE_OR_SPECIAL_TEAMS_TOUCHDOWN OVER, UNDER TEAM_PASSING_TOUCHDOWNS OVER, UNDER TEAM_RECEIVING_TOUCHDOWNS OVER, UNDER TEAM_RUSHING_TOUCHDOWNS OVER, UNDER TEAM_OFFENSIVE_TOUCHDOWNS OVER, UNDER TEAM_PASSING_YARDS OVER, UNDER TEAM_RECEIVING_YARDS OVER, UNDER TEAM_RUSHING_YARDS OVER, UNDER TEAM_OFFENSE_YARDS OVER, UNDER TEAM_RUSHING_AND_RECEIVING_YARDS OVER, UNDER TEAM_RECEPTIONS OVER, UNDER TEAM_RUSHING_ATTEMPTS OVER, UNDER TEAM_TACKLES OVER, UNDER TEAM_TACKLES_AND_ASSISTS OVER, UNDER TEAM_SACKS OVER, UNDER TEAM_FUMBLES OVER, UNDER TEAM_LOST_FUMBLES OVER, UNDER TEAM_TWO_POINT_ATTEMPTS OVER, UNDER TEAM_TWO_POINTS_MADE OVER, UNDER TEAM_PASSING_YARDS_GROSS OVER, UNDER -
MAIN LINES
Value Outcome Types OVER_UNDER OVER, UNDER HANDICAP HOME, AWAY MONEY_LINE HOME, AWAY -
MATCH
Value Outcome Types TOTAL_TOUCHDOWNS OVER, UNDER TOTAL_PASSING_TOUCHDOWNS OVER, UNDER TOTAL_RECEIVING_TOUCHDOWNS OVER, UNDER TOTAL_RUSHING_TOUCHDOWNS OVER, UNDER TOTAL_OFFENSIVE_TOUCHDOWNS OVER, UNDER TOTAL_PASSING_YARDS OVER, UNDER TOTAL_RECEIVING_YARDS OVER, UNDER TOTAL_RUSHING_YARDS OVER, UNDER TOTAL_RUSHING_AND_RECEIVING_YARDS OVER, UNDER TOTAL_PASSING_AND_RUSHING_YARDS OVER, UNDER TOTAL_OFFENSE_YARDS OVER, UNDER TOTAL_PASSING_ATTEMPTS OVER, UNDER TOTAL_PASSING_COMPLETIONS OVER, UNDER TOTAL_RECEPTIONS OVER, UNDER TOTAL_RUSHING_ATTEMPTS OVER, UNDER TOTAL_TACKLES OVER, UNDER TOTAL_TACKLES_AND_ASSISTS OVER, UNDER TOTAL_SACKS OVER, UNDER TOTAL_FUMBLES OVER, UNDER TOTAL_LOST_FUMBLES OVER, UNDER TOTAL_TWO_POINT_ATTEMPTS OVER, UNDER TOTAL_TWO_POINTS_MADE OVER, UNDER TOTAL_PASSING_YARDS_GROSS OVER, UNDER
Props Outcome States
Section titled “Props Outcome States”| Value | Description |
|---|---|
UNSETTLED | Outcome is not settled yet |
AWAITING_SETTLEMENT | Settlement process has just begun |
PRELIMINARY_SETTLEMENT | Finished first stage of settlement, awaiting final confirmation |
PRELIMINARY_SETTLEMENT_NO_DATA | Finished first stage of settlement, and have not received stats for this prop yet. |
PARTIAL_SETTLEMENT | Occurs when some of the outcomes in the market have settled (e.g., an Over 2.5 market where the stat is currently 3) |
SETTLED | Settlement is final |
SETTLED_NO_DATA | The match has finished and we tried to settle this prop but still don’t have stats from our providers. This will be resolved when we get the stats, or we determine that the prop should be voided for some reason (e.g., the player was on injured reserve). |
CONFLICTED | We have detected an issue with the market being settled, and are working to resolve it |
| Value | Description |
|---|---|
UNINITIALIZED | Outcome is uninitialized |
UNVOIDED | Outcome is not voided |
PARTIALLY_VOIDED | Some outcomes voided, some outcome settled (e.g., if overs have paid out and the match is canceled midway) |
VOIDED | All outcomes voided |
| Value | Description |
|---|---|
UNINITIALIZED | Period is uninitialized |
UNFINISHED | Period hasn’t finished yet |
FINISHED | Period is finished |
UNKNOWN | Period state is currently unknown |
NOT_PLAYED | Period was not played |
Props SGP
Section titled “Props SGP”This product allows for combinations of various props to be grouped across the same or multiple games.
Props SGP Statuses
Section titled “Props SGP Statuses”| Value | Meaning |
|---|---|
INVALID | Unknown IDs given |
ACCEPTED | Valid SGP was priced |
REJECTED | Valid SGP was not priced (often because one of the legs is not tradable) |
EXCEPTION | An exception was thrown |
TIMEOUT | The request timed out |
Props SGP Details
Section titled “Props SGP Details”| Value | Meaning |
|---|---|
NONE | No details |
UNKNOWN | Unknown reject reason |
LEG_UNAVAILABLE | One of the parlay legs is unavailable |
LEG_UNAVAILABLE_SGP | One of the parlay legs is unavailable for SGP |
EVENT_UNAVAILABLE | Event not available for SGP |
LIKELY_VOID | Chance of voiding is too high |
INVALID_ODDS | Resulting SGP price not in acceptable range |
TIMEOUT | SGP response timed out |
COMBINATION_UNAVAILABLE | Some combination of legs is unavailable for SGP |
INVALID_REQUEST | The request object was not able to be parsed or is missing required information |