Change Log

The specification is versioned to allow for continual improvements. This page lists the changes in each version.

1.4.7 - March 4, 2024

• Deprecated contributed_rake in the player_wins object.

1.4.6 - February 28, 2024

• Changed play money from "PPC" to "XPM" in the currency section. PPC will still be supported for existing hands but XPM should be used for new hands.

1.4.5 - January 25, 2024

• Added "Add to Pot" action for cases where the site adds bonus money or chips to the pot.

• Made player_id optional to allow for "Add to Pot" action.

1.4.4 - January 25, 2024

• Clarified that all fields are required unless otherwise stated.

• Added optional/nullable to several fields:

  • small_blind_amount

  • big_blind_amount

  • pot_obj > rake

  • player_wins > contributed_rake

  • tournament_info_obj > (buyin_amount, bounty_fee_amount, fee_amount, flags)

• Added "is_sitting_out" in <player_obj> so that players who are sitting out can be included in the player list.

1.4.3 - August 3, 2022

• Removed re-buy information as it is being moved to the Open Tournament Summary (OTS) specification.

1.4.2 - July 13, 2022

• Removed the explicit requirement for there to be a Showdown round in the Rounds list. This is only required if a hand goes to showdown, or a player chooses to show their cards without a showdown.

1.4.1 - March 23, 2022

• Specified that the following fields are optional:

  • able_handle

  • table_skin

  • flags

  • round_obj > cards, player_obj > display

1.4.0 - Feb. 25, 2022

• Clarified that "Run_It_Twice" flag is used for any number of runs.

• Added "jackpot" in <pot_obj>

• Added "cashout", "cashout_fee", "bonus" in <player_wins>

• Clarified that "amount" and "is_allin" are optional in <action_obj>

1.3.0 - July 02, 2020

• Added "tournament"

• Added "table_skin"

• Added "display" in <player_obj>

1.2.2. - June 19, 2020

• Corrected "round" to "id" in the 'id' field of <round_obj>

1.2.1 - June 01, 2020

• Corrected "players_wins" to "player_wins" in <pot_obj>

1.2.0 - April 23, 2020

• Added a root object to wrap each hand and identify the type of JSON object. {"ohh": <standardized_hand_history_object>}

1.1.1 - February 27, 2020

• Added table_handle

1.0.1 - Late 2019

• hero_player_id was changed to Nullable. Null example added.

• <action_obj>.cards was changed to Nullable. Null example added.

• <round_object>.street options are capitalized instead of all lowercase. Example updated. Flags options are capitalized instead of all uppercase. Example updated.

• player_obj>.player_bounty was changed to nullable. Info panel text changed from "For bounty tournaments only." to "For bounty tournaments only. Omit for other games." Null example added.

• <tournament_info_obj>.flags - all non-acronym options changed to caplitalized instead of all uppercase.

• <tournament_rebuy_obj> - all options changed to capitalized instead of all uppercase.

• <speed_obj>.type - all options changed to capitalized instead of all uppercase.

• ante_amount - corrected typo "f the game..." to "If the game...".

• Rounds - "(Pre-Flop)" changed to "(Preflop)" in text to match names used in <round_obj>.street.

• <bet_limit_obj>.bet_type - "No-Limit" changed to "No Limit" to match the other options.

• round_obj>.id - added text "The first round is round zero."

• <round_obj>.actions - corrected typo "Maining the order..." to "Maintaining the order...". Changed "id" to "Id" or "identifier" in text in a few places for consistency.

v1.0.0 - Late 2019

The initial version