API Documentation v2.0

📚 API Documentation

Hướng dẫn sử dụng XoSoAPI - 20+ endpoints cho Thống Kê & Soi Cầu

Bắt Đầu Nhanh

Đăng ký tài khoản

Tạo tài khoản miễn phí để nhận API Key

Đăng ký ngay

Lấy API Key

Sau khi đăng nhập, vào Dashboard để tạo API Key

Gọi API

curl -H "X-API-Key: your_api_key" \
  https://xosoapi.online/api/v1/vietnam/draws

Xác Thực (Authentication)

Sử dụng API Key trong header của mọi request:

X-API-Key: your_api_key

API Endpoints (36 endpoints)

Xổ Số Vietlott(2)

GET/api/vietlott/draws

Code Samples

Lấy kết quả chi tiết Vietlott kèm Jackpot và cơ cấu giải thưởng

GET/api/latest-draws-vn

Code Samples

Lấy kết quả mới nhất của tất cả các miền và Vietlott (Tổng hợp)

Xổ Số Điện Toán(1)

GET/api/v1/dientoan/draws

Code Samples

Lấy kết quả chi tiết Xổ số Điện toán truyền thống (1*2*3, 6x36, Thần Tài 4)

Xổ Số Việt Nam(2)

GET/api/v1/vietnam/draws

Code Samples

Lấy danh sách các kỳ quay gần đây

GET/api/v1/vietnam/provinces

Code Samples

Lấy danh sách các đài/tỉnh

Thống Kê Cơ Bản(17)

GET/api/stats/hot-numbers

Code Samples

Số Nóng - Top số hay về nhất

GET/api/stats/gap

Code Samples

Lô Gan - Các số lâu chưa về

GET/api/stats/frequency

Code Samples

Tần suất xuất hiện, đầu đuôi, lô kép

GET/api/stats/head-tail

Code Samples

Thống kê Đầu Đuôi (0-9)

GET/api/stats/pair-frequency

Code Samples

Cặp số hay về cùng nhau

GET/api/stats/special-week

Code Samples

Bảng Đặc Biệt Tuần

GET/api/stats/loto-cycle

Code Samples

Chu Kỳ xuất hiện Loto

GET/api/stats/matrix

Code Samples

Bảng Ma Trận Lô Tô (00-99)

GET/api/stats/theo-tong

Code Samples

Thống kê theo Tổng (0-9)

GET/api/stats/lo-gan

Code Samples

Thống kê Lô Gan (Số lâu chưa về)

GET/api/stats/db-nam

Code Samples

Bảng Đặc Biệt Năm - Ma trận kết quả theo năm

GET/api/stats/db-thang

Code Samples

Bảng Đặc Biệt Tháng - Chi tiết trong tháng

GET/api/stats/special-year

Code Samples

Tổng Hợp Đặc Biệt - Phân tích chu kỳ năm

GET/api/stats/tan-suat-cap

Code Samples

Tần Suất Cặp - Thống kê cặp số (lộn)

GET/api/stats/lo-roi

Code Samples

Thống Kê Lô Rơi - Số về liên tiếp

GET/api/stats/ghep-xien

Code Samples

Ghép Xiên Tự Động - Gợi ý bộ số xiên 2, xiên 3

GET/api/stats/weekday

Code Samples

Thống Kê Thứ - Kết quả theo ngày trong tuần

Soi Cầu & Dự Đoán(11)

GET/api/soi-cau/bach-thu

Code Samples

Bạch Thủ Lô - 1 số chắc chắn nhất

GET/api/soi-cau/xien-2

Code Samples

Lô Xiên 2 - Cặp số dự đoán

GET/api/soi-cau/xien-3

Code Samples

Lô Xiên 3 - Bộ 3 số dự đoán

GET/api/soi-cau/de-dac-biet

Code Samples

Đề Đặc Biệt - Dự đoán 2 số cuối ĐB

