Skip to content
Lottery Feed API

Lottery Feed API

ResultsPersonalAPI DocsPricingContact
Sign inJoin the Free Beta
  1. Home
  2. /
  3. API docs
  4. /
  5. Lottery Number Frequency Statistics API

API documentation

Lottery Number Frequency Statistics API

Returns bounded historical number counts and descriptive statistics for one lottery and date range, not an API polling rate.

Section

25 / 27

OpenAPI JSON
01Introduction02Quickstart03Polling and integration04Sandbox fixtures05SDK starter06Embeddable widgets07API playground08OpenAPI spec09Postman collection10API changelog11Authentication12API key scopes13Freshness levels14Source confidence15Status monitoring16Rate limiting17Get countries18Get states19Get lotteries20Get lottery21Get schedules22Draw years23Lottery results24History export25Number frequency26Result checker27Error handling

Live API examples

Jump from the docs to real public pages that use the same read models.

Lottery API polling and cache guideUse schedule windows, bounded result requests, retry headers, and the correct cache surface for each integration.
Maryland Pick 3 statistics pageView the human-readable frequency and responsible-use page backed by this API model.
Maryland Pick 3 API guideCopy request examples for the same lottery without exposing browser bearer tokens.
Results history docsUnderstand the stored draw rows that frequency windows aggregate from.
OpenAPI frequency contractGenerate client code from the bounded frequency response schema.

Endpoints

GET
/v1/lotteries/{game_code}/frequency

Canonical descriptive statistics endpoint.

GET
/v1/stats/{game_code}

Short alias with the same response shape and scope.

Responsible data use

Frequency, gap, sum, and odd/even views describe stored historical draws only. They are developer data tools, not predictions, betting advice, or a promise of future outcomes.

Lottery Feed API is a data/API service, not a gambling operator. Public pages and customer integrations should show age/legal requirements where applicable and should not present historical statistics as a way to improve winning odds.

U.S. problem-gambling help resources are available from the National Council on Problem Gambling. Use jurisdiction-specific help links where local rules require them.

Request

This endpoint describes historical number frequency; it does not control request polling frequency. Frequency is computed from official or verified customer-visible rows by default. Without date, the endpoint uses the latest visible draw date. Add a supported window to read bounded indexed history; requests above the current plan return STATISTICS_WINDOW_REQUIRES_UPGRADE before a history query runs. Unsupported windows fail closed. Add include=details only when a screen needs bounded detail tables. These historical statistics are not predictions.

GET https://api.lotteryfeedapi.com/v1/lotteries/md-pick3-midday/frequency?window=7d&include=details

Short stats alias

Use the alias when a compact developer route is easier to document in SDKs or internal jobs. It does not create a second statistics pipeline and it does not loosen source, window, include, or access behavior. This 30-day example requires Starter/F2 or higher.

GET https://api.lotteryfeedapi.com/v1/stats/md-pick3-midday?window=30d&include=details

Response

The compact response returns sorted counts, odd/even and sum summary, the trusted date range used for the calculation, draw count, excluded visible-row count, source-confidence summary, sample quality, and a non-prediction disclaimer. With include=details it also returns bounded parity and sum-distribution patterns, longest observed gaps, adjacent-pair counts, and full-combination counts. Successful frequency responses use a short private cache keyed by Authorization; validation errors stay no-store. Access metadata remains omitted from public responses.

{
  "generated_at": "2026-05-25T17:45:26Z",
  "game_code": "md-pick3-midday",
  "range": { "date": "2026-05-25", "source": "latest_visible_draw", "window": "7d" },
  "date_range": { "from": "2026-05-19", "to": "2026-05-25" },
  "draw_count": 7,
  "excluded_draw_count": 2,
  "source_confidence_summary": {
    "primary": {
      "level": "official",
      "label": "Official source",
      "policy": "Numbers were published from the official or canonical lottery source path."
    },
    "levels": [{ "level": "official", "label": "Official source", "count": 7 }],
    "classified_draws": 7,
    "unclassified_draws": 0
  },
  "quality": {
    "level": "stable",
    "label": "Stable trusted sample",
    "minimum_recommended_draws": 5,
    "description": "7 official source rows are included, meeting the minimum sample threshold for a stable descriptive statistics response."
  },
  "disclaimer": "Frequency data describes stored historical draws for the selected date range. It is not a prediction, gambling advice, or a promise of future outcomes.",
  "response_shape": "compact",
  "included_fields": ["patterns", "longest_gaps", "top_pairs", "top_combinations"],
  "omitted_fields": ["access"],
  "full_shape_hint": "Use include=patterns,gaps,pairs,combinations or include=details for bounded detail tables.",
  "summary": {
    "total_numbers": 21,
    "unique_numbers": 10,
    "odd_count": 11,
    "even_count": 10,
    "average_sum": 12.4,
    "min_sum": 4,
    "max_sum": 22
  },
  "numbers": [
    { "number": "2", "count": 7 },
    { "number": "3", "count": 6 },
    { "number": "6", "count": 5 }
  ],
  "patterns": {
    "parity": { "odd_count": 11, "even_count": 10, "odd_percent": 52.38, "even_percent": 47.62, "balance": "more_odd" },
    "sums": {
      "average": 12.4,
      "min": 4,
      "max": 22,
      "distribution": [{ "sum": 11, "count": 3, "percent": 42.86 }]
    }
  },
  "longest_gaps": [{ "number": "7", "count": 2, "last_seen_draws_ago": 12 }],
  "top_pairs": [{ "pair": "2-3", "positions": [1, 2], "count": 4, "last_seen_draws_ago": 2 }],
  "top_combinations": [{ "numbers": ["2", "3", "6"], "numbers_formatted": "2-3-6", "count": 2, "last_seen_draws_ago": 0 }]
}

Responsible use

Frequency data is a historical summary for developer tools. Do not present hot/cold numbers, gaps, sums, or frequency windows as predictions, betting advice, or a way to improve odds. Customer products should show age and legal disclosures and local problem-gambling help resources where required.


Next: Result checker
Lottery Feed API

Normalized lottery draw results, history, schedules, source-confidence metadata, and descriptive analytics for integrations and personal analysis.

Independent software and data service. We do not sell lottery tickets, accept bets or player funds, operate draws, determine outcomes or pay prizes.Lottery names and trademarks belong to their respective owners. Lottery Feed API is an independent data service and is not affiliated with, endorsed by, sponsored by or operated by any lottery authority.
LotteriesDaily ArchiveCountriesStatesStatusResponsible UseAcceptable UseReport incorrect resultCompanyTermsPrivacyAccount