Vietnamese Lunar Calendar API

Convert solar ⇄ Vietnamese lunar dates (âm lịch) with leap months, Can Chi, zodiac, solar terms, lucky hours and lunar holidays such as Tết. Years 1800–2199.

Parameters

Example

curl "https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17', {
  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/lunar-calendar?date=2026-02-17",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/lunar-calendar?date=2026-02-17');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "solar": {
    "date": "2026-02-17",
    "weekday": "Tuesday",
    "weekday_vi": "Thứ Ba"
  },
  "lunar": {
    "day": 1,
    "month": 1,
    "year": 2026,
    "leap": false,
    "text": "01/01/2026",
    "month_length": 30,
    "month_start": "2026-02-17",
    "leap_month_of_year": null
  },
  "can_chi_day": "Nhâm Tuất",
  "holiday": {
    "vi": "Tết Nguyên Đán",
    "en": "Lunar New Year (Tết)"
  },
  "can_chi": {
    "year": "Bính Ngọ",
    "month": "Canh Dần",
    "day": "Nhâm Tuất",
    "first_hour": "Canh Tý"
  },
  "zodiac": {
    "vi": "Ngựa",
    "en": "Horse"
  },
  "solar_term": {
    "vi": "Lập xuân",
    "en": "Start of Spring"
  },
  "lucky_hours": [
    {
      "chi": "Dần",
      "from": "03:00",
      "to": "05:00"
    },
    {
      "chi": "Thìn",
      "from": "07:00",
      "to": "09:00"
    },
    {
      "chi": "Tỵ",
      "from": "09:00",
      "to": "11:00"
    },
    {
      "chi": "Thân",
      "from": "15:00",
      "to": "17:00"
    },
    {
      "chi": "Dậu",
      "from": "17:00",
      "to": "19:00"
    },
    {
      "chi": "Hợi",
      "from": "21:00",
      "to": "23:00"
    }
  ],
  "julian_day": 2461089,
  "first_or_full_moon": "mùng 1"
}

Use cases

• Show the lunar date next to the solar date in calendar and booking apps
• Schedule reminders for death anniversaries (đám giỗ) and lunar holidays every year
• Plan Tết and Mid-Autumn campaigns in e-commerce
• Print monthly calendars with lunar dates and holidays

FAQ

Related APIs