Calculations

Metered poker calculation endpoints backed by PokerWorks Lab engines.

Calculate Hold'em equity

POST

https://api.pokerworks.io

/v1/calculations/equity/holdem

Calculate Texas Holdem equity for exact hands or ranges

Calculate Hold'em equity › Headers

x-request-id

string · maxLength: 128

Optional idempotency key scoped to the developer API account and environment. Maximum 128 characters. Reusing a completed request id returns 409 Conflict and is never double-billed. x-correlation-id is ignored for idempotency.

Calculate Hold'em equity › Request Body

CalculateHoldemEquityRequest

array · minItems: 2 · maxItems: 9 · required

board

string[] · maxItems: 5

dead

string[] · maxItems: 44

exactSampleThreshold

integer · min: 0 · max: 1000000

iterations

integer · max: 1000000

seed

integer

variant

string · enum

Enum values:

nlhe

Calculate Hold'em equity › Responses

CalculateHoldemEquityResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/odds-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required

POST/v1/calculations/equity/holdem

curl https://api.pokerworks.io/v1/calculations/equity/holdem \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "iterations": 100000,
  "players": [
    {
      "id": "cutoff",
      "label": "Cutoff range",
      "mode": "range",
      "range": {
        "classes": [
          "JJ",
          "QQ",
          "AKs"
        ]
      }
    },
    {
      "id": "button",
      "label": "Button range",
      "mode": "range",
      "range": {
        "classes": [
          "QQ",
          "AKs"
        ]
      }
    }
  ],
  "seed": 1
}'

Example Request Body

{
  "iterations": 100000,
  "players": [
    {
      "id": "cutoff",
      "label": "Cutoff range",
      "mode": "range",
      "range": {
        "classes": [
          "JJ",
          "QQ",
          "AKs"
        ]
      }
    },
    {
      "id": "button",
      "label": "Button range",
      "mode": "range",
      "range": {
        "classes": [
          "QQ",
          "AKs"
        ]
      }
    }
  ],
  "seed": 1
}

json

application/json

Example Responses

{
  "creditsCharged": 0,
  "engine": "poker-lab-tools/odds-calculator",
  "method": {
    "marginOfErrorPct": 0,
    "sampleCount": 0,
    "type": "exact"
  },
  "requestId": "requestId",
  "result": {
    "board_cards": [
      "string"
    ],
    "chopPct": 0,
    "dead_cards": [
      "string"
    ],
    "players": [
      {
        "effectiveComboCount": 0,
        "equityPct": 0,
        "id": "id",
        "label": "label",
        "marginOfErrorPct": 0,
        "potShare": 0,
        "rawComboCount": 0,
        "tiePct": 0,
        "ties": 0,
        "winPct": 0,
        "wins": 0
      }
    ],
    "sampleCount": 0,
    "street": "preflop"
  },
  "warnings": [
    "string"
  ]
}

json

application/json

Calculate an ICM deal

POST

https://api.pokerworks.io

/v1/calculations/icm/deal

Calculate an ICM final-table deal comparison

Calculate an ICM deal › Headers

x-request-id

string · maxLength: 128

Calculate an ICM deal › Request Body

CalculateIcmDealRequest

object[] · minItems: 1 · maxItems: 10 · required

object[] · minItems: 2 · maxItems: 10 · required

blendPct

number · min: 0 · max: 100

unit

string · enum

Enum values:

chips

points

units

USD

EUR

GBP

AUD

CAD

Default: units

Calculate an ICM deal › Responses

CalculateIcmDealResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/icm-deal-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required

POST/v1/calculations/icm/deal

curl https://api.pokerworks.io/v1/calculations/icm/deal \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "blendPct": 25,
  "payouts": [
    {
      "amount": 5000,
      "place": 1
    },
    {
      "amount": 3000,
      "place": 2
    },
    {
      "amount": 2000,
      "place": 3
    }
  ],
  "players": [
    {
      "id": "seat-1",
      "name": "Seat 1",
      "stack": 1250000
    },
    {
      "id": "seat-2",
      "name": "Seat 2",
      "stack": 820000
    },
    {
      "id": "seat-3",
      "name": "Seat 3",
      "stack": 430000
    }
  ],
  "unit": "USD"
}'

Example Request Body

