What's Actually in Your Poker Hand History, and What It Can't Tell You

A poker hand history is the plain-text (or JSON) record your room writes every time a hand finishes: hole cards, bet sizes, positions, timestamps, and nothing else. It's a transcript, not a verdict. The room logs what happened. It never tells you what you should have done instead, and mistaking one for the other is how most players waste the file entirely.

That gap between "here's the record" and "here's what it means" is the whole subject of this article. It also explains why a search for this exact phrase turns up datasets and hand-mining shops instead of anything about your own game.

What a poker hand history actually is

A hand history is a per-hand log entry your poker client writes to disk (or to a server log you can export) the moment a hand ends. It records seats, stack sizes, blinds, every action on every street, the board, and a timestamp. It does not record why anyone did anything.

What format is a hand history written in?

Most rooms write plain text, one file per session or per day, with each hand as its own block. A few, including some newer platforms, use JSON instead. The underlying content is nearly identical across formats: seat number, stack, action, street, repeat. What differs is the layout, which is why a parser built for PokerStars chokes on a Winamax file without translation.

The scale of this data is bigger than most players assume. The PHH dataset project on GitHub tried to unify 11 poker variants under one shared hand history format, and one of its source collections alone holds 21,605,687 uncorrupted no-limit hold'em hands scraped from six different rooms in July 2009, according to the dataset's Zenodo record. Online poker's addressable market runs into the billions annually according to Statista's gambling research, but none of that scale does your session review for you. That part stays manual, or it stays undone.

Where to find your hand history, room by room

Not every room hands you the file the same way, and that alone stops more players than the format itself. Some clients save every hand automatically to a local folder the moment it's dealt. Others require you to log in, pick a date range, and request an export by email.

Does every room save hand histories the same way?

No. PokerStars and WPN skins (ACR included) save locally by default once you enable it in settings, though the option isn't always on out of the box. On WPN's client, the maximum retention window is 30 days, and the file needs to be set to English or several third-party trackers won't parse it. GGPoker and CoinPoker work differently: GGPoker's history lives inside its Pokercraft dashboard, and CoinPoker requires you to open Game History and request a custom date range by email, according to a walkthrough by poker coach Mateus Thomaz. Skip the manual export for even one month and the room may not let you recover it later.

If you play on Winamax or on ACR, the exact folder path is the part that trips people up most, since neither room advertises it clearly in its interface.

Why your hand history looks unreadable the first time you open it

Open a raw hand history file for the first time and it reads like a log, not a story: seat numbers that don't match the felt in front of you, timestamps in the room's server time zone, and card abbreviations instead of card names.

Why do some hands show "T" instead of "10"?

Because most solvers and trackers standardize on single-character rank codes, "T" for ten included, so every card fits one column width. It's efficient for software. It's also genuinely disorienting the first time a human reads it, and the frustration is real enough that a thread on r/poker half-jokingly petitioned to ban anyone who writes "5/T" instead of "5/10" when quoting stakes. The notation isn't going away. Once you know it's "T" for ten and nothing else, the rest of the file stops looking foreign.

The other habitual trap is seat order. Hand history files number seats by table position, not by where you were sitting when you clicked "request history," so seat 1 in the file is rarely the seat labelled 1 on your screen. Match hero's hole cards to hero's seat number before you trust any downstream conclusion, or you'll build a leak report about the wrong player.

What a hand history can tell you that memory never will

A single hand history entry, on its own, tells you almost nothing useful. A few hundred hands, filtered by position and sorted by stat, tell you something you cannot get from memory: how often you actually open, not how often you feel like you open.

How many hands until a stat like VPIP means anything?

More than most people assume. One redditor who bought and parsed 1,000,000 hands of ACR $0.10/$0.05 cash games in Python found an overall raise-first-in rate of 24.2%, with VPIP at 25.5% and PFR at 15.7% across the pool, and a spread by position running from 17.8% RFI in the big blind up to 37.4% on the button, according to the analysis posted to r/poker. That same dataset showed three-bet call frequency swinging from 88% against small three-bets under 2.6x down to 35% against anything over 4.6x. None of that is visible from a single session. It only shows up once you look at your opening ranges by position across enough hands to smooth out variance.

Even the best players in the world need the record, not memory, to catch their own mistakes. At the 2009 WSOP Main Event, Phil Ivey held a made flush on the river against Jordan Smith's two pair, checked it back, and then mucked the winning hand by mistake, handing the pot away in what the broadcast called one of the strangest errors in the tournament's history.

"He can't even win when he wins."

WSOP broadcast commentary, 2009

If a professional with that much table time can misread a hand in real time, the case for reviewing the written record instead of trusting your own recall of a session gets a lot stronger. The hand history is the only version of the session that didn't forget anything. Turning that record into an actual leak count, one you can express in big blinds lost per hundred hands, is a separate step, and it's the one reviewing a session properly is built around.

Why some sites sell hand histories, and why that's a different game

Search for "poker hand history" for more than a minute and you'll run into sites that sell other players' hands by the thousand, promising population tendencies and villain-specific reads before you even sit down.

Is buying another player's hand history against the rules?

It depends on the room's terms of service, and it sits closer to a grey area than most sellers admit. What matters more for this site's purpose: that entire business model is built for pre-session or in-session opponent profiling, feeding a HUD with reads on the players you're about to face. We build Poker Debrief around the opposite use case, reading your own hand history after the session ends, not anyone else's before it starts, and nothing here is designed to run at the table while you play. If a tool promises real-time reads mid-hand, that's a different product with different rules attached to it, and studying your own history after the fact never overlaps with that risk.

That distinction is also why the notation quirks and folder paths covered above matter more than they look. You only need to get comfortable reading the file once. After that, the file works for you every session, not just the one you happened to remember clearly.