Input schema (JSON)
{
"type": "object",
"required": [
"sort",
"limit"
],
"properties": {
"sort": {
"enum": [
"recent",
"biggest_win",
"biggest_loss"
],
"type": "string",
"default": "biggest_loss",
"description": "Row order: newest first, largest win first, or largest loss first (the default)."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Hands to return, 1 to 50."
},
"filter": {
"anyOf": [
{
"type": "object",
"properties": {
"pfr": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero raised preflop."
},
"rfi": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero raised first in."
},
"vpip": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero put money in voluntarily."
},
"isPfr": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero was the preflop raiser."
},
"limped": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero open-limped."
},
"rfiOpp": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero had a raise-first-in opportunity (folded to hero)."
},
"wasSrp": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hand was a single-raised pot."
},
"sawFlop": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero saw a flop."
},
"position": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"UTG",
"UTG1",
"UTG2",
"MP",
"LJ",
"HJ",
"CO",
"BTN",
"SB",
"BB"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Keep hands where hero sat in one of these seats."
},
"threeBet": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero 3-bet."
},
"facedLimp": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero acted after an opponent's open limp."
},
"isIpVsPfr": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero was in position against the preflop raiser."
},
"sawShowdown": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hand reached showdown."
},
"facedThreeBet": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero's open was 3-bet."
},
"flopBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of hero's flop bet, as % of pot."
},
"turnBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of hero's turn bet, as % of pot."
},
"wonAtShowdown": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero won at showdown."
},
"riverBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of hero's river bet, as % of pot."
},
"wasThreeBetPot": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hand was a 3-bet pot."
},
"flopFirstAction": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action on the flop."
},
"turnFirstAction": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action on the turn."
},
"foldedToThreeBet": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "Hero folded to a 3-bet."
},
"riverFirstAction": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action on the river."
},
"vsThreeBetAction": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"fold",
"call",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Opener's action vs a 3-bet: fold, call, or raise (4-bet)."
},
"flopFacedBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of the flop bet hero faced, as % of pot."
},
"turnFacedBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of the turn bet hero faced, as % of pot."
},
"riverFacedBetPctPot": {
"anyOf": [
{
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Exclusive upper bound, % of pot."
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
],
"description": "Inclusive lower bound, % of pot."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Size of the river bet hero faced, as % of pot."
},
"flopFirstResponseToBet": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action facing a flop bet."
},
"turnFirstResponseToBet": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action facing a turn bet."
},
"riverFirstResponseToBet": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"check",
"bet",
"call",
"fold",
"raise"
],
"type": "string"
}
},
{
"type": "null"
}
],
"description": "Hero's first action facing a river bet."
}
},
"description": "Hand-level filters. Every field is optional; null means the filter is not applied.",
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Hand-level filters, all optional."
},
"game_type": {
"anyOf": [
{
"enum": [
"NLHE",
"PLO",
"PLO5",
"PLO6"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Only hands of this game type. Matches hole-card count."
},
"session_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
],
"description": "Only hands from this upload session (see list_my_sessions)."
},
"table_size": {
"anyOf": [
{
"type": "integer",
"maximum": 9,
"minimum": 2
},
{
"type": "null"
}
],
"description": "Only hands dealt at tables of this many seats."
},
"gto_vs_3bet_bucket": {
"anyOf": [
{
"enum": [
"solver_default",
"mixer",
"freq0",
"no_reach",
"unmapped"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Solver grade bucket for hero's action vs a 3-bet. Grades are not computed, so any value matches nothing rather than inventing a frequency."
},
"gto_plo5_rfi_bucket": {
"anyOf": [
{
"enum": [
"solver_default",
"mixer",
"freq0",
"no_reach",
"unmapped"
],
"type": "string"
},
{
"type": "null"
}
],
"description": "Solver grade bucket for PLO5 raise-first-in. Grades are not computed, so any value matches nothing."
}
},
"additionalProperties": false
}