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.

GEThttps://apibox.io.vn/v1/vn-good-days
Dữ liệu & JSON▶ Dùng thử online

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ênVị tríKiểuBắt buộcMặc định
datequerystringkhôngYYYY-MM-DD (mặc định: hôm nay theo giờ Việt Nam).
fromquerystringkhôngNgày bắt đầu khoảng cần xem (YYYY-MM-DD).
toquerystringkhôngNgày kết thúc (mặc định: from + 29 ngày; tối đa 366 ngày).
activityquerystringkhôngcuoi-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_yearquerynumberkhôngNăm sinh âm lịch (1900–2100) để xét tuổi xung.
only_goodquerybooleankhôngfalseKhi xem khoảng: chỉ giữ ngày có kết luận “tốt”.
sortquerystringkhôngscore: ngày điểm cao lên trước.
limitquerynumberkhông100Khi xem khoảng: số ngày tối đa trả về (1–366).
tho_tuquerystringkhôngchi: 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"

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

Bắt đầu với 1.000 request miễn phí mỗi tháng. Nhận API key miễn phí →