Back to Docs
Current Pillars (Today)
Current Pillars (Today)
GET
/api/v1/chinese/todayGet the current Year, Month, Day, and Hour pillars for the present moment. A fast, no-parameters endpoint perfect for daily energy displays and quick references.
Full URL
https://api.freeastroapi.com/api/v1/chinese/todayCommon Use Cases
Daily Energy Check
Display today's elemental energies on a dashboard
Quick Reference
Show current year/month/day pillars without full calculation
Compatibility Preview
Compare current pillars with a user's natal chart
Content Generation
Create daily horoscope-style content based on pillars
Request Parameters
This is a GET request with no parameters. Simply include your API key in the header. The response is based on UTC time at the moment of the request.
Sample Code
curl -X GET "https://api.freeastroapi.com/api/v1/chinese/today" \
-H "x-api-key: YOUR_API_KEY"Response Data
{
"timestamp": "2024-12-31T10:30:00+00:00",
"date": {
"year": 2024,
"month": 12,
"day": 31
},
"pillars": [
{
"label": "year",
"gan": "甲",
"zhi": "辰",
"gan_pinyin": "jiǎ",
"zhi_pinyin": "chén",
"gan_zhi": "甲辰",
"element": {
"stem": "Wood",
"branch": "Earth"
}
},
{
"label": "month",
"gan": "丙",
"zhi": "子",
"gan_pinyin": "bǐng",
"zhi_pinyin": "zǐ",
"gan_zhi": "丙子",
"element": {
"stem": "Fire",
"branch": "Water"
}
},
{
"label": "day",
"gan": "戊",
"zhi": "寅",
"gan_pinyin": "wù",
"zhi_pinyin": "yín",
"gan_zhi": "戊寅",
"element": {
"stem": "Earth",
"branch": "Wood"
}
},
{
"label": "hour",
"gan": "甲",
"zhi": "巳",
"gan_pinyin": "jiǎ",
"zhi_pinyin": "sì",
"gan_zhi": "甲巳",
"element": {
"stem": "Wood",
"branch": "Fire"
}
}
],
"day_master": {
"stem": "戊",
"pinyin": "wù",
"element": "Earth",
"polarity": "Yang"
},
"elements_today": {
"Wood": 2,
"Fire": 2,
"Earth": 2,
"Metal": 0,
"Water": 1
}
}📝 Notes
- Hour pillar updates every 2 Chinese hours (approx. every 2 clock hours)
- Day pillar changes at 23:00 (11 PM) local mean time, not midnight
- Response is based on UTC; adjust for local timezone in your application