GET/api/soi-cau/dan-de

Code Samples

Dàn Đề - Bộ 10/20/36 số

GET/api/soi-cau/pascal

Code Samples

Cầu Tam Giác Pascal

GET/api/soi-cau/nhay

Code Samples

Cầu Nháy (2-3 lần/ngày)

GET/api/soi-cau/cau-chay

Code Samples

Cầu Đang Chạy (liên tiếp nhiều ngày)

GET/api/soi-cau/ai-predict

Code Samples

AI Dự Đoán - Dự đoán dựa trên Machine Learning (LSTM)

GET/api/soi-cau/loai-bach-thu

Code Samples

Loại Trừ Bạch Thủ - Loại bỏ các số xác suất thấp

GET/api/soi-cau/song-thu

Code Samples

Song Thủ Lô - Cặp số song hành

Webhook & Thông Báo(3)

GET/api/user/webhooks

Code Samples

Lấy danh sách các Webhook đã cấu hình

POST/api/user/webhooks

Code Samples

Tạo mới hoặc cập nhật Webhook

WEBHOOKEvent: DRAW_COMPLETED

Code Samples

Thông báo khi có kết quả kỳ quay mới (Server gọi tới Client)

Hướng dẫn nhận Webhook

1. Quy trình hoạt động

Khi có kết quả xổ số mới hoặc các sự kiện quan trọng, hệ thống của chúng tôi sẽ gửi một request POST tới URL mà bạn đã cấu hình. Endpoint của bạn nên trả về status code 200 OK nhanh nhất có thể.

2. Xác thực Webhook (Bảo mật)

Nếu bạn đã cung cấp một Secret khi cấu hình Webhook, mọi request từ chúng tôi sẽ kèm theo header X-Webhook-Signature. Chữ ký này được tạo bằng cách sử dụng thuật toán HMAC-SHA256 với Secret và request body.

// Node.js Example Verification
const crypto = require('crypto');
const signature = req.headers['x-webhook-signature'];
const hmac = crypto.createHmac('sha256', YOUR_WEBHOOK_SECRET);
const digest = hmac.update(JSON.stringify(req.body)).digest('hex');

if (signature === digest) {
    // Request is authentic
}

Lưu ý

Hệ thống sẽ thử lại (retry) tối đa 3 lần nếu endpoint của bạn không trả về 2xx. Sau 3 lần thất bại liên tiếp, Webhook có thể bị tạm ngưng.

Rate Limits

Gói	Requests/Ngày	Rate Limit
FREE	100	10 req/phút
BASIC	1,000	60 req/phút
PRO	10,000	300 req/phút
ENTERPRISE	Unlimited	Custom

Error Codes

Code	Message	Mô tả
`400`	Bad Request	Request không hợp lệ
`401`	Unauthorized	API Key không hợp lệ
`403`	Forbidden	Không có quyền truy cập
`404`	Not Found	Resource không tồn tại
`429`	Too Many Requests	Vượt quá rate limit
`500`	Server Error	Lỗi server

Code Examples

Sao chép code mẫu để tích hợp nhanh vào dự án của bạn. Thay YOUR_API_KEY bằng API Key thực.

bash

curl -X GET "https://xosoapi.online/api/stats/hot-numbers?region=MB&limit=10" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

💡 Mẹo

• Luôn bảo mật API Key, không để lộ trong code frontend
• Sử dụng environment variables để lưu trữ API Key
• Xử lý lỗi và retry khi gặp rate limit (429)

🔥 API TesterLIVE

Test API trực tiếp với API Key của bạn. Xem kết quả realtime ngay tại đây!

API Key *

Chọn Endpoint

GET /api/stats/hot-numbers?region=MB&limit=10

🔒 Bảo mật

API Key chỉ được sử dụng để gọi API trực tiếp từ trình duyệt của bạn và không được lưu trữ hay gửi đến bất kỳ server nào khác.