bet.hkjc.com APIbet.hkjc.com ↗
Get Hong Kong Jockey Club Mark Six draw results, prize breakdowns, jackpot amounts, and frequency statistics for all 49 numbers via a simple REST API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2fc81dc0-16a8-4b7d-8674-ab10815189b7/get_latest_results' \ -H 'X-API-Key: $PARSE_API_KEY'
Get the latest Mark Six draw results including drawn numbers, extra number, prize dividends, jackpot amount, snowball info, and next scheduled draw details. Returns the most recent completed draw and the next upcoming draw.
No input parameters required.
{
"type": "object",
"fields": {
"draws": "array of draw objects containing id, year, draw_number, draw_date, status, drawn_numbers, extra_number, snowball info, investment/jackpot amounts, and prize breakdown",
"total": "integer - number of draws returned"
},
"sample": {
"data": {
"draws": [
{
"id": "202650N",
"year": "2026",
"prizes": [
{
"type": 1,
"dividend": "30646080",
"winning_units": 5
}
],
"status": "Result",
"jackpot": "22901594",
"unit_bet": 10,
"draw_date": "2026-05-12+08:00",
"open_date": "2026-05-10+08:00",
"close_date": "2026-05-12T21:15:00+08:00",
"draw_number": 50,
"extra_number": 40,
"drawn_numbers": [
4,
16,
19,
22,
25,
47
],
"snowball_code": "",
"estimated_prize": "",
"snowball_name_ch": "",
"snowball_name_en": "",
"total_investment": "65569303",
"derived_first_prize_div": "30000000"
}
],
"total": 2
},
"status": "success"
}
}About the bet.hkjc.com API
The HKJC Mark Six API provides two endpoints covering draw results and number frequency statistics for Hong Kong's official lottery. get_latest_results returns the most recent completed draw with drawn numbers, extra number, snowball details, and prize dividends, plus metadata on the next scheduled draw. get_number_statistics delivers historical frequency data across all 49 possible numbers, including draw count and recency for each.
Draw Results
The get_latest_results endpoint returns an array of draw objects under the draws key. Each object includes fields such as id, year, draw_number, draw_date, status, drawn_numbers (the six main balls), extra_number, snowball information, and investment and prize dividend breakdowns. A total integer confirms how many draw records were returned. The endpoint requires no input parameters and always reflects the most recently completed draw alongside metadata for the next upcoming draw.
Number Frequency Statistics
The get_number_statistics endpoint covers all 49 Mark Six numbers. Each entry in the numbers array contains the number (1–49), total_drawn (how many times that number has appeared historically), and last_drawn_in_draw (how many draws ago the number was last selected). Three reference fields — reference_year, reference_draw_date, and reference_draw_number — anchor the statistics to a specific draw so you know exactly what period the frequency data covers. total_numbers is always 49.
Coverage and Freshness
Both endpoints reflect the live state of the HKJC Mark Six results page at bet.hkjc.com. The results endpoint distinguishes current draw status (e.g. completed vs. upcoming) via the status field on each draw object, which is useful for polling workflows that need to detect when a new result has been published. Snowball draw details are surfaced when applicable, allowing applications to flag draws with rolled-over jackpots.
- Display the latest Mark Six winning numbers and prize dividends in a lottery results app
- Alert users when a snowball jackpot draw is scheduled using the snowball fields from
get_latest_results - Build a number frequency heatmap for all 49 balls using
total_drawnfromget_number_statistics - Identify 'cold' numbers by sorting on
last_drawn_in_drawto find balls absent for the most draws - Track jackpot investment totals across recent draws by consuming the investment field in draw objects
- Show the next scheduled draw date and time to lottery enthusiasts ahead of each draw night
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does HKJC provide an official public developer API for Mark Six results?+
What does the `get_latest_results` endpoint actually return — is it just the most recent draw or multiple draws?+
draws that includes the most recently completed draw and information about the next upcoming draw. The total field tells you how many draw objects are in the response. Each draw object carries drawn_numbers, extra_number, snowball details, prize dividends, and status to distinguish completed from upcoming.Does the API expose historical draw results beyond the most recent one?+
get_latest_results endpoint covers the most recent completed draw and the next upcoming draw. It does not return a paginated archive of past draws. The get_number_statistics endpoint provides aggregate historical frequency data per number but not individual historical draw records. You can fork this API on Parse and revise it to add a historical draws endpoint if you need per-draw records going back further.Can I filter number statistics by a specific date range or draw period?+
get_number_statistics endpoint does not accept date or draw-range parameters — it returns aggregate totals for all 49 numbers referenced to a single anchor draw identified by reference_draw_number and reference_draw_date. Filtering by period is not currently supported. You can fork the API on Parse and revise it to add date-scoped frequency queries.How do I know if a draw is a snowball draw from the response?+
draws array from get_latest_results includes snowball-specific fields. When a draw carries a rolled-over snowball jackpot, those fields will be populated, allowing your application to distinguish standard draws from snowball events without any additional calls.