{
  "blendPct": 25,
  "payouts": [
    {
      "amount": 5000,
      "place": 1
    },
    {
      "amount": 3000,
      "place": 2
    },
    {
      "amount": 2000,
      "place": 3
    }
  ],
  "players": [
    {
      "id": "seat-1",
      "name": "Seat 1",
      "stack": 1250000
    },
    {
      "id": "seat-2",
      "name": "Seat 2",
      "stack": 820000
    },
    {
      "id": "seat-3",
      "name": "Seat 3",
      "stack": 430000
    }
  ],
  "unit": "USD"
}

json

application/json

Example Responses

{
  "creditsCharged": 0,
  "engine": "poker-lab-tools/icm-deal-calculator",
  "method": {
    "type": "deterministic"
  },
  "requestId": "requestId",
  "result": {
    "advice": [
      {
        "body": "body",
        "code": "code",
        "title": "title",
        "tone": "attention"
      }
    ],
    "finishProbabilities": [
      {
        "playerId": "playerId",
        "probabilities": [
          {
            "place": 1,
            "probabilityPct": 0
          }
        ]
      }
    ],
    "input": {
      "key": {}
    },
    "meta": {
      "authorityNote": "authorityNote",
      "contractVersion": 1,
      "engine": "poker-lab-tools/icm-deal-calculator",
      "generatedAt": "2024-08-25T15:00:00Z",
      "sourceKind": "lab-planning"
    },
    "payouts": [
      {
        "amount": 0,
        "place": 1,
        "source": "entered"
      }
    ],
    "players": [
      {
        "blendedAmount": 0,
        "chipChopAmount": 0,
        "chipSharePct": 0,
        "deltaVsChipChop": 0,
        "deltaVsChipSharePct": 0,
        "deltaVsFloorFirstChipChop": 0,
        "equalChopAmount": 0,
        "floorFirstChipChopAmount": 0,
        "icmAmount": 0,
        "icmSharePct": 0,
        "id": "id",
        "name": "name",
        "stack": 0
      }
    ],
    "summary": {
      "blendPct": 0,
      "largestFairnessGapAmount": 0,
      "largestFairnessGapPlayerId": "largestFairnessGapPlayerId",
      "method": "malmuth-harville-exact",
      "playerCount": 1,
      "totalChips": 0,
      "totalPrizePool": 0
    }
  },
  "warnings": [
    "string"
  ]
}

json

application/json

Calculate tournament payouts

POST

https://api.pokerworks.io

/v1/calculations/tournaments/payouts

Calculate a tournament payout structure

Calculate tournament payouts › Headers

x-request-id

string · maxLength: 128

Calculate tournament payouts › Request Body

CalculateTournamentPayoutsRequest

entrants

integer · min: 2 · max: 10000 · required

required

object · required

style

string · enum · required

Enum values:

friendly

standard

competitive

winner-take-all

satellite

unit

string · enum · required

Enum values:

chips

points

units

USD

EUR

GBP

AUD

CAD

object

object[] · maxItems: 1000

object

Calculate tournament payouts › Responses

CalculateTournamentPayoutsResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/tournament-payout-studio

object · required

requestId

string · required

object · required

warnings

string[] · required

POST/v1/calculations/tournaments/payouts

curl https://api.pokerworks.io/v1/calculations/tournaments/payouts \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "entrants": 72,
  "paidPlaces": "auto",
  "prizePool": {
    "entryValue": 50,
    "fee": 5
  },
  "rounding": {
    "mode": "nearest-5",
    "residualPolicy": "first-place"
  },
  "style": "standard",
  "unit": "USD"
}'

Example Request Body

{
  "entrants": 72,
  "paidPlaces": "auto",
  "prizePool": {
    "entryValue": 50,
    "fee": 5
  },
  "rounding": {
    "mode": "nearest-5",
    "residualPolicy": "first-place"
  },
  "style": "standard",
  "unit": "USD"
}

json

application/json

Example Responses

