HoldemCalc

Developer Documentation

Create shareable links for any poker scenario. HoldemCalc provides a free, stateless URL system to instantly load equity for Hold'em, PLO4/5/6/8, Big O, Double Board PLO, Short Deck, and ICM via simple parameters.

Stateless Architecture
Sharable URLs
AI & Bot Friendly

Supported Features

Game Types

  • • Texas Hold'em
  • • Omaha (PLO4, PLO5, PLO6)
  • • PLO8 (Hi-Lo), Big O
  • • Double Board PLO
  • • Short Deck (6+)

Tools & Languages

  • ICM Calculator (Independent Chip Model)
  • Internationalization: Support for 45 languages (English, Korean, Japanese, Chinese, German, French, Russian, etc.)

Game Endpoints / Routes

Game TypeURL PathDescription
Texas Hold'em/Default root path. No suffix needed.
Omaha (PLO4)/omaha4-Card Pot Limit Omaha.
PLO5/plo55-Card Pot Limit Omaha.
PLO6/plo66-Card Pot Limit Omaha.
PLO8 (Hi-Lo)/plo84-Card Omaha Hi-Lo Split (8 or Better).
Big O/big-o5-Card Omaha Hi-Lo Split.
Double Board PLO/double-board-ploTwo separate boards, split pot.
Short Deck/short-deck6+ Hold'em (2-5 removed).
ICM Calculator/icmIndependent Chip Model calculator.

* All paths should be prefixed with the language code (e.g. /en/omaha, /ko/plo5).

Supported Languages (Locales)

HoldemCalc supports 45 languages. Use these codes as the first path segment (e.g. /ko/..., /fr/...).
Auto-Detection: You can omit the language code (e.g. https://holdemcalc.com?h1=AsKs). The system will automatically redirect to the user's preferred language while preserving your data.

East Asia

ko, ja, zh-cn, zh-tw

Western Europe & English

en, es, pt, de, fr, it, nl, sv, no, da, fi

Eastern Europe

ru, uk, pl, cs, hu, ro, hr, bg, sk, sr, lt, lv, et, sq

Southeast Asia & India

th, vi, id, ms, tl, hi, km, my, mn, kk

Middle East & Others

el, tr, ar, he, fa, ka

URL Parameters Specification

ParameterRequiredDescription & Format
h1YesPlayer 1's hand cards (Hero).
Format: RankSuit (e.g. AhKh, Ts9s).
Aliases supported: hero, hand1, p1, player1
h2...h9OptionalOpponents' hand cards.
Auto-Random: If h1 is provided but h2 is missing, it automatically calculates a 1v1 match vs Random Hand.
Aliases supported: opp, villain, opponent, hand2...
bOptionalCommunity cards (Flop, Turn, River).
Format: RankSuit concatenated (e.g. AhKsQs).
Used for single-board games. Alias: board
b1, b2OptionalDouble Board PLO Only.
b1: Top Board, b2: Bottom Board.
Format: Same as b.
w1OptionalPlayer 1's Win Rate (%).
Primarily used for Open Graph (OG) previews. Omit to force a fresh calculation.

ICM Calculator Params

qRequiredQuery string strictly for ICM. Format: PRIZES|STACKS
Use | to separate prizes and stacks. Use , to separate numbers.
Note: Prizes support decimals, but Stacks must be integers.
Example: q=500,300.5,200|10000,9000,8000,7000

Accuracy & Methodology

Equity (Monte Carlo)

Uses fast Monte Carlo simulations with adaptive iteration depths based on complexity.

  • Preflop: High precision (~200,000 iterations), Error approx ±0.5%
  • Postflop: Balanced speed (~5k-50k iterations), Error approx ±0.5%
  • River: 100% Exact (Deterministic evaluation)

ICM (Malmuth-Harville)

Uses the Malmuth-Harville method to calculate exact equity based on stack sizes and payout structures. No simulation involved; results are mathematically exact.

Live Link Examples

Click any link below to see the calculator in action.

How to use with AI (ChatGPT)

You can ask ChatGPT or Claude to generate analysis links for you.

"Refer to holdemcalc.com/docs and create a URL to calculate equity for AsKs vs QhQd on a QsTs9d board."

Disclaimer: This tool is for informational and educational purposes only. While we strive for accuracy, Monte Carlo simulations have inherent variance. HoldemCalc does not guarantee winning and is not responsible for any financial losses. Please play responsibly.