/api/v1/Thông tin API và danh sách endpoint
Lấy kết quả xổ số 41 đài của ba miền, Điện toán, Vietlott và Keno dưới dạng JSON hoặc RSS. Miễn phí, không cần khóa, chỉ đọc, bật CORS cho mọi trang web.
https://kqxs.namnguyenit.com/api/v1YYYY-MM-DDMọi endpoint dùng phương thức GET và trả về JSON. Thử ngay một lệnh, không cần đăng ký:
# kết quả XSMB mới nhất, chỉ lấy giải đặc biệt
curl -s "https://kqxs.namnguyenit.com/api/v1/results/mb/latest" | jq '.provinces[0].prizes.DB[0]'
# XSMN một ngày, kèm bảng lô tô
curl -s "https://kqxs.namnguyenit.com/api/v1/results/mn?date=2026-11-22&loto=1"
# 5 kỳ gần nhất của một đài
curl -s "https://kqxs.namnguyenit.com/api/v1/results/province/tp-hcm?limit=5"
# kỳ Mega 6/45 mới nhất
curl -s "https://kqxs.namnguyenit.com/api/v1/games/mega-6-45/latest"async function layKetQua(mien = "mb") {
const res = await fetch("https://kqxs.namnguyenit.com/api/v1/results/" + mien + "/latest");
if (!res.ok) {
const { error } = await res.json(); // { error: { code, message } }
throw new Error(error.code + ": " + error.message);
}
return res.json();
}
const kq = await layKetQua("mb");
console.log(kq.date, kq.provinces[0].prizes.DB[0]);import requests
BASE = "https://kqxs.namnguyenit.com/api/v1"
def ket_qua(mien="mb", ngay=None):
r = requests.get(f"{BASE}/results/{mien}", params={"date": ngay} if ngay else None, timeout=10)
if r.status_code == 429: # vượt giới hạn tốc độ
raise RuntimeError("Chờ %s giây" % r.headers["Retry-After"])
r.raise_for_status()
return r.json()
kq = ket_qua("mb")
print(kq["date"], kq["provinces"][0]["prizes"]["DB"][0])Gợi ý dùng hợp lý: lưu kết quả đã quay vào bộ nhớ đệm của bạn (kết quả một ngày đã quay xong không đổi), chỉ hỏi lại endpoint latest trong khung giờ quay (MN 16h10, MT 17h10, MB 18h10) và dùng ETag để nhận 304 thay vì tải lại.
Bấm Gửi thử để gọi thật từ trình duyệt của bạn (sửa đường dẫn trong ô nhập nếu muốn). Đường dẫn có dạng {tham-số} là tham số đường dẫn.
/api/v1/Thông tin API và danh sách endpoint
/api/v1/openapi.jsonĐặc tả OpenAPI 3.1 (JSON)
/api/v1/provincesDanh sách đài (tỉnh) và lịch quay
Mọi đài của ba miền: slug (dùng cho các endpoint khác), miền, ngày quay trong tuần (0 = Chủ nhật), giờ quay thường lệ và đường dẫn RSS.
/api/v1/results/{region}/latestKết quả mới nhất của một miền
Ngày quay đang hiển thị trên website: hôm nay khi đã tới giờ quay (có thể ở trạng thái partial khi đang quay), ngược lại là ngày gần nhất có dữ liệu.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
region bắt buộc | đường dẫn | stringmb, mn, mt | Miền: mb (Bắc), mn (Nam), mt (Trung). |
loto | query | integer0, 1mặc định 0 | Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài. |
/api/v1/results/{region}Kết quả của một miền theo ngày
Trả về mọi đài của miền trong ngày được chọn. Thiếu date thì lấy ngày mới nhất.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
region bắt buộc | đường dẫn | stringmb, mn, mt | Miền: mb (Bắc), mn (Nam), mt (Trung). |
date | query | string (date) | Ngày quay dạng YYYY-MM-DD. |
loto | query | integer0, 1mặc định 0 | Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài. |
/api/v1/results/{region}/rangeKết quả của một miền trong khoảng ngày
Các ngày có dữ liệu trong khoảng, mới nhất trước. Tối đa 31 ngày mỗi lần gọi.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
region bắt buộc | đường dẫn | stringmb, mn, mt | Miền: mb (Bắc), mn (Nam), mt (Trung). |
from bắt buộc | query | string (date) | Ngày bắt đầu (bao gồm). |
to bắt buộc | query | string (date) | Ngày kết thúc (bao gồm), không quá 31 ngày sau from. |
loto | query | integer0, 1mặc định 0 | Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài. |
/api/v1/results/province/{slug}Kết quả của một đài
Các kỳ quay gần nhất của một đài, hoặc một ngày cụ thể khi có date.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
slug bắt buộc | đường dẫn | string | Mã đài, lấy từ /provinces. |
date | query | string (date) | Chỉ lấy ngày này (404 nếu đài không quay). |
limit | query | integer mặc định 10 | Số kỳ gần nhất (1 đến 31), bỏ qua khi có date. |
loto | query | integer0, 1mặc định 0 | Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài. |
/api/v1/gamesDanh sách trò chơi điện toán, Vietlott và Keno
/api/v1/games/{slug}/latestKỳ quay mới nhất của một trò chơi
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
slug bắt buộc | đường dẫn | string | Mã trò chơi, lấy từ /games: dien-toan-123, than-tai-4, dien-toan-6x36, mega-6-45, power-6-55, max-3d, max-3d-pro, keno. |
/api/v1/games/{slug}Kết quả trò chơi theo ngày hoặc theo kỳ
Dùng date để lấy mọi kỳ trong ngày (Keno có nhiều kỳ mỗi ngày), hoặc ky để lấy đúng một kỳ (trả về dạng {game, draw}). Phải có một trong hai.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
slug bắt buộc | đường dẫn | string | Mã trò chơi, lấy từ /games: dien-toan-123, than-tai-4, dien-toan-6x36, mega-6-45, power-6-55, max-3d, max-3d-pro, keno. |
date | query | string (date) | Ngày quay dạng YYYY-MM-DD. |
ky | query | integer | Số kỳ quay (kỳ mở thưởng). |
/api/v1/keno/latestKỳ Keno mới nhất
Lối tắt của /games/keno/latest.
/api/v1/stats/{loai}/{scope}Thống kê lô gan, tần suất lô tô
Dùng lại đúng số liệu của trang /thong-ke/. Chỉ mang tính tham khảo, không dự đoán kết quả.
| Tham số | Vị trí | Kiểu | Mô tả |
|---|---|---|---|
loai bắt buộc | đường dẫn | stringlo-gan, tan-suat-lo-to | lo-gan: 30 cặp lô gan lâu nhất; tan-suat-lo-to: tần suất 00 đến 99. |
scope bắt buộc | đường dẫn | string | mien-bac hoặc slug của đài miền Nam/Trung (vd tp-hcm). |
days | query | integer30, 60, 90, 180, 365mặc định 30 | Số kỳ gần nhất cho tan-suat-lo-to. |
Các endpoint /results/… trả về đối tượng sau (rút gọn):
{
"date": "2026-11-20", // ngày quay, YYYY-MM-DD
"weekday": "Thứ 6",
"region": "mb", // mb | mn | mt
"region_name": "Miền Bắc",
"status": "complete", // complete | partial (đang quay, số chưa quay là "")
"provinces": [
{ "slug": "hai-phong", "name": "Hải Phòng", "status": "complete",
"prizes": { "DB": ["…"], "G1": ["…"], "G2": ["…", "…"], … },
"loto": { "heads": { "0": ["…"] }, "tails": { "0": ["…"] } } // chỉ khi ?loto=1
}
],
"url": "https://kqxs.namnguyenit.com/xsmb/ngay-20-11-2026/",
"image": "https://kqxs.namnguyenit.com/anh/xsmb/2026-11-20.jpg" // hoặc null khi chưa có ảnh
}ĐB, G1, G2, G3, G4, G5, G6, G7 (giải ĐB 5 chữ số); miền Nam và miền Trung G8, G7, G6, G5, G4, G3, G2, G1, ĐB (giải ĐB 6 chữ số). Mỗi giải là một mảng chuỗi để giữ số 0 đầu.heads gom theo đầu (chữ số đầu) và liệt kê các đuôi; tails gom theo đuôi và liệt kê các đầu.groups (nhóm số quay thưởng), prizes (số người trúng, giá trị giải bằng đồng) và jackpot khi có.Lấy trực tiếp từ dữ liệu của website tại thời điểm hiển thị trang.
GET /results/mb/latest{
"date": "2026-11-22",
"image": "https://kqxs.namnguyenit.com/anh/xsmb/2026-11-22.jpg",
"provinces": [
{
"name": "Thái Bình",
"prizes": {
"DB": [
"92286"
],
"G1": [
"08621"
],
"G2": [
"43982",
"75449"
],
"G3": [
"16104",
"02961",
"18492",
"68700",
"72696",
"02991"
],
"G4": [
"0808",
"0474",
"3948",
"1469"
],
"G5": [
"6332",
"0708",
"1749",
"2273",
"5217",
"7843"
],
"G6": [
"359",
"308",
"096"
],
"G7": [
"14",
"99",
"64",
"13"
]
},
"slug": "thai-binh",
"status": "complete"
}
],
"region": "mb",
"region_name": "Miền Bắc",
"status": "complete",
"url": "https://kqxs.namnguyenit.com/xsmb/ngay-22-11-2026/",
"weekday": "Chủ nhật"
}GET /results/province/tp-hcm?limit=1&loto=1{
"count": 1,
"province": {
"name": "TP.HCM",
"region": "mn",
"slug": "tp-hcm"
},
"results": [
{
"date": "2026-11-21",
"image": "https://kqxs.namnguyenit.com/anh/xsmn/2026-11-21.jpg",
"loto": {
"heads": {
"0": [
"6",
"0"
],
"1": [
"4"
],
"2": [
"9",
"4",
"9",
"5"
],
"3": [],
"4": [],
"5": [
"6",
"2"
],
"6": [
"8",
"0",
"8",
"5",
"5"
],
"7": [
"3"
],
"8": [
"9"
],
"9": [
"1",
"0"
]
},
"tails": {
"0": [
"9",
"6",
"0"
],
"1": [
"9"
],
"2": [
"5"
],
"3": [
"7"
],
"4": [
"1",
"2"
],
"5": [
"6",
"6",
"2"
],
"6": [
"5",
"0"
],
"7": [],
"8": [
"6",
"6"
],
"9": [
"8",
"2",
"2"
]
}
},
"prizes": {
"DB": [
"274025"
],
"G1": [
"36565"
],
"G2": [
"03129"
],
"G3": [
"31065",
"03773"
],
"G4": [
"39468",
"09952",
"52460",
"82629",
"84724",
"86500",
"20768"
],
"G5": [
"5590"
],
"G6": [
"9989",
"0206",
"3014"
],
"G7": [
"956"
],
"G8": [
"91"
]
},
"status": "complete",
"url": "https://kqxs.namnguyenit.com/xs-tp-hcm/ngay-21-11-2026/",
"weekday": "Thứ 7"
}
]
}GET /games/mega-6-45/latest{
"draw": {
"date": "2026-11-22",
"game": "mega-6-45",
"groups": [
{
"code": "N",
"label": "Bộ số",
"numbers": [
"01",
"13",
"14",
"18",
"23",
"39"
]
}
],
"image": "https://kqxs.namnguyenit.com/anh/mega-6-45/2026-11-22.jpg",
"jackpot": 17590778000,
"period": 1592,
"prizes": [
{
"name": "Giải Jackpot",
"tier": "J",
"value": 17590778000,
"winners": 0
},
{
"name": "Giải 1",
"tier": "1",
"value": 10000000,
"winners": 0
},
{
"name": "Giải 2",
"tier": "2",
"value": 300000,
"winners": 0
},
{
"name": "Giải 3",
"tier": "3",
"value": 30000,
"winners": 0
}
],
"status": "complete",
"url": "https://kqxs.namnguyenit.com/mega-6-45/ngay-22-11-2026/",
"weekday": "Chủ nhật"
},
"game": {
"days": [
3,
5,
0
],
"days_label": "Thứ 4, Thứ 6, Chủ nhật",
"description": "Mega 6/45 quay số vào thứ 4, thứ 6 và chủ nhật, chọn 6 số trong dãy từ 01 đến 45, giải Jackpot khởi điểm 12 tỷ đồng.",
"draw_time": "18h15",
"family": "vietlott",
"kind": "balls",
"name": "Vietlott Mega 6/45",
"short_name": "Mega 6/45",
"slug": "mega-6-45",
"url": "https://kqxs.namnguyenit.com/mega-6-45/"
}
}GET /stats/lo-gan/mien-bac{
"draws": 1045,
"from": "2024-01-01",
"kind": "lo-gan",
"numbers": [
{
"appeared": 235,
"gan": 20,
"last_date": "2026-11-02",
"max_gan": 24,
"number": "37"
},
{
"appeared": 210,
"gan": 19,
"last_date": "2026-11-03",
"max_gan": 21,
"number": "55"
},
{
"appeared": 228,
"gan": 17,
"last_date": "2026-11-05",
"max_gan": 26,
"number": "30"
}
],
"scope": "mien-bac",
"scope_name": "Miền Bắc (XSMB)",
"to": "2026-11-22",
"url": "https://kqxs.namnguyenit.com/thong-ke/lo-gan/mien-bac/"
}GET /results/mb?date=2026-13-45{
"error": {
"code": "invalid_date",
"message": "date phải có dạng YYYY-MM-DD."
}
}Mọi lỗi có cùng một dạng, kèm mã HTTP tương ứng:
{ "error": { "code": "invalid_date", "message": "date phải có dạng YYYY-MM-DD." } }| HTTP | code | Khi nào |
|---|---|---|
| 400 | invalid_date | date, from hoặc to không đúng dạng YYYY-MM-DD. |
| 400 | invalid_range | to nhỏ hơn from. |
| 400 | range_too_large | Khoảng ngày vượt quá 31 ngày. |
| 400 | invalid_limit | limit ngoài khoảng 1 đến 31. |
| 400 | invalid_period | ky không phải số nguyên dương. |
| 400 | invalid_days | days không thuộc 30, 60, 90, 180, 365. |
| 400 | missing_param | Thiếu tham số bắt buộc (vd /games/{slug} cần date hoặc ky). |
| 404 | not_found | Endpoint, miền, đài, trò chơi hoặc ngày không có dữ liệu. |
| 405 | method_not_allowed | Dùng phương thức khác GET, HEAD, OPTIONS. |
| 429 | rate_limited | Vượt 120 yêu cầu mỗi phút từ một IP; đọc header Retry-After. |
ETag; gửi lại bằng If-None-Match để nhận 304 Not Modified (không tính vào băng thông).Access-Control-Allow-Origin: *, gọi trực tiếp từ trình duyệt được.X-RateLimit-Limit và X-RateLimit-Remaining; khi vượt giới hạn nhận 429 kèm Retry-After (giây).?pretty=1 để JSON có thụt dòng.etag=$(curl -sI "https://kqxs.namnguyenit.com/api/v1/provinces" | awk -F': ' 'tolower($1)=="etag"{print $2}' | tr -d '\r')
curl -s -o /dev/null -w "%{http_code}\n" -H "If-None-Match: $etag" "https://kqxs.namnguyenit.com/api/v1/provinces" # 304Mỗi mục là một kỳ quay: tiêu đề dạng Kết quả XSMB ngày 20/11/2026, mô tả có bảng giải đầy đủ và ảnh kết quả (enclosure và media:content) khi đã có. Giờ đăng theo múi giờ Asia/Ho_Chi_Minh (+0700), cache 60 giây. Trình duyệt và trình đọc tin tự nhận feed nhờ thẻ <link rel="alternate"> trên từng trang.
| Feed | URL | Nội dung |
|---|---|---|
| Tất cả kết quả mới nhất | https://kqxs.namnguyenit.com/rss.xml | XSMB, XSMN, XSMT, mọi trò chơi và tin tức, tối đa 40 mục. |
| XSMB (miền Bắc) | https://kqxs.namnguyenit.com/rss/xsmb.xml | 30 kỳ quay gần nhất. |
| XSMN (miền Nam) | https://kqxs.namnguyenit.com/rss/xsmn.xml | 30 ngày quay gần nhất, mọi đài trong một mục. |
| XSMT (miền Trung) | https://kqxs.namnguyenit.com/rss/xsmt.xml | 30 ngày quay gần nhất, mọi đài trong một mục. |
| Vietlott và điện toán | https://kqxs.namnguyenit.com/rss/vietlott.xml | Mọi trò chơi; Keno chỉ hiện kỳ mới nhất. |
| Điện toán | https://kqxs.namnguyenit.com/rss/dien-toan.xml | Điện toán 123, Thần Tài 4, Điện toán 6x36. |
| Tin tức xổ số | https://kqxs.namnguyenit.com/rss/tin-tuc.xml | 30 bài mới nhất. |
| Theo đài, ví dụ TP.HCM | https://kqxs.namnguyenit.com/rss/tp-hcm.xml | 30 kỳ gần nhất của một đài: /rss/{slug-đài}.xml (slug lấy từ /api/v1/provinces). |
| Theo trò chơi, ví dụ Mega 6/45 | https://kqxs.namnguyenit.com/rss/mega-6-45.xml | 30 kỳ gần nhất: /rss/{slug-trò-chơi}.xml, kể cả keno. |
Ngoài ra có /rss/{slug}.xml cho từng đài (vd ha-noi, tp-hcm, da-nang) và từng trò chơi.
Dữ liệu từ <a href="https://kqxs.namnguyenit.com/">KQXS Hôm Nay</a>./api/v2/).Báo lỗi dữ liệu hoặc trao đổi hợp tác: kqxs1996@gmail.com. Xem thêm Điều khoản sử dụng của website.