{
  "creditsCharged": 0,
  "engine": "poker-lab-tools/tournament-payout-studio",
  "method": {
    "type": "deterministic"
  },
  "requestId": "requestId",
  "result": {
    "advice": [
      {
        "body": "body",
        "code": "code",
        "title": "title",
        "tone": "attention"
      }
    ],
    "characterRead": "characterRead",
    "entries": [
      {
        "amount": 0,
        "entryMultiple": 0,
        "note": "cash-remainder",
        "payoutPercent": 0,
        "position": 1
      }
    ],
    "input": {
      "key": {}
    },
    "meta": {
      "authorityNote": "authorityNote",
      "contractVersion": 1,
      "engine": "poker-lab-tools/tournament-payout-studio",
      "generatedAt": "2024-08-25T15:00:00Z",
      "note": "note",
      "sourceKind": "lab-planning",
      "version": 1
    },
    "publishability": "publishability",
    "schedule": {
      "key": {}
    },
    "summary": {
      "derivedPrizePool": 0,
      "effectivePrizePool": 0,
      "feesCollected": 0,
      "fieldCashShare": 0,
      "firstPlaceShare": 0,
      "guaranteeApplied": true,
      "guaranteeOverlay": 0,
      "manualBalanced": true,
      "minCashAmount": 0,
      "minCashMultiple": 0,
      "paidPlaces": 1,
      "resolvedRoundingMode": "exact",
      "roundingDelta": 0,
      "roundingResidualApplied": 0,
      "topToMinRatio": 0,
      "totalCollected": 0,
      "totalDistributed": 0,
      "totalEntryCost": 0,
      "totalPercent": 0,
      "usesOverride": true
    }
  },
  "warnings": [
    "string"
  ]
}

json

application/json

Calculate a blind structure

POST

https://api.pokerworks.io

/v1/calculations/tournaments/blinds

Calculate a tournament blind structure

Calculate a blind structure › Headers

x-request-id

string · maxLength: 128

Calculate a blind structure › Request Body

CalculateBlindStructureRequest

anteStyle

string · enum · required

Enum values:

none

big-blind

classic

levelDurationMinutes

integer · min: 5 · max: 60 · required

pace

string · enum · required

Enum values:

gentle

standard

fast

players

integer · min: 2 · max: 200 · required

object · required

startingStack

integer · min: 500 · max: 10000000 · required

targetDurationMinutes

integer · min: 30 · max: 1440 · required

Calculate a blind structure › Responses

CalculateBlindStructureResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/blind-structure-builder

object · required

requestId

string · required

object · required

warnings

string[] · required

POST/v1/calculations/tournaments/blinds

curl https://api.pokerworks.io/v1/calculations/tournaments/blinds \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "anteStyle": "big-blind",
  "levelDurationMinutes": 20,
  "pace": "standard",
  "players": 36,
  "rebuys": {
    "enabled": true,
    "endsAfterLevel": 6,
    "expectedRebuysPerPlayer": 0.4
  },
  "startingStack": 20000,
  "targetDurationMinutes": 300
}'

Example Request Body

{
  "anteStyle": "big-blind",
  "levelDurationMinutes": 20,
  "pace": "standard",
  "players": 36,
  "rebuys": {
    "enabled": true,
    "endsAfterLevel": 6,
    "expectedRebuysPerPlayer": 0.4
  },
  "startingStack": 20000,
  "targetDurationMinutes": 300
}

json

application/json

Example Responses

{
  "creditsCharged": 0,
  "engine": "poker-lab-tools/blind-structure-builder",
  "method": {
    "type": "deterministic"
  },
  "requestId": "requestId",
  "result": {
    "advice": [
      {
        "body": "body",
        "code": "code",
        "title": "title",
        "tone": "attention"
      }
    ],
    "input": {
      "key": {}
    },
    "levels": [
      {
        "ante": 0,
        "bigBlind": 1,
        "breakAfter": {
          "durationMinutes": 1,
          "label": "label"
        },
        "durationMinutes": 1,
        "levelNumber": 1,
        "notes": [
          "ante-starts"
        ],
        "smallBlind": 1
      }
    ],
    "meta": {
      "engine": "poker-lab-tools/blind-structure-builder",
      "generatedAt": "2024-08-25T15:00:00Z",
      "note": "note",
      "version": 1
    },
    "summary": {
      "averageFinalStackBigBlinds": 0,
      "estimatedFinishMinutes": 0,
      "finalPressure": "High",
      "startingBigBlinds": 0,
      "totalBreakMinutes": 0,
      "totalChips": 0,
      "totalPlayingMinutes": 0
    }
  },
  "warnings": [
    "string"
  ]
}

json

application/json

Plan starting chip stacks

POST

https://api.pokerworks.io

/v1/calculations/chips/starting-stack

Calculate a physical chip starting-stack plan

Plan starting chip stacks › Headers

x-request-id

string · maxLength: 128

Plan starting chip stacks › Request Body

CalculateChipStartingStackRequest

object[] · minItems: 1 · maxItems: 10 · required

firstBigBlind

integer · required

firstSmallBlind

integer · required

players

