Get started
Quickstart in 5 minutes
From zero to first request — pick the language your team uses
1. Sign up and create a key
Create a free account, open Dashboard > API Keys, then press Create key. Copy the key when it appears; it is shown only once.
Sign up free →2. Make your first call
Use our flagship endpoint — Thai Calendar Day — bundling all 5 reuk systems in one request.
// Bun / Node 18+ — uses the native fetch
const res = await fetch('https://api.astrom8.com/api/v3/thai/calendar/day', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.ASTROM8_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
date: '2026-05-09',
birth_date: '1990-05-20',
birth_day_of_week: 'mon',
lat: 13.7563,
lng: 100.5018,
}),
})
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`)
const data = await res.json()
console.log(data.day_quality.label_th)3. Inspect the response
Every field carries Thai + English labels ready to render in your UI without mapping.
{
"day_quality": {
"score": 85,
"label_th": "มงคล",
"label_en": "Auspicious"
},
"thaksa": {
"position_th": "เจ้าชะตา",
"score": 5
},
"maha_thaksa": {
"today_position": {
"position_th": "เดช",
"score": 5
}
},
"reuk_bon": {
"nakshatra_th": "อนุราธา",
"class": 1,
"label_th": "ฤกษ์ดีเยี่ยม"
},
"dithi": {
"lunar_day": 12,
"label_th": "ฤกษ์ดี"
},
"wan_phra": false,
"pee_chong": false,
"request_id": "req_a1b2c3d4"
}4. Next steps
Read Authentication and Rate Limits, then explore the endpoint category that matches your use case.