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
Live API examples
Jump from the docs to real public pages that use the same read models.
Endpoints
/v1/lotteries/{game_code}/frequencyCanonical descriptive statistics endpoint.
/v1/stats/{game_code}Short alias with the same response shape and scope.
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