API & RSS kết quả xổ số

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.

  • Base URLhttps://kqxs.namnguyenit.com/api/v1
  • Xác thựcKhông cần API key
  • Định dạngJSON UTF-8, ngày YYYY-MM-DD
  • Giới hạn120 yêu cầu mỗi phút mỗi IP
  • Đặc tảOpenAPI 3.1 (JSON)
  • Liên hệkqxs1996@gmail.com

Bắt đầu nhanh

Mọ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ý:

curl
# 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"
JavaScript (fetch)
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]);
Python (requests)
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.

Endpoint

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.

Thông tin

GET/api/v1/

Thông tin API và danh sách endpoint

GET/api/v1/openapi.json

Đặc tả OpenAPI 3.1 (JSON)

GET/api/v1/provinces

Danh 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.

Xổ số 3 miền

GET/api/v1/results/{region}/latest

Kế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ểuMô tả
region bắt buộcđường dẫnstring
mb, mn, mt
Miền: mb (Bắc), mn (Nam), mt (Trung).
lotoqueryinteger
0, 1
mặc định 0
Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài.
GET/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ểuMô tả
region bắt buộcđường dẫnstring
mb, mn, mt
Miền: mb (Bắc), mn (Nam), mt (Trung).
datequerystring (date)Ngày quay dạng YYYY-MM-DD.
lotoqueryinteger
0, 1
mặc định 0
Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài.
GET/api/v1/results/{region}/range

Kế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ểuMô tả
region bắt buộcđường dẫnstring
mb, mn, mt
Miền: mb (Bắc), mn (Nam), mt (Trung).
from bắt buộcquerystring (date)Ngày bắt đầu (bao gồm).
to bắt buộcquerystring (date)Ngày kết thúc (bao gồm), không quá 31 ngày sau from.
lotoqueryinteger
0, 1
mặc định 0
Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài.
GET/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ểuMô tả
slug bắt buộcđường dẫnstringMã đài, lấy từ /provinces.
datequerystring (date)Chỉ lấy ngày này (404 nếu đài không quay).
limitqueryinteger
mặc định 10
Số kỳ gần nhất (1 đến 31), bỏ qua khi có date.
lotoqueryinteger
0, 1
mặc định 0
Đặt 1 để kèm bảng lô tô (đầu và đuôi) cho từng đài.

Điện toán, Vietlott, Keno

GET/api/v1/games

Danh sách trò chơi điện toán, Vietlott và Keno

GET/api/v1/games/{slug}/latest

Kỳ quay mới nhất của một trò chơi

Tham sốVị tríKiểuMô tả
slug bắt buộcđường dẫnstringMã 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.
GET/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ểuMô tả
slug bắt buộcđường dẫnstringMã 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.
datequerystring (date)Ngày quay dạng YYYY-MM-DD.
kyqueryintegerSố kỳ quay (kỳ mở thưởng).
GET/api/v1/keno/latest

Kỳ Keno mới nhất
Lối tắt của /games/keno/latest.

Thống kê

GET/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ểuMô tả
loai bắt buộcđường dẫnstring
lo-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ẫnstringmien-bac hoặc slug của đài miền Nam/Trung (vd tp-hcm).
daysqueryinteger
30, 60, 90, 180, 365
mặc định 30
Số kỳ gần nhất cho tan-suat-lo-to.

Cấu trúc kết quả xổ số 3 miền

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
}
  • Mã giải theo thứ tự hiển thị: miền Bắc Đ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.
  • Lô tô: hai chữ số cuối của mọi giải. 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.
  • Điện toán, Vietlott, Keno: mỗi kỳ có groups (nhóm số quay thưởng), prizes (số người trúng, giá trị giải bằng đồng) và jackpot khi có.

Ví dụ response thật

Lấy trực tiếp từ dữ liệu của website tại thời điểm hiển thị trang.

