Open Hand History
  • 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_bounties
  • Bet Limit Object
    • <bet_limit_obj>
      • bet_cap
      • bet_type
  • Player Object
    • <player_obj>
      • id
      • seat
      • name
      • display
      • starting_stack
      • player_bounty
      • is_sitting_out
  • 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
      • jackpot
      • player_wins
  • Player Wins Object
    • <player_wins>
      • player_id
      • win_amount
      • cashout_amount
      • cashout_fee
      • bonus_amount
  • Tournament Info Object
    • <tournament_info_obj>
      • tournament_number
      • name
      • start_date_utc
      • currency
      • buyin_amount
      • bounty_fee_amount
      • fee_amount
      • initial_stack
      • type
      • flags
      • speed
  • 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
    • 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
On this page

Was this helpful?

Overview

NextGuiding Principles

Last updated 1 year ago

Was this helpful?

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 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 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 .

Change Request Process
Change Request Process
standardized tournament summary specification