Tuổi, can chi, mệnh API

Từ ngày sinh: năm âm lịch (tính từ Tết), can chi, con giáp, mệnh nạp âm, cung phi, tuổi mụ, màu hợp và các tuổi tam hợp, tứ hành xung.

GETPOSThttps://apibox.io.vn/v1/vn-zodiac
Tiện ích lập trình▶ Dùng thử online

API tuổi tính các thông tin truyền thống của năm sinh mà nhiều ứng dụng Việt Nam hiển thị: năm âm lịch (người sinh trước Tết thuộc năm âm trước, tính theo lịch âm), tên can chi (Canh Ngọ, Giáp Tý…), con giáp (12 con giáp Việt Nam có Mèo thay cho Thỏ), mệnh nạp âm (Lộ Bàng Thổ – “đất ven đường”), hành tương sinh, tương khắc cùng các màu hợp và màu nên tránh.

Khi có gender, API thêm cung phi theo Bát trạch (Khảm, Ly, Càn…), ngũ hành, hướng và nhóm Đông / Tây tứ mệnh; không có giới tính thì trả cả hai. Phản hồi còn có tuổi dương, tuổi mụ (tính từ 1 và cộng thêm mỗi khi qua Tết) và các tuổi tam hợp, tứ hành xung.

Đây là tín ngưỡng văn hoá, hữu ích cho tính năng cưới hỏi, phong thuỷ, quà tặng và giải trí; cách tính theo các bảng truyền thống phổ biến.

Tham số

TênVị tríKiểuBắt buộcMặc định
birth_datequery|bodystringkhôngNgày sinh YYYY-MM-DD (hoặc year=YYYY).
yearquery|bodynumberkhôngChỉ năm sinh âm lịch.
genderquery|bodystringkhôngmale / female (hoặc nam / nữ) để tính cung phi.

Ví dụ

curl "https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male" \
  -H "Authorization: Bearer YOUR_API_KEY"

Kết quả trả về

{
  "input": "1990-05-20",
  "solar_year": 1990,
  "lunar_year": 1990,
  "can_chi": "Canh Ngọ",
  "can": "Canh",
  "chi": "Ngọ",
  "con_giap": {
    "vi": "Ngựa",
    "en": "Horse"
  },
  "age": {
    "western": 36,
    "lunar": 37
  },
  "menh": {
    "nap_am": "Lộ Bàng Thổ",
    "meaning": "Đất ven đường",
    "element": "Thổ",
    "element_en": "Earth",
    "generated_by": "Hỏa",
    "generates": "Kim",
    "overcomes": "Thủy",
    "overcome_by": "Mộc",
    "lucky_colors": [
      "vàng",
      "nâu đất",
      "đỏ",
      "hồng",
      "cam",
      "tím"
    ],
    "colors_to_avoid": [
      "xanh lá"
    ]
  },
  "cung_phi": {
    "number": 1,
    "cung": "Khảm",
    "element": "Thủy",
    "direction": "Bắc",
    "group": "Đông tứ mệnh"
  },
  "compatible": {
    "tam_hop": [
      "Dần",
      "Tuất"
    ],
    "tu_hanh_xung": [
      "Tý",
      "Mão",
      "Dậu"
    ]
  },
  "disclaimer": "Traditional beliefs, for culture and entertainment."
}

Ứng dụng

  • Ứng dụng tử vi, lịch âm
  • Tính năng xem ngày cưới, tổ chức sự kiện
  • Lời chúc, gợi ý quà tặng cá nhân hoá
  • App bất động sản gợi ý hướng nhà theo cung phi

Hỏi đáp

Vì sao năm âm khác năm sinh?

Nếu sinh vào tháng 1, tháng 2 dương lịch trước Tết thì thuộc năm âm lịch trước đó (ví dụ 20/01/2000 → Kỷ Mão 1999).

Tuổi mụ là gì?

Cách tính tuổi truyền thống: 1 tuổi khi sinh ra, cộng thêm một tuổi mỗi dịp Tết, nên thường lớn hơn tuổi dương 1–2 tuổi.

Vì sao cần giới tính?

Cung phi (quẻ Bát trạch) tính khác nhau cho nam và nữ; mệnh nạp âm thì không phụ thuộc giới tính.

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í →