{
  "service": "PoketPoker hand records",
  "description": "Machine-readable Texas Hold'em starting-hand data derived by this site's own engine: exact enumeration where exact is possible, seeded Monte Carlo otherwise, with provenance on every figure.",
  "license": "CC-BY-4.0",
  "payment": {
    "protocol": "x402",
    "version": 2,
    "asset": "USDC",
    "price": "$0.01"
  },
  "free": [
    "https://poketpoker.com/hands/index.md",
    "https://poketpoker.com/hands/{id}.md",
    "https://poketpoker.com/llms.txt",
    "https://poketpoker.com/api/hands/schema"
  ],
  "endpoints": [
    {
      "path": "/api/hands/{id}",
      "method": "GET",
      "description": "The full record for one of the 1,326 specific Texas Hold'em starting hands: equity against modelled ranges, position-by-position opening guidance, exact head-to-head figures, and the exact card-removal effect of holding these specific two cards.",
      "input": {
        "id": "canonical hand id, e.g. AhKh — higher rank first, suits ordered c,d,h,s"
      },
      "price": "$0.01"
    },
    {
      "path": "/api/compare",
      "method": "GET",
      "description": "Exact head-to-head equity between any two specific Texas Hold'em hands, enumerated over all 1,712,304 remaining boards. No sampling and no approximation.",
      "input": {
        "a": "canonical hand id",
        "b": "canonical hand id"
      },
      "price": "$0.01"
    },
    {
      "path": "/api/advice",
      "method": "GET",
      "description": "Whether to open a specific Texas Hold'em starting hand from a named position against a given number of opponents, with the engine equity behind the answer.",
      "input": {
        "hand": "canonical hand id",
        "position": "early|middle|hijack|cutoff|button|small-blind",
        "opponents": "1-7"
      },
      "price": "$0.01"
    }
  ],
  "related": [
    {
      "service": "PoketPoker agent poker",
      "schema": "https://poketpoker.com/api/play/schema",
      "description": "Play Texas Hold'em against this site's bots, one hand at a time, and be measured on it. Priced per hand dealt; the decisions within a hand are free."
    }
  ],
  "engine": {
    "name": "poker-engine",
    "version": "1.13.0"
  },
  "url": "https://poketpoker.com",
  "documentation": "https://poketpoker.com/api.md",
  "pricing": "https://poketpoker.com/pricing.md",
  "plan": {
    "plan": "Pay-per-call — a single plan, no tiers and no subscription",
    "price": "$0.01",
    "currency": "USD, settled in USDC on Base",
    "billing_period": "None — charged per successful call",
    "billing period": "None — charged per successful call",
    "vat": "None. The amount shown is the amount transferred; nothing is added",
    "features": "Range equity, position-by-position guidance, exact head-to-head, blockers",
    "contact": "sales@poketpoker.com"
  },
  "products": [
    {
      "id": "/api/hands/{id}",
      "name": "/api/hands/{id}",
      "description": "The full record for one of the 1,326 specific Texas Hold'em starting hands: equity against modelled ranges, position-by-position opening guidance, exact head-to-head figures, and the exact card-removal effect of holding these specific two cards.",
      "price": "$0.01",
      "currency": "USD",
      "billingPeriod": "per call",
      "vat": "none",
      "url": "https://poketpoker.com/api/hands/{id}"
    },
    {
      "id": "/api/compare",
      "name": "/api/compare",
      "description": "Exact head-to-head equity between any two specific Texas Hold'em hands, enumerated over all 1,712,304 remaining boards. No sampling and no approximation.",
      "price": "$0.01",
      "currency": "USD",
      "billingPeriod": "per call",
      "vat": "none",
      "url": "https://poketpoker.com/api/compare"
    },
    {
      "id": "/api/advice",
      "name": "/api/advice",
      "description": "Whether to open a specific Texas Hold'em starting hand from a named position against a given number of opponents, with the engine equity behind the answer.",
      "price": "$0.01",
      "currency": "USD",
      "billingPeriod": "per call",
      "vat": "none",
      "url": "https://poketpoker.com/api/advice"
    },
    {
      "id": "/api/play/deal",
      "name": "/api/play/deal",
      "description": "Deal one hand of Texas Hold'em against PoketPoker's bots and find out how your play compares. Five difficulty tiers; the top tier plays range-aware expected-value poker and beats every tier below it. Returns the table and a ticket; playing the hand out costs nothing more. Markdown by default, JSON with format=json.",
      "price": "$0.005",
      "currency": "USD",
      "billingPeriod": "per hand",
      "vat": "none",
      "url": "https://poketpoker.com/api/play/deal"
    },
    {
      "id": "/api/play/act",
      "name": "/api/play/act",
      "description": "Take a decision in a hand already paid for. Send the ticket from the deal and every action taken this hand, in order; the server replays and returns the new position. Free — the deal covers the whole hand. Markdown by default, JSON with format=json.",
      "price": "free with a ticket",
      "currency": "USD",
      "billingPeriod": "per hand",
      "vat": "none",
      "url": "https://poketpoker.com/api/play/act"
    }
  ]
}