{"openapi":"3.1.0","info":{"title":"Poker API","version":"1.0.0","description":"A complete Texas Hold’em toolkit in one fast, fully-local API. Calculate win, tie and equity probabilities for your hole cards against any number of opponents (1–9) on any board — pre-flop, flop, turn or river — using a Monte Carlo simulation with adjustable accuracy. Evaluate the best five-card hand from any five to seven cards and get its rank and tiebreakers, or describe a hand in plain language. Cards use the familiar notation (As, Td, 9h, 2c) and every endpoint works by GET or JSON POST. Pure server-side compute with no third-party upstream, so responses are instant and the service is always available. Ideal for poker trainers and study tools, game developers, hand-history trackers and odds widgets.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/poker-api","description":"oanor gateway"}],"tags":[{"name":"Poker"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/describe":{"get":{"operationId":"get_v1_describe","tags":["Poker"],"summary":"Describe a hand","description":"","parameters":[{"name":"cards","in":"query","required":true,"description":"5 to 7 cards","schema":{"type":"string"},"example":"KhKdKs2h2d"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hand":"Full House","rank":7,"cards":["Kh","Kd","Ks","2h","2d"],"description":"Full House (K high)","tiebreakers":["K","2"]},"meta":{"timestamp":"2026-05-30T18:17:09.920Z","request_id":"99aac6e1-3bfc-4638-b042-d72ff4d39705"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/evaluate":{"get":{"operationId":"get_v1_evaluate","tags":["Poker"],"summary":"Evaluate best 5-card hand","description":"","parameters":[{"name":"cards","in":"query","required":true,"description":"5 to 7 cards","schema":{"type":"string"},"example":"AsKsQsJsTs9d2c"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hand":"Straight Flush","rank":9,"cards":["As","Ks","Qs","Js","Ts","9d","2c"],"tiebreakers":["A"]},"meta":{"timestamp":"2026-05-30T18:17:09.993Z","request_id":"b69c310c-e155-4497-a000-bdb07dae060d"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/odds":{"get":{"operationId":"get_v1_odds","tags":["Poker"],"summary":"Equity calculator (Monte Carlo)","description":"","parameters":[{"name":"hero","in":"query","required":true,"description":"2 hole cards (e.g. AsKs)","schema":{"type":"string"},"example":"AsKs"},{"name":"opponents","in":"query","required":false,"description":"Number of opponents 1-9 (default 1)","schema":{"type":"string"},"example":"1"},{"name":"board","in":"query","required":false,"description":"0, 3, 4 or 5 community cards","schema":{"type":"string"}},{"name":"iterations","in":"query","required":false,"description":"Simulation count 1000-500000 (default 25000)","schema":{"type":"string"},"example":"10000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"hero":["As","Ks"],"board":[],"method":"monte-carlo","opponents":1,"iterations":10000,"tie_percent":1.44,"win_percent":66.5,"lose_percent":32.06,"equity_percent":67.22},"meta":{"timestamp":"2026-05-30T18:17:11.182Z","request_id":"e49a3e2d-e027-4eaf-a07b-9c9cf8fa6836"},"status":"ok","message":"OK","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":600,"monthly_call_quota":15000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1800,"monthly_call_quota":120000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4500,"monthly_call_quota":600000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/poker-api"}