O
O
Open Hand History
Search…
Overview
Guiding Principles
JSON Object
Storage Format
Standardized Hand History JSON
The Specification
spec_version
site_name
network_name
internal_version
tournament
tournament_info
game_number
start_date_utc
table_name
table_handle
table_skin
game_type
bet_limit
table_size
currency
dealer_seat
small_blind_amount
big_blind_amount
ante_amount
hero_player_id
flags
players
rounds
pots
tournament_rebuys
tournament_bounties
Bet Limit Object
<bet_limit_obj>
Player Object
<player_obj>
Round Object
<round_obj>
Action Object
<action_obj>
Pot Object
<pot_obj>
Player Wins Object
<player_wins>
cashout_amount
cashout_fee
bonus_amount
Tournament Info Object
<tournament_info_obj>
Tournament Rebuy Object
<tournament_rebuy_obj>
Tournament Bounty Object
<tournament_bounty_obj>
Speed Object
<speed_obj>
String Formats
version_string
card_string
Examples
Holdem cash hand (iPoker)
Holdem cash hand (PokerStars)
Omaha cash hand (WPN)
Omaha hi/lo cash hand (PokerStars)
Holdem cash hand (888)
Holdem tournament hand (888)
Holdem tournament hand (PokerStars)
Holdem tournament hand (iPoker)
Contact Us
Change Request Process
Support
CHANGE LOG
Change Log
Powered By GitBook
Overview
A hand history is a ledger of every piece of information and action that occurred within an online poker hand. The hand histories must provide all of the information needed for the user to fully reconstruct the hand from the user's point of view. This specification standardizes the format of these hand histories to ensure that all the data is available to the user regardless of where the hand was played or how the hand intends to be reviewed.
This specification is intended to be an open format that any poker site or network is free to use to ensure that they are providing complete hand history data to their players and the hand histories can be consumed via any tool of the customer's choice for review.
Online Poker Operators
If the specification does not meet your needs for a particular use case, please see the Change Request Process to learn how to submit your recommended changes for review and inclusion into the specification. The specification is versioned to allow for continual improvements.
Third Party Developers
We strongly encourage every third party developer to support consumption of hand histories conformed to the specification. If you believe that certain information is potentially missing or could be a benefit to be included in the hand history, please see the Change Request Process to learn how to submit your recommended changes for review and potential inclusion into the specification. The specification is versioned to allow for continual improvements.
Tournament Summaries
Where hand histories outline every action within a single poker hand, they cannot contain all of the information needed about a tournament as a whole and some of that data may not be available until the conclusion of the tournament. Tournament summaries are equally as important as hand histories; however, due to their structural differences, there is a separate and independent standardized tournament summary specification.
Next
Guiding Principles
Last modified 3yr ago
Copy link