Vietnamese Zodiac Calculator
From a birth date: lunar year (from Tết), can chi, zodiac animal, nạp âm element (mệnh), cung phi, lunar age, lucky colours and compatible signs.
Result
Press “Run” to see the result.
The Vietnamese zodiac API computes the traditional attributes of a birth year that many Vietnamese apps show: the lunar year (people born before Tết belong to the previous year, computed with the lunar calendar), the can chi name (Canh Ngọ, Giáp Tý…), the animal (the Vietnamese zodiac has the Cat instead of the Rabbit), the nạp âm destiny element (Lộ Bàng Thổ – “road-side earth”), and its generating and overcoming elements with associated colours.
With gender it adds the cung phi of the Eight Mansions (Khảm, Ly, Càn…), its element, direction and East / West group; without it both are returned. The response also gives the western age and the lunar age (tuổi mụ, counted from 1 and incremented at Tết), and the signs in tam hợp (harmony) and tứ hành xung (conflict).
These are cultural beliefs, useful for wedding, feng-shui, gift and entertainment features; the calculations follow the common traditional tables.
Use this in your code
curl "https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male', {
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-zodiac?birth_date=1990-05-20&gender=male",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));API documentation → Get a free API key
FAQ
Why is my lunar year different from my birth year?
If you were born in January or February before Tết, you belong to the previous lunar year (e.g. 20/01/2000 → Kỷ Mão 1999).
What is tuổi mụ?
The traditional Vietnamese age: 1 at birth, plus one at each lunar new year, so usually 1–2 more than the western age.
Why does gender matter?
The cung phi (Eight Mansions trigram) is computed differently for men and women; the nạp âm element does not depend on gender.