Kết quả XSMB mới nhất 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"
}
Kết quả một đài (TP.HCM, 1 kỳ, có lô 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"
    }
  ]
}
Kỳ Mega 6/45 mới nhất 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/"
  }
}
Thống kê lô gan miền Bắc (rút gọn 3 dòng) 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/"
}
Lỗi thống nhất (HTTP 400) GET /results/mb?date=2026-13-45
{
  "error": {
    "code": "invalid_date",
    "message": "date phải có dạng YYYY-MM-DD."
  }
}

Mã lỗi

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." } }
HTTPcodeKhi nào
400invalid_datedate, from hoặc to không đúng dạng YYYY-MM-DD.
400invalid_rangeto nhỏ hơn from.
400range_too_largeKhoảng ngày vượt quá 31 ngày.
400invalid_limitlimit ngoài khoảng 1 đến 31.
400invalid_periodky không phải số nguyên dương.
400invalid_daysdays không thuộc 30, 60, 90, 180, 365.
400missing_paramThiếu tham số bắt buộc (vd /games/{slug} cần date hoặc ky).
404not_foundEndpoint, miền, đài, trò chơi hoặc ngày không có dữ liệu.
405method_not_allowedDùng phương thức khác GET, HEAD, OPTIONS.
429rate_limitedVượt 120 yêu cầu mỗi phút từ một IP; đọc header Retry-After.

Cache, ETag và giới hạn tốc độ

  • ETag: mọi phản hồi 200 có 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).
  • Cache-Control: dữ liệu mới nhất cache 30 giây; ngày đã quay xong cache 1 giờ; danh sách đài, trò chơi và đặc tả cache 1 giờ; thống kê 10 phút.
  • CORS: Access-Control-Allow-Origin: *, gọi trực tiếp từ trình duyệt được.
  • Giới hạn: 120 yêu cầu mỗi phút cho mỗi IP. Mỗi phản hồi có X-RateLimit-Limit và X-RateLimit-Remaining; khi vượt giới hạn nhận 429 kèm Retry-After (giây).
  • Gọn hoặc dễ đọc: thêm ?pretty=1 để JSON có thụt dòng.
Yêu cầu có điều kiện
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"   # 304

RSS

Mỗ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.

FeedURLNội dung
Tất cả kết quả mới nhấthttps://kqxs.namnguyenit.com/rss.xmlXSMB, 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.xml30 kỳ quay gần nhất.
XSMN (miền Nam)https://kqxs.namnguyenit.com/rss/xsmn.xml30 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.xml30 ngày quay gần nhất, mọi đài trong một mục.
Vietlott và điện toánhttps://kqxs.namnguyenit.com/rss/vietlott.xmlMọi trò chơi; Keno chỉ hiện kỳ mới nhất.
Điện toánhttps://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.xml30 bài mới nhất.
Theo đài, ví dụ TP.HCMhttps://kqxs.namnguyenit.com/rss/tp-hcm.xml30 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/45https://kqxs.namnguyenit.com/rss/mega-6-45.xml30 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.

Điều khoản sử dụng

  • Ghi nguồn: khi hiển thị lại dữ liệu hoặc ảnh kết quả, vui lòng ghi nguồn KQXS Hôm Nay kèm liên kết về https://kqxs.namnguyenit.com/. Mẫu: Dữ liệu từ <a href="https://kqxs.namnguyenit.com/">KQXS Hôm Nay</a>.
  • Chỉ mang tính tham khảo: dữ liệu được tổng hợp tự động từ nguồn công khai, có thể chậm hoặc sai sót. Hãy đối chiếu với kết quả chính thức của công ty xổ số khi dò vé.
  • Không dùng cho cá cược: không dùng API để tổ chức, quảng bá hay hỗ trợ cá cược, ghi đề hoặc dịch vụ trái pháp luật.
  • Dùng hợp lý: tôn trọng giới hạn tốc độ, lưu bộ nhớ đệm, không cào dữ liệu hàng loạt. Chúng tôi có thể chặn địa chỉ lạm dụng. Cần lượng lớn hơn, hãy liên hệ trước.
  • Không bảo đảm: API cung cấp nguyên trạng, có thể thay đổi; thay đổi không tương thích sẽ ra phiên bản mới (/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.