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://astro-api-1qnc.onrender.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
import requests
url = "https://astro-api-1qnc.onrender.com/api/v1/chinese/today"
headers = {
"x-api-key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())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