Xem ngày tốt xấu API
Xem ngày tốt xấu theo lịch vạn niên: hoàng đạo, hắc đạo, 12 trực, 28 sao, ngày kỵ, tuổi xung, giờ hoàng đạo, chấm điểm cho cưới hỏi, khai trương.
API xem ngày áp dụng các quy tắc của lịch vạn niên truyền thống cho một ngày: can chi và ngày âm lịch, thần trực nhật trong 12 thần (hoàng đạo hay hắc đạo), trực trong 12 trực (kèm việc nên làm và nên tránh), sao trong nhị thập bát tú, các ngày kỵ quen thuộc (tam nương, nguyệt kỵ, sát chủ, thọ tử, Dương Công kỵ nhật), các tuổi xung với ngày và sáu giờ hoàng đạo.
Thêm activity (cuoi-hoi cưới hỏi, khai-truong khai trương, dong-tho động thổ, xuat-hanh xuất hành, nhap-trach nhập trạch, ky-ket ký kết, mua-xe mua xe, nhap-hoc nhập học) và năm sinh âm lịch birth_year để nhận score và kết luận verdict (tốt, bình thường, xấu) có tính đến việc cần làm và tuổi xung khắc. Với from / to (tối đa 366 ngày), API duyệt cả khoảng thời gian, only_good=true chỉ giữ ngày tốt và sort=score xếp theo điểm.
Tháng tính theo tiết khí cho hoàng đạo và trực, theo âm lịch cho các ngày kỵ, giống lịch in. Mỗi trường phái có khác biệt nhỏ: kết quả chỉ mang tính tham khảo văn hoá, không phải lời khuyên.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
date | query | string | không | YYYY-MM-DD (mặc định: hôm nay theo giờ Việt Nam). | |
from | query | string | không | Ngày bắt đầu khoảng cần xem (YYYY-MM-DD). | |
to | query | string | không | Ngày kết thúc (mặc định: from + 29 ngày; tối đa 366 ngày). | |
activity | query | string | không | cuoi-hoi, khai-truong, dong-tho, xuat-hanh, nhap-trach, ky-ket, mua-xe, nhap-hoc (bí danh tiếng Anh: wedding, opening, travel, moving…). | |
birth_year | query | number | không | Năm sinh âm lịch (1900–2100) để xét tuổi xung. | |
only_good | query | boolean | không | false | Khi xem khoảng: chỉ giữ ngày có kết luận “tốt”. |
sort | query | string | không | score: ngày điểm cao lên trước. | |
limit | query | number | không | 100 | Khi xem khoảng: số ngày tối đa trả về (1–366). |
tho_tu | query | string | không | chi: tính thọ tử chỉ theo địa chi (theo một số cuốn lịch). |
Ví dụ
curl "https://apibox.io.vn/v1/vn-good-days?date=2026-11-11&activity=khai-truong&birth_year=1990" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-good-days?date=2026-11-11&activity=khai-truong&birth_year=1990', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-good-days?date=2026-11-11&activity=khai-truong&birth_year=1990",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-good-days?date=2026-11-11&activity=khai-truong&birth_year=1990');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"date": "2026-11-11",
"weekday": "Wednesday",
"weekday_vi": "Thứ Tư",
"lunar": {
"day": 3,
"month": 10,
"year": 2026,
"leap": false,
"text": "03/10/2026"
},
"can_chi_day": "Kỷ Sửu",
"hoang_dao": {
"than": "Ngọc Đường",
"type": "hoàng đạo",
"good": true
},
"truc": {
"name": "Mãn",
"good_for": "cầu tài, cúng tế, giao dịch, nhập kho, khai trương",
"bad_for": "nhậm chức, kiện tụng, an táng"
},
"sao": {
"name": "Chẩn",
"good": true
},
"bad_days": [
{
"name": "Tam nương",
"severity": "hard",
"note": "Ngày 3, 7, 13, 18, 22, 27 âm lịch"
}
],
"clashing_ages": [
"Quý Mùi",
"Ất Mùi"
],
"clashing_chi": "Mùi",
"lucky_hours": [
{
"chi": "Dần",
"from": "03:00",
"to": "05:00"
},
{
"chi": "Mão",
"from": "05:00",
"to": "07:00"
},
{
"chi": "Tỵ",
"from": "09:00",
"to": "11:00"
},
{
"chi": "Thân",
"from": "15:00",
"to": "17:00"
},
{
"chi": "Tuất",
"from": "19:00",
"to": "21:00"
},
{
"chi": "Hợi",
"from": "21:00",
"to": "23:00"
}
],
"personal": {
"birth_year": 1990,
"can_chi": "Canh Ngọ",
"clash": null
},
"activity": {
"code": "khai-truong",
"vi": "Khai trương",
"en": "Business opening",
"truc_fit": "good"
},
"score": 2,
"verdict": "xấu",
"note": "Traditional Vietnamese almanac rules (hoàng đạo by solar month / tiết khí, trực by tiết khí, ngày kỵ by lunar month). For cultural reference only; sources and schools differ."
}
Ứng dụng
- Tính năng “chọn ngày đẹp” cho ứng dụng cưới hỏi, sự kiện
- Gợi ý ngày khai trương, chuyển nhà trong ứng dụng bất động sản, bán lẻ
- Widget lịch vạn niên hằng ngày kèm giờ hoàng đạo
- Lịch đánh dấu ngày tam nương, nguyệt kỵ
Hỏi đáp
Vì sao các cuốn lịch đôi khi khác nhau?
Mỗi trường phái dùng bảng hơi khác (ví dụ thọ tử tính theo can chi hay chỉ theo chi: tho_tu=chi). API theo các quy tắc phổ biến nhất và ghi rõ từng quy tắc trong kết quả.
birth_year là năm dương lịch?
Là năm sinh âm lịch: người sinh tháng 1/1991 trước Tết là tuổi Canh Ngọ (1990).
Điểm được tính thế nào?
Hoàng đạo +2 / hắc đạo −2, sao tốt +1 / sao xấu −1, trực hợp hay kỵ với việc cần làm ±2, trừ điểm cho ngày kỵ và tuổi xung.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.