S
S
Standardized 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>
bet_type
bet_cap
Player Object
<player_obj>
id
seat
name
display
starting_stack
player_bounty
Round Object
<round_obj>
id
street
cards
actions
Action Object
<action_obj>
action_number
player_id
action
amount
is_allin
cards
Pot Object
<pot_obj>
number
amount
rake
player_wins
Player Wins Object
<player_wins>
player_id
win_amount
contributed_rake
Tournament Info Object
<tournament_info_obj>
tournament_number
name
start_date_utc
currency
buyin_amount
fee_amount
bounty_fee_amount
initial_stack
type
flags
speed
Tournament Rebuy Object
<tournament_rebuy_obj>
player_id
rebuy_action
amount
chips
Tournament Bounty Object
<tournament_bounty_obj>
player_id
bounty_won
defeated_player_id
Speed Object
<speed_obj>
type
round_time
String Formats
version_string
card_string
Examples
Coming soon
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 2yr ago
Copy link