integer · min: 2 · max: 200 · required

startingStack

integer · required

targetStyle

string · enum · required

Enum values:

efficient

comfortable

deep-stack

object

allowReserveDenominationSubstitution

boolean

object

desiredStartingBigBlinds

integer

object

startingStackMode

string · enum

Enum values:

manual

big-blinds

Plan starting chip stacks › Responses

CalculateChipStartingStackResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/chip-starting-stack-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required

POST/v1/calculations/chips/starting-stack

curl https://api.pokerworks.io/v1/calculations/chips/starting-stack \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "denominations": [
    {
      "color": "green",
      "label": "25",
      "value": 25
    },
    {
      "color": "black",
      "label": "100",
      "value": 100
    },
    {
      "color": "purple",
      "label": "500",
      "value": 500
    },
    {
      "color": "yellow",
      "label": "1k",
      "value": 1000
    },
    {
      "color": "brown",
      "label": "5k",
      "value": 5000
    }
  ],
  "firstBigBlind": 100,
  "firstSmallBlind": 50,
  "players": 9,
  "rebuyReserve": {
    "count": {
      "mode": "count",
      "value": 4
    },
    "stack": 20000
  },
  "startingStack": 20000,
  "targetStyle": "comfortable"
}'

Example Request Body

{
  "denominations": [
    {
      "color": "green",
      "label": "25",
      "value": 25
    },
    {
      "color": "black",
      "label": "100",
      "value": 100
    },
    {
      "color": "purple",
      "label": "500",
      "value": 500
    },
    {
      "color": "yellow",
      "label": "1k",
      "value": 1000
    },
    {
      "color": "brown",
      "label": "5k",
      "value": 5000
    }
  ],
  "firstBigBlind": 100,
  "firstSmallBlind": 50,
  "players": 9,
  "rebuyReserve": {
    "count": {
      "mode": "count",
      "value": 4
    },
    "stack": 20000
  },
  "startingStack": 20000,
  "targetStyle": "comfortable"
}

json

application/json

Example Responses

{
  "creditsCharged": 0,
  "engine": "poker-lab-tools/chip-starting-stack-calculator",
  "method": {
    "type": "deterministic"
  },
  "requestId": "requestId",
  "result": {
    "advice": [
      {
        "body": "body",
        "code": "code",
        "title": "title",
        "tone": "attention"
      }
    ],
    "grandTotalChips": [
      {
        "color": "color",
        "count": 0,
        "denominationValue": 1,
        "label": "label",
        "totalValue": 0
      }
    ],
    "input": {
      "key": {}
    },
    "inventory": {
      "constrained": true,
      "entries": [
        {
          "availableCount": 0,
          "color": "color",
          "denominationValue": 1,
          "label": "label",
          "requiredCount": 0,
          "reserveRequiredCount": 0,
          "startingRequiredCount": 0,
          "surplusOrShortage": 0
        }
      ],
      "feasible": true,
      "reserveFeasible": true,
      "reserveShortages": [
        {
          "availableCount": 0,
          "color": "color",
          "denominationValue": 1,
          "label": "label",
          "requiredCount": 0,
          "reserveRequiredCount": 0,
          "startingRequiredCount": 0,
          "surplusOrShortage": 0
        }
      ],
      "startingFeasible": true,
      "startingShortages": [
        {
          "availableCount": 0,
          "color": "color",
          "denominationValue": 1,
          "label": "label",
          "requiredCount": 0,
          "reserveRequiredCount": 0,
          "startingRequiredCount": 0,
          "surplusOrShortage": 0
        }
      ],
      "totalShortages": [
        {
          "availableCount": 0,
          "color": "color",
          "denominationValue": 1,
          "label": "label",
          "requiredCount": 0,
          "reserveRequiredCount": 0,
          "startingRequiredCount": 0,
          "surplusOrShortage": 0
        }
      ]
    },
    "meta": {
      "authorityNote": "authorityNote",
      "contractVersion": 1,
      "engine": "poker-lab-tools/chip-starting-stack-calculator",
      "generatedAt": "2024-08-25T15:00:00Z",
      "sourceKind": "lab-planning"
    },
    "perPlayerStack": {
      "chipCount": 0,
      "entries": [
        {
          "color": "color",
          "count": 0,
          "denominationValue": 1,
          "label": "label",
          "totalValue": 0
        }
      ],
      "score": 0,
      "totalValue": 0
    },
    "reserve": {
      "addon": {
        "key": {}
      },
      "addonChips": [
        {
          "color": "color",
          "count": 0,
          "denominationValue": 1,
          "label": "label",
          "totalValue": 0
        }
      ],
      "rebuy": {
        "key": {}
      },
      "rebuyChips": [
        {
          "color": "color",
          "count": 0,
          "denominationValue": 1,
          "label": "label",
          "totalValue": 0
        }
      ],
      "substitutionUsed": true,
      "totalReserveChips": [
        {
          "color": "color",
          "count": 0,
          "denominationValue": 1,
          "label": "label",
          "totalValue": 0
        }
      ],
      "totalReserveValue": 0
    },
    "startingTotalChips": [
      {
        "color": "color",
        "count": 0,
        "denominationValue": 1,
        "label": "label",
        "totalValue": 0
      }
    ],
    "summary": {
      "chipsPerPlayer": 0,
      "effectiveStartingStack": 1,
      "grandTotalChips": 0,
      "grandTotalValue": 0,
      "playerCount": 1,
      "requestedStartingStack": 1,
      "startingBigBlinds": 0,
      "totalReserveChips": 0,
      "totalStartingChips": 0,
      "totalStartingValue": 0
    }
  },
  "warnings": [
    "string"
  ]
}

