当前四柱 API

GET/api/v1/chinese/today

该接口返回当前时刻的年柱、月柱、日柱和时柱。这是一个快速、无参数的 endpoint，非常适合每日能量展示和快速参考。

完整 URL

https://api.freeastroapi.com/api/v1/chinese/today

常见用例

每日能量检查

在仪表盘展示今天的五行能量。

快速参考

无需完整计算即可显示当前年/月/日柱。

兼容性预览

将当前四柱与用户的 natal chart 对比。

内容生成

基于四柱创建 daily horoscope-style 内容。

请求参数

这是一个没有参数的 GET 请求。只需要在 header 中提供 API key。响应基于请求时刻的 UTC 时间。

调用示例

curl -X GET "https://api.freeastroapi.com/api/v1/chinese/today" \
 -H "x-api-key: YOUR_API_KEY"

响应数据

{
  "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
  }
}

📝 说明

时柱每两个中国时辰更新一次，约等于每两个钟表小时。
日柱按地方平太阳时在 23:00（晚上 11 点）切换，而不是午夜。
响应基于 UTC；请在应用中按本地时区调整展示。