Loading…
Free, no-key HTTP API for GTO preflop ranges — no-limit hold'em and PLO (6- and 9-max). Read-only, CORS-open, CDN-cached — call it from a bot, a spreadsheet, or your own tools.
Ranges are keyed by an action path: a chain of POSITION_ACTION pairs describing the preflop line. A path ending in an action (Fold / Call / AI / a raise size like 60%) names a single range; a path ending in a position names a whole decision. Encode % in raise sizes as %25.
/api/ranges/nl/v2Discovery. Lists covered stack depths and positions plus manifest metadata. Call this first to learn valid values for the lookups below.
{
"game": "nl",
"version": 2,
"generatedAt": "2026-06-09T...Z",
"bundleCount": 48,
"stacks": [20, 30, 40, 50, 70, 100, 150, 200],
"positions": ["BB", "BTN", "CO", "HJ", "SB", "UTG"]
}/api/ranges/nl/v2/rangePull the range for one spot. `spot` is a full action path ending in the action whose range you want; the acting position is inferred from the path. Add `hand` to get that class's frequency and EV directly.
stackrequired— Stack depth in bb, e.g. 100spotrequired— Action path ending in an action, e.g. UTG_60%_HJ_Call (encode % as %25)handoptional— 169-grid class, e.g. AKs — returns its freq and ev in the range{
"game": "nl",
"version": 2,
"stack": 100,
"spot": "UTG_60%_HJ_Call",
"actor": "HJ",
"hand": "AKs",
"freq": 1,
"ev": 3.21,
"combos": 84.5,
"weights": { "TT": 1, "AJs": 1, "KQs": 0.5, ... },
"evs": { "TT": 2.1, "AJs": 3.4, "KQs": 0.18, ... }
}/api/ranges/nl/v2/nodeThe whole decision at a node. `history` is an action path ending in the position about to act. Returns every available action with its range. Add `hand` to also get that class's mixed strategy.
stackrequired— Stack depth in bb, e.g. 100historyrequired— Action path ending in a position, e.g. UTG_60%_HJ (encode % as %25)handoptional— 169-grid class — returns its mixed strategy (action → freq){
"game": "nl",
"version": 2,
"stack": 100,
"history": "UTG_60%_HJ",
"actor": "HJ",
"actions": [
{ "action": "Fold", "kind": "fold", "combos": 0, "weights": {} },
{ "action": "Call", "kind": "call", "combos": 84.5,
"weights": { ... }, "evs": { ... } },
{ "action": "77%", "kind": "raise", "sizePct": 77, "combos": 22.1,
"weights": { ... }, "evs": { ... } }
],
"continuingCombos": 106.6,
"hand": "AKs",
"strategy": { "Fold": 0, "Call": 0.4, "77%": 0.6 }
}/api/ranges/nl/v2/spotsEvery valid decision node in the preflop tree for a stack depth, tagged by depth (1 = RFI, 2 = vs single raise, 3 = 3-bet pots, …). Lets clients build a local spot picker without per-spot 404 probing.
stackrequired— Stack depth in bb, e.g. 100{
"game": "nl",
"version": 2,
"stack": 100,
"spots": [
{ "history": "UTG", "depth": 1 },
{ "history": "UTG_60%_HJ", "depth": 2 },
{ "history": "UTG_60%_HJ_3sb_CO", "depth": 3 },
...
]
}combos is the weighted concrete-combo count (pair = 6, suited = 4, offsuit = 12).400 for a malformed path, 404when the spot isn't in the dataset.Same action-path grammar as hold'em — a chain of POSITION_ACTION pairs — but the action vocabulary is Fold / Call and raises labelled by betting depth: Open, 3B, 4B, … A path ending in an action names a single range; a path ending in a position names a whole decision.
/api/ranges/ploDiscovery. Lists covered stack depths and positions for 6-max PLO plus manifest metadata. Call this first to learn valid values for the lookups below.
{
"game": "plo",
"generatedAt": "2026-06-07T...Z",
"bundleCount": 54,
"stacks": [12, 20, 30, 40, 50, 75, 100, 150, 200],
"positions": ["BB", "BTN", "CO", "HJ", "SB", "UTG"]
}/api/ranges/plo/rangePull the range for one spot. `spot` is a full action path ending in the action whose range you want; the acting position is inferred from the path. Add `hand` to get that hand's frequency directly, or `minFreq` to trim low-weight hands.
stackrequired— Stack depth in bb, e.g. 100spotrequired— Action path ending in an action, e.g. UTG_Open_HJ_3Bhandoptional— MonkerSolver hand string, e.g. AAKK or (KA)(KA) — encode ( ) as %28 %29minFreqoptional— Drop hands at or below this weight, e.g. 0.05 (default 0){
"game": "plo",
"stack": 40,
"spot": "UTG_Open_HJ_3B",
"actor": "HJ",
"hands": 612,
"weights": { "(KA)(KA)": 1, "(2A)(3A)": 1, "AAKQ": 0.7, ... }
}/api/ranges/plo/nodeThe whole decision at a node. `history` is an action path ending in the position about to act. Returns every available action with its range. Add `hand` for that hand's mixed strategy, or `minFreq` to trim large ranges.
stackrequired— Stack depth in bb, e.g. 100historyrequired— Action path ending in a position, e.g. UTG_Open_HJhandoptional— MonkerSolver hand string — returns its mixed strategy (action → freq)minFreqoptional— Drop hands at or below this weight from each action's range{
"game": "plo",
"stack": 40,
"history": "UTG_Open_HJ",
"actor": "HJ",
"actions": [
{ "action": "Fold", "kind": "fold", "hands": 14883, "weights": { ... } },
{ "action": "Call", "kind": "call", "hands": 411, "weights": { ... } },
{ "action": "3B", "kind": "raise", "raiseDepth": 2, "hands": 1136, "weights": { ... } }
],
"continuingHands": 1549,
"hand": "(KA)(KA)",
"strategy": { "Fold": 0, "Call": 0, "3B": 1 }
}/api/ranges/plo/spotsEvery valid decision node in the preflop tree for a stack depth, tagged by depth (1 = RFI, 2 = vs single raise, 3 = 3-bet pots, …). Lets clients build a local spot picker without per-spot 404 probing.
stackrequired— Stack depth in bb, e.g. 100{
"game": "plo",
"stack": 40,
"spots": [
{ "history": "UTG", "depth": 1 },
{ "history": "UTG_Open_HJ", "depth": 2 },
{ "history": "UTG_Open_HJ_3B_CO", "depth": 3 },
...
]
}AAKK (no two cards suited), (2A)AA (the 2 suited to an ace), (KA)(KA) (AAKK double-suited). Encode ( and ) as %28 / %29 in the query string.hands(count of hand classes with nonzero weight) rather than NL's weighted combos— exact PLO combo counts aren't derived from the notation.Open = first raise, 3B = second, …). When a node offers more than one raise size the label is disambiguated with the raw size id, e.g. Open-40100. Always read the exact action tokens from /node or /spots.minFreq to keep responses small./api/ranges/plo for the live list.The full-ring sibling of the 6-max PLO API — identical POSITION_ACTION grammar and hand notation, but nine seats. Action order is UTG, UTG1, UTG2, LJ, HJ, CO, BTN, SB, BB. A path ending in an action names a single range; a path ending in a position names a whole decision.
/api/ranges/plo9Discovery. Lists covered stack depths and positions for 9-max PLO plus manifest metadata. Call this first to learn valid values for the lookups below. Identical grammar to 6-max PLO — only the table size and seat order differ.
{
"game": "plo9",
"generatedAt": "2026-06-11T...Z",
"bundleCount": 18,
"stacks": [60, 100],
"positions": ["BB", "BTN", "CO", "HJ", "LJ", "SB", "UTG", "UTG1", "UTG2"]
}/api/ranges/plo9/rangePull the range for one spot. `spot` is a full action path ending in the action whose range you want; the acting position is inferred from the path. Add `hand` to get that hand's frequency directly, or `minFreq` to trim low-weight hands.
stackrequired— Stack depth in bb: 60 or 100spotrequired— Action path ending in an action, e.g. UTG_Open_LJ_3Bhandoptional— MonkerSolver hand string, e.g. AAKK or (KA)(KA) — encode ( ) as %28 %29minFreqoptional— Drop hands at or below this weight, e.g. 0.05 (default 0){
"game": "plo9",
"stack": 100,
"spot": "UTG_Open_LJ_3B",
"actor": "LJ",
"hands": 488,
"weights": { "(KA)(KA)": 1, "(2A)(3A)": 1, "AAKQ": 0.6, ... }
}/api/ranges/plo9/nodeThe whole decision at a node. `history` is an action path ending in the position about to act. Returns every available action with its range. Add `hand` for that hand's mixed strategy, or `minFreq` to trim large ranges.
stackrequired— Stack depth in bb: 60 or 100historyrequired— Action path ending in a position, e.g. UTG_Open_LJhandoptional— MonkerSolver hand string — returns its mixed strategy (action → freq)minFreqoptional— Drop hands at or below this weight from each action's range{
"game": "plo9",
"stack": 100,
"history": "UTG_Open_LJ",
"actor": "LJ",
"actions": [
{ "action": "Fold", "kind": "fold", "hands": 15012, "weights": { ... } },
{ "action": "Call", "kind": "call", "hands": 372, "weights": { ... } },
{ "action": "3B", "kind": "raise", "raiseDepth": 2, "hands": 1048, "weights": { ... } }
],
"continuingHands": 1420,
"hand": "(KA)(KA)",
"strategy": { "Fold": 0, "Call": 0, "3B": 1 }
}/api/ranges/plo9/spotsEvery valid decision node in the preflop tree for a stack depth, tagged by depth (1 = RFI, 2 = vs single raise, 3 = 3-bet pots, …). Lets clients build a local spot picker without per-spot 404 probing.
stackrequired— Stack depth in bb: 60 or 100{
"game": "plo9",
"stack": 100,
"spots": [
{ "history": "UTG", "depth": 1 },
{ "history": "UTG_Open_LJ", "depth": 2 },
{ "history": "UTG_Open_LJ_3B_CO", "depth": 3 },
...
]
}Open, 3B, …) as 6-max PLO — see those notes above. The two datasets are separate, so a 9-max UTG range is distinct from the 6-max one.UTG_Fold_UTG1_Fold_…_BTN_Open). Pass minFreq to keep responses small./api/ranges/plo9 for the live list of covered stack depths.