json

application/json

Usage

Calculate Hold'em equity

POST

https://api.pokerworks.io

/v1/calculations/equity/holdem

Calculate Texas Holdem equity for exact hands or ranges

Calculate Hold'em equity › Headers

x-request-id

string · maxLength: 128

Calculate Hold'em equity › Request Body

CalculateHoldemEquityRequest

array · minItems: 2 · maxItems: 9 · required

board

string[] · maxItems: 5

dead

string[] · maxItems: 44

exactSampleThreshold

integer · min: 0 · max: 1000000

iterations

integer · max: 1000000

seed

integer

variant

string · enum

Enum values:

nlhe

Calculate Hold'em equity › Responses

CalculateHoldemEquityResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/odds-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required

Calculate an ICM deal

POST

https://api.pokerworks.io

/v1/calculations/icm/deal

Calculate an ICM final-table deal comparison

Calculate an ICM deal › Headers

x-request-id

string · maxLength: 128

Calculate an ICM deal › Request Body

CalculateIcmDealRequest

object[] · minItems: 1 · maxItems: 10 · required

object[] · minItems: 2 · maxItems: 10 · required

blendPct

number · min: 0 · max: 100

unit

string · enum

Enum values:

chips

points

units

USD

EUR

GBP

AUD

CAD

Default: units

Calculate an ICM deal › Responses

CalculateIcmDealResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/icm-deal-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required

Calculate tournament payouts

POST

https://api.pokerworks.io

/v1/calculations/tournaments/payouts

Calculate a tournament payout structure

Calculate tournament payouts › Headers

x-request-id

string · maxLength: 128

Calculate tournament payouts › Request Body

CalculateTournamentPayoutsRequest

entrants

integer · min: 2 · max: 10000 · required

required

object · required

style

string · enum · required

Enum values:

friendly

standard

competitive

winner-take-all

satellite

unit

string · enum · required

Enum values:

chips

points

units

USD

EUR

GBP

AUD

CAD

object

object[] · maxItems: 1000

object

Calculate tournament payouts › Responses

CalculateTournamentPayoutsResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/tournament-payout-studio

object · required

requestId

string · required

object · required

warnings

string[] · required

Plan starting chip stacks

POST

https://api.pokerworks.io

/v1/calculations/chips/starting-stack

Calculate a physical chip starting-stack plan

Plan starting chip stacks › Headers

x-request-id

string · maxLength: 128

Plan starting chip stacks › Request Body

CalculateChipStartingStackRequest

object[] · minItems: 1 · maxItems: 10 · required

firstBigBlind

integer · required

firstSmallBlind

integer · required

players

integer · min: 2 · max: 200 · required

startingStack

integer · required

targetStyle

string · enum · required

Enum values:

efficient

comfortable

deep-stack

object

allowReserveDenominationSubstitution

boolean

object

desiredStartingBigBlinds

integer

object

startingStackMode

string · enum

Enum values:

manual

big-blinds

Plan starting chip stacks › Responses

CalculateChipStartingStackResponse

creditsCharged

integer · min: 0 · required

engine

string · enum · required

Enum values:

poker-lab-tools/chip-starting-stack-calculator

object · required

requestId

string · required

object · required

warnings

string[] · required