{"uid":"cap_t8ZiGtJO8ganypBYWudOb","slug":"poketpoker-deal-hand-4c387177","name":"PoketPoker Deal Hand","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.","url":"https://poketpoker.com/api/play/deal","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"seed":{"type":"integer"},"seats":{"type":"integer","maximum":8,"minimum":2},"format":{"type":"string"},"difficulty":{"type":"integer","maximum":4,"minimum":0}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jf4U0YSrQk0kytAz9eEuo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Deals one hand of Texas Hold'em for the user to play against a bot at one of five difficulty tiers, returning the table state and a ticket to continue play.","exampleAgentPrompt":"Deal me a hand of Texas Hold'em on PoketPoker against a tough opponent — set the difficulty to 4 and put me at a 6-seat table.","exampleUseCases":[{"title":"Beginner poker practice session","prompt":"Deal me a Texas Hold'em hand on PoketPoker at the easiest difficulty, 2 seats, so I can practice heads-up play without getting destroyed."},{"title":"Expert-bot challenge for advanced players","prompt":"Set up a 6-seat Hold'em hand on PoketPoker at difficulty 4 — I want to see how I stack up against the range-aware bot."},{"title":"Reproducible hand for analysis or study","prompt":"Deal a Texas Hold'em hand on PoketPoker using seed 42, difficulty 2, and 4 seats so I can replay the exact same scenario and study my decisions."}],"resultDescription":"Returns the dealt table state including hole cards, community cards, and opponent info, plus a ticket to continue playing out the hand. Default format is Markdown; pass format=json for machine-readable JSON. The ticket allows the hand to be played through at no additional cost.","failureModes":["Invalid difficulty value (outside 0-4) returns an error","Invalid seats value (outside 2-8) returns an error","Network timeout if the service is under load","Malformed query parameters may return a 400-level error","Payment failure via x402 protocol prevents hand from being dealt"],"whenToPreferThis":"Choose this endpoint when you want to interactively simulate or play out a full Texas Hold'em hand against AI opponents with configurable difficulty, rather than just looking up static hand equities or open-raise charts. It is the right choice when the goal is gameplay simulation or practice, not pure hand analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:02.277Z","isFirstParty":false}