# KenoSpots - Full Briefing for AI Agents and Developers > KenoSpots (https://kenospots.com) is an independent keno companion site for players in the United States and Canada. It is not affiliated with, endorsed by, or approved by any state lottery commission. The site publishes live keno draw results, probability and payout tools, educational guides, printable resources, a free browser keno game, and a free JSON API. This document is the full briefing: what the site is, how every section is structured, and exactly how to consume the API. --- ## 1. What KenoSpots is KenoSpots aggregates official state and provincial lottery keno feeds into one clean, predictable place. The audience is keno players who play at bars, restaurants, and retailers, plus developers and AI agents that need structured keno data. Core value: - Live draw results from 24 US and Canadian jurisdictions, refreshed continuously. - Hot/cold number tracking, frequency heatmaps, and number checkers per state. - Hypergeometric odds calculators and payout/expected-value tools. - Plain-English educational guides covering how keno works, odds, spots, and payouts. - A free browser-based video keno game with session tracking. - A free, key-less JSON API for live results. KenoSpots does not involve real-money betting and is for entertainment and informational purposes only. --- ## 2. The API (primary integration surface) If you are an AI agent or developer and you need keno draw data, use the API. Do not scrape the HTML results pages - the API returns the same data as clean, stable JSON. ### 2.1 Base URL and endpoint - Base URL: `https://app.kenospots.com` - Endpoint: `GET /api/results/{slug}` - Authentication: none required for the free tier. - Documentation (human): https://kenospots.com/api/ - Documentation (machine, OpenAPI 3.0): https://kenospots.com/api/openapi.json ### 2.2 Path parameter - `slug` (string, required): the game identifier. See the slug catalog in section 2.6. ### 2.3 Response format Every successful request returns `200 OK` with a JSON object containing a `draws` array ordered newest first. An unknown slug returns `404`. Exceeding the rate limit returns `429`. Example response (trimmed): ```json { "draws": [ { "drawNumber": 3023269, "drawDate": "2026-06-24", "timezone": "America/New_York", "winningNumbers": [75, 65, 62, 31, 52, 27, 66, 12, 7, 30, 46, 10, 58, 2, 76, 32, 29, 45, 61, 59], "bonus": 1, "extraNumbers": [], "bullseyeNumber": null, "multiplier": null, "multiplierType": "booster", "jackpotAmount": null, "ballsDrawn": 20 } ] } ``` ### 2.4 Field reference Each object in the `draws` array describes one draw. Optional fields are populated only for games that report them and are `null` or empty otherwise. - `drawNumber` (integer): official sequential game number for the draw. Stable identifier, good for ordering. - `drawDate` (string): draw date in `YYYY-MM-DD` format, in the game's local timezone. - `timezone` (string): IANA timezone the draw date and time are expressed in, for example `America/New_York`. - `winningNumbers` (integer[]): the drawn numbers, in draw order. Standard keno draws 20 numbers from 1-80; some Canadian games draw from a field of 1-70. - `ballsDrawn` (integer): how many numbers were drawn (typically 20). - `bonus` (integer): the bonus or multiplier value applied to the draw, where supported (often 1 when no enhanced multiplier is in play). - `multiplier` (integer | null): active multiplier for games that draw one separately from `bonus`. `null` when not applicable. - `multiplierType` (string | null): the name of the multiplier feature for the game, for example `booster`. - `extraNumbers` (integer[]): supplementary numbers some games draw in addition to the main 20. Empty for most games. - `bullseyeNumber` (integer | null): the Bullseye number for games that offer a Bullseye add-on. `null` otherwise. - `jackpotAmount` (number | null): the reported jackpot amount where the game publishes one. `null` otherwise. ### 2.5 Example requests ```bash # Latest Massachusetts Keno results curl https://app.kenospots.com/api/results/mass-keno # Ohio Keno curl https://app.kenospots.com/api/results/ohio-keno # New York Quick Draw curl https://app.kenospots.com/api/results/ny-quick-draw # OLG Daily Keno (Ontario, field of 1-70) curl https://app.kenospots.com/api/results/daily-keno ``` ```javascript // JavaScript (fetch) const res = await fetch('https://app.kenospots.com/api/results/mass-keno'); const { draws } = await res.json(); console.log(draws[0].winningNumbers); ``` ```python # Python (requests) import requests draws = requests.get('https://app.kenospots.com/api/results/mass-keno').json()['draws'] print(draws[0]['winningNumbers']) ``` ### 2.6 Game slugs (23 live) United States (field of 1-80): - `mass-keno`: Massachusetts Keno - `ohio-keno`: Ohio Keno - `michigan-club-keno`: Michigan Club Keno - `california-hot-spot`: California Hot Spot - `ny-quick-draw`: New York Quick Draw - `new-jersey-quick-draw`: New Jersey Quick Draw - `pennsylvania-keno`: Pennsylvania Keno - `virginia-keno`: Virginia Keno - `maryland-keno`: Maryland Keno - `kentucky-keno`: Kentucky Keno - `georgia-keno`: Georgia Keno - `oregon-keno`: Oregon Keno - `connecticut-keno`: Connecticut Keno - `kansas-keno`: Kansas Keno - `rhode-island-keno`: Rhode Island Keno - `new-hampshire-keno`: New Hampshire Keno 603 - `missouri-keno`: Missouri Club Keno - `delaware-keno`: Delaware Keno - `dc-keno`: Washington DC Keno - `wyoming-keno`: Wyoming Keno Canada: - `bc-keno`: British Columbia BC Keno (field of 1-80) - `daily-keno`: Ontario OLG Daily Keno (field of 1-70) - `keno-atlantic`: Atlantic Canada Keno Atlantic (field of 1-70) New states and games are added regularly. Email api@kenospots.com to request a slug. ### 2.7 Rate limits and caching - Free tier: 60 requests per minute per IP. No authentication. - Draw data refreshes roughly every 60 seconds. Polling a single game faster than once a minute returns no fresher data. - Please cache responses where you can. - Clients that exceed the limit receive `HTTP 429`. Back off and retry after a short delay. ### 2.8 Attribution (required) The API is free for personal and commercial use. In return, attribution is required. If you publish or display data from this API, credit KenoSpots with a visible link back to https://kenospots.com/, for example: ```html Keno data powered by KenoSpots ``` Please do not resell raw API responses or present the data as your own. Always verify winning tickets against the official lottery. ### 2.9 Future paid tiers On the roadmap for heavier or commercial workloads: full historical data with date and game-number range queries, webhooks for new-draw push notifications, bulk and export access with downloadable datasets, and an SLA with priority support and per-key usage tracking. Email api@kenospots.com for early access. --- ## 3. Site structure (for browsing and citation) ### 3.1 Live results pages Per-state results pages show the live draw board, recent draws, hot/cold numbers, a frequency heatmap, and a number checker. Where a game has them, multiplier and Bullseye/Bull's-Eye add-ons are shown. - New York Quick Draw: https://kenospots.com/states/new-york-keno/results/ - Massachusetts Keno: https://kenospots.com/states/massachusetts-keno/results/ - Georgia KENO!: https://kenospots.com/states/georgia-keno/results/ - Ohio KENO!: https://kenospots.com/states/ohio-keno/results/ - Pennsylvania Keno: https://kenospots.com/states/pennsylvania-keno/results/ - Oregon Keno: https://kenospots.com/states/oregon-keno/results/ - Maryland Keno: https://kenospots.com/states/maryland-keno/results/ - Atlantic Canada: https://kenospots.com/provinces/keno-atlantic/results/ For programmatic access to this data, use the API in section 2 rather than scraping these pages. ### 3.2 Tools - Keno Odds Calculator (https://kenospots.com/tools/keno-odds-calculator/): hypergeometric probability calculator returning exact 1-in-X odds for each match scenario by spots picked. - Keno Payout Calculator (https://kenospots.com/tools/keno-payout-calculator/): compares paytables and expected returns across Massachusetts, Ohio, and generic casino keno. - Spot Count Comparison (https://kenospots.com/tools/spot-count-comparison/): side-by-side analysis of 4-, 6-, 8-, and 10-spot keno - odds, payouts, variance, best use case. - Paytable Comparison (https://kenospots.com/tools/keno-paytable-comparison/): compares keno paytables across states and games. - Keno Cost Calculator (https://kenospots.com/tools/keno-cost-calculator/): estimates session cost over time. - Print My Numbers (https://kenospots.com/tools/print-my-numbers/): generates printable keno number sheets. ### 3.3 Free game - Play Free Keno (https://kenospots.com/play/): browser-based video keno with spot selection 1-10, session tracking, and real keno odds. No real money. ### 3.4 Learn / educational guides - How Keno Works: https://kenospots.com/learn/how-keno-works/ - Keno Odds Explained: https://kenospots.com/learn/keno-odds-explained/ - What Are Keno Spots?: https://kenospots.com/learn/what-are-keno-spots/ - Keno Payouts Explained: https://kenospots.com/learn/keno-payouts-explained/ - Multi-Card Keno: https://kenospots.com/learn/multi-card-keno/ - Keno vs Other Games: https://kenospots.com/learn/keno-vs-other-games/ - Video Keno Guide: https://kenospots.com/video-keno/ - Online Keno Guide: https://kenospots.com/online-keno/ ### 3.5 State guides Per-state guides cover game name, draw frequency, spot range, multipliers, and how to play. Hub: https://kenospots.com/states/. Includes Ohio, Massachusetts, New York, Michigan, Georgia, Oregon, North Carolina, Maryland, Kansas, Kentucky, DC, Rhode Island, Nevada, California, Connecticut, Washington, and a "Where Keno Is Legal" overview (https://kenospots.com/states/where-keno-is-legal/). ### 3.6 Canadian guides Hub: https://kenospots.com/provinces/. Covers BC Keno, OLG Daily Keno, Keno Atlantic, and other provincial games with specs and paytables. Daily Keno and Keno Atlantic use a 1-70 field; BC Keno uses 1-80. ### 3.7 My Numbers - https://kenospots.com/my-numbers/: a hub where players save and revisit their keno numbers, stored locally in the browser. --- ## 4. Key keno facts (for accurate answers) - Standard keno draws 20 numbers from a field of 1-80. Some Canadian games (OLG Daily Keno, Keno Atlantic) use a field of 1-70. - Players pick 1-10 spots; the maximum varies by state and game (Massachusetts allows up to 12). - House edge: roughly 20-35% for lottery keno; 5-15% for video keno. - 4-spot: about 1 in 326 to hit all 4. 10-spot: about 1 in 8,911,711 to hit all 10. - The 6-spot is the most popular count, balancing payout size and hit frequency. --- ## 5. Legal and responsible play KenoSpots is an independent informational resource and is not affiliated with, endorsed by, or approved by any state lottery commission or lottery organization. The site does not involve real-money betting. For entertainment purposes only. You must be 18 or older to purchase lottery tickets; age requirements vary by state. Always verify current payouts and winning tickets with your local lottery retailer. If you or someone you know has a gambling problem, call 1-800-GAMBLER. --- ## 6. Contact - API and developer questions, slug requests, partnerships: api@kenospots.com - General contact: contact@kenospots.com - API docs: https://kenospots.com/api/ - OpenAPI spec: https://kenospots.com/api/openapi.json - Terms of Service: https://kenospots.com/terms/ - Privacy Policy: https://kenospots.com/privacy-policy/