老黄历日历详版API接口文档 GET / POST 娱乐测试

老黄历API提供指定日期的黄历信息查询，包含干支、宜忌、冲煞、时辰吉凶等完整数据。（注意：免责声明见接口详情）

请求 GET / POST返回 application/json1 积分 / 次上线 2026-09-24 14:57:41

老黄历API提供指定日期的黄历信息查询，包含干支、宜忌、冲煞、时辰吉凶等完整数据。（注意：免责声明见接口详情）

1 积分 / 次调用次数: 3正常运行KEY 必填
接口信息
GET / POST api.souxiaocha.com/apis/gateway?api=almanac
方法
GET / POST
分类
娱乐测试
计费
1 积分 / 次
KEY
KEY 必填
调用
3
QPM
不限制
鉴权
Query 参数、Header(X-API-Key)
作者
—

老黄历日历详版接口信息

接口地址：
https://api.souxiaocha.com/apis/gateway?api=almanac
请求方式：
GET / POST
返回格式：
application/json

调用统计

3总调用次数
请求示例 · GET
GET https://api.souxiaocha.com/apis/gateway?api=almanac

apikey=你的API密钥&date=请填写date

GET 参数放在查询字符串中。参数值请替换为实际有效值。

老黄历日历详版请求参数

参数名类型必填说明示例
datestring否查询日期，格式YYYY-MM-DD，默认当天
返回示例
{"success":true,"data":{"date":"2026-08-05","solar":{"year":"2026","month":"8","day":"5","week":"星期三"},"lunar":{"year":"2026","month":6,"day":23,"display":"农历六月廿三"},"ganzhi":{"year":"丙午","month":"己酉","day":"辛亥"},"animal":"马","constellation":"狮子座","jieqi":"大暑（月建：未）","star28":"参宿","jianchu":"定","zhishen":{"name":"明堂","type":"黄道"},"kongming":"友引","zibai":"七赤","jishen":["明堂","天德","月德"],"xiongsha":["五虚"],"yiji":{"yi":["祭祀","祈福","出行","建造","纳采","订盟","会亲友","入学","求嗣","开光","解除","理发","起基","交易","立券","纳财","造仓","栽种","纳畜","牧养"],"ji":["嫁娶","入宅","安葬","安床","作灶","出火","置产"]},"chongsha":{"animal":"蛇","zhi":"巳","sha":"西"},"caishen":"财神：正东、福神：西北、喜神：西南","taishen":"仓库炉房内西北","pengzu":"辛不合酱 亥不嫁娶","rilu":"酉命互禄","wuxing":"金","festivals":[],"shichen":[{"hour":0,"hourName":"子时","timeRange":"00:00-00:59","ganzhi":"戊子","zhishen":"白虎","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","出行","求财","祭祀","求嗣","订婚","嫁娶","开市"],"chong":"冲马","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":1,"hourName":"丑时","timeRange":"01:00-02:59","ganzhi":"己丑","zhishen":"玉堂","zhishenType":"黄道","yi":["修造","盖屋","移徙","安床"],"ji":["祭祀","祈福","斋醮","开光"],"chong":"冲羊","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":2,"hourName":"寅时","timeRange":"03:00-04:59","ganzhi":"庚寅","zhishen":"天牢","zhishenType":"黑道","yi":["小事可为"],"ji":["诸事不宜","赴任","词讼","动土"],"chong":"冲猴","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":3,"hourName":"卯时","timeRange":"05:00-06:59","ganzhi":"辛卯","zhishen":"玄武","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","出行","修造","动土","求嗣","嫁娶","移徙","入宅"],"chong":"冲鸡","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":4,"hourName":"辰时","timeRange":"07:00-08:59","ganzhi":"壬辰","zhishen":"司命","zhishenType":"黄道","yi":["祈福","求嗣","订婚","嫁娶","安神"],"ji":["上梁","盖屋","入殓"],"chong":"冲狗","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":5,"hourName":"巳时","timeRange":"09:00-10:59","ganzhi":"癸巳","zhishen":"勾陈","zhishenType":"黑道","yi":["无"],"ji":["日时相冲，诸事不宜"],"chong":"冲猪","sha":"煞东","isRiPo":true,"isRiPoDesc":"日时相冲，诸事不宜"},{"hour":6,"hourName":"午时","timeRange":"11:00-12:59","ganzhi":"甲午","zhishen":"青龙","zhishenType":"黄道","yi":["祈福","订婚","嫁娶","安床"],"ji":["上梁","盖屋","入殓"],"chong":"冲鼠","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":7,"hourName":"未时","timeRange":"13:00-14:59","ganzhi":"乙未","zhishen":"明堂","zhishenType":"黄道","yi":["祭祀","斋醮","酬神","修造","作灶"],"ji":["赴任","词讼"],"chong":"冲牛","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":8,"hourName":"申时","timeRange":"15:00-16:59","ganzhi":"丙申","zhishen":"天刑","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","词讼","祈福","求嗣","嫁娶","移徙","入宅","开市"],"chong":"冲虎","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":9,"hourName":"酉时","timeRange":"17:00-18:59","ganzhi":"丁酉","zhishen":"朱雀","zhishenType":"黑道","yi":["小事可为"],"ji":["祭祀","祈福","斋醮","酬神","求嗣","订婚","嫁娶","修造"],"chong":"冲兔","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":10,"hourName":"戌时","timeRange":"19:00-20:59","ganzhi":"戊戌","zhishen":"金匮","zhishenType":"黄道","yi":["修造","动土","开市","求财"],"ji":[],"chong":"冲龙","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":11,"hourName":"亥时","timeRange":"21:00-22:59","ganzhi":"己亥","zhishen":"天德","zhishenType":"黄道","yi":["祭祀","祈福","斋醮","酬神","求嗣"],"ji":[],"chong":"冲蛇","sha":"煞西","isRiPo":false,"isRiPoDesc":""}]},"generated_at":"2026-09-23 15:43:37"}

详细文档

老黄历日历详版 API 接口文档

接口描述

老黄历API提供指定日期的黄历信息查询，包含干支、宜忌、冲煞、时辰吉凶等完整数据。（注意：免责声明见接口详情）

功能特性

  • 老黄历API提供指定日期的黄历信息查询，包含干支、宜忌、冲煞、时辰吉凶等完整数据。（注意：免责声明见接口详情）
  • 返回 JSON 结构化数据，便于程序解析
  • 支持 GET / POST 两种调用方式
  • 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

https://api.souxiaocha.com/apis/gateway?api=almanac

请求方式

GET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）

鉴权方式

调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：

  • URL 参数：key=SK-你的密钥
  • 或请求头：X-API-Key: SK-你的密钥

请求参数

参数名 类型 必填 描述
date string 否 查询日期，格式YYYY-MM-DD，默认当天

请求参数 (JSON格式)

[
  {"name": "date", "type": "string", "required": false, "description": "查询日期，格式YYYY-MM-DD，默认当天"}
]

响应格式

JSON 格式响应

成功返回示例：

{"success":true,"data":{"date":"2026-08-05","solar":{"year":"2026","month":"8","day":"5","week":"星期三"},"lunar":{"year":"2026","month":6,"day":23,"display":"农历六月廿三"},"ganzhi":{"year":"丙午","month":"己酉","day":"辛亥"},"animal":"马","constellation":"狮子座","jieqi":"大暑（月建：未）","star28":"参宿","jianchu":"定","zhishen":{"name":"明堂","type":"黄道"},"kongming":"友引","zibai":"七赤","jishen":["明堂","天德","月德"],"xiongsha":["五虚"],"yiji":{"yi":["祭祀","祈福","出行","建造","纳采","订盟","会亲友","入学","求嗣","开光","解除","理发","起基","交易","立券","纳财","造仓","栽种","纳畜","牧养"],"ji":["嫁娶","入宅","安葬","安床","作灶","出火","置产"]},"chongsha":{"animal":"蛇","zhi":"巳","sha":"西"},"caishen":"财神：正东、福神：西北、喜神：西南","taishen":"仓库炉房内西北","pengzu":"辛不合酱 亥不嫁娶","rilu":"酉命互禄","wuxing":"金","festivals":[],"shichen":[{"hour":0,"hourName":"子时","timeRange":"00:00-00:59","ganzhi":"戊子","zhishen":"白虎","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","出行","求财","祭祀","求嗣","订婚","嫁娶","开市"],"chong":"冲马","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":1,"hourName":"丑时","timeRange":"01:00-02:59","ganzhi":"己丑","zhishen":"玉堂","zhishenType":"黄道","yi":["修造","盖屋","移徙","安床"],"ji":["祭祀","祈福","斋醮","开光"],"chong":"冲羊","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":2,"hourName":"寅时","timeRange":"03:00-04:59","ganzhi":"庚寅","zhishen":"天牢","zhishenType":"黑道","yi":["小事可为"],"ji":["诸事不宜","赴任","词讼","动土"],"chong":"冲猴","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":3,"hourName":"卯时","timeRange":"05:00-06:59","ganzhi":"辛卯","zhishen":"玄武","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","出行","修造","动土","求嗣","嫁娶","移徙","入宅"],"chong":"冲鸡","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":4,"hourName":"辰时","timeRange":"07:00-08:59","ganzhi":"壬辰","zhishen":"司命","zhishenType":"黄道","yi":["祈福","求嗣","订婚","嫁娶","安神"],"ji":["上梁","盖屋","入殓"],"chong":"冲狗","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":5,"hourName":"巳时","timeRange":"09:00-10:59","ganzhi":"癸巳","zhishen":"勾陈","zhishenType":"黑道","yi":["无"],"ji":["日时相冲，诸事不宜"],"chong":"冲猪","sha":"煞东","isRiPo":true,"isRiPoDesc":"日时相冲，诸事不宜"},{"hour":6,"hourName":"午时","timeRange":"11:00-12:59","ganzhi":"甲午","zhishen":"青龙","zhishenType":"黄道","yi":["祈福","订婚","嫁娶","安床"],"ji":["上梁","盖屋","入殓"],"chong":"冲鼠","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":7,"hourName":"未时","timeRange":"13:00-14:59","ganzhi":"乙未","zhishen":"明堂","zhishenType":"黄道","yi":["祭祀","斋醮","酬神","修造","作灶"],"ji":["赴任","词讼"],"chong":"冲牛","sha":"煞西","isRiPo":false,"isRiPoDesc":""},{"hour":8,"hourName":"申时","timeRange":"15:00-16:59","ganzhi":"丙申","zhishen":"天刑","zhishenType":"黑道","yi":["小事可为"],"ji":["赴任","词讼","祈福","求嗣","嫁娶","移徙","入宅","开市"],"chong":"冲虎","sha":"煞南","isRiPo":false,"isRiPoDesc":""},{"hour":9,"hourName":"酉时","timeRange":"17:00-18:59","ganzhi":"丁酉","zhishen":"朱雀","zhishenType":"黑道","yi":["小事可为"],"ji":["祭祀","祈福","斋醮","酬神","求嗣","订婚","嫁娶","修造"],"chong":"冲兔","sha":"煞东","isRiPo":false,"isRiPoDesc":""},{"hour":10,"hourName":"戌时","timeRange":"19:00-20:59","ganzhi":"戊戌","zhishen":"金匮","zhishenType":"黄道","yi":["修造","动土","开市","求财"],"ji":[],"chong":"冲龙","sha":"煞北","isRiPo":false,"isRiPoDesc":""},{"hour":11,"hourName":"亥时","timeRange":"21:00-22:59","ganzhi":"己亥","zhishen":"天德","zhishenType":"黄道","yi":["祭祀","祈福","斋醮","酬神","求嗣"],"ji":[],"chong":"冲蛇","sha":"煞西","isRiPo":false,"isRiPoDesc":""}]},"generated_at":"2026-09-23 15:43:37"}

失败返回示例：

{"success":false,"error":"invalid_date","message":"日期格式错误，请使用YYYY-MM-DD格式"}

返回参数说明

参数名 类型 说明
data.date string 查询日期（YYYY-MM-DD）
data.solar.year integer 公历年份
data.solar.month integer 公历月份
data.solar.day integer 公历日期
data.solar.week string 星期（星期一~星期日）
data.lunar.year integer 农历年份
data.lunar.month integer 农历月份（负数表示闰月）
data.lunar.day integer 农历日期
data.lunar.display string 农历显示文本（如"农历六月十六"）
data.ganzhi.year string 年干支（如"丙午"）
data.ganzhi.month string 月干支（如"乙未"）
data.ganzhi.day string 日干支（如"乙亥"）
data.animal string 生肖（鼠/牛/虎/兔/龙/蛇/马/羊/猴/鸡/狗/猪）
data.constellation string 星座（白羊座~双鱼座）
data.wuxing string 当日五行属性（金/木/水/火/土）
data.jieqi string 当前所处节气
data.star28 string 二十八星宿（角/亢/氐/房/心/尾/箕...）
data.jianchu string 十二建除（建/除/满/平/定/执/破/危/成/收/开/闭）
data.zhishen.name string 值神名称（青龙/明堂/天刑/朱雀/金匮/天德/白虎/玉堂/天牢/玄武/司命/勾陈）
data.zhishen.type string 值神类型（"黄道"或"黑道"）
data.kongming string 孔明六耀（先胜/先负/友引/佛灭/大安/赤口）
data.yiji.yi array 宜事宜项列表
data.yiji.ji array 忌事宜项列表
data.chongsha.animal string 冲煞生肖
data.chongsha.zhi string 冲煞地支
data.chongsha.sha string 煞方（东/南/西/北）
data.caishen string 财神、福神、喜神方位
data.taishen string 胎神方位
data.pengzu string 彭祖百忌
data.rilu string 日禄信息
data.festivals array 节日列表（包含阳历节日和农历节日）
data.shichen[].hour integer 时辰序号（0=子时, 1=丑时, ..., 11=亥时）
data.shichen[].hourName string 时辰名称（子时/丑时/寅时...）
data.shichen[].timeRange string 时间范围（如"07:00-08:59"）
data.shichen[].ganzhi string 时辰干支（如"丙子"）
data.shichen[].zhishen string 时辰值神名称
data.shichen[].zhishenType string 时辰值神类型（"黄道"或"黑道"）
data.shichen[].yi array 时辰宜事
data.shichen[].ji array 时辰忌事
data.shichen[].chong string 时辰冲煞生肖（如"冲马"）
data.shichen[].sha string 时辰煞方（如"煞南"）
data.shichen[].isRiPo boolean 是否日时相冲（true=日时相冲，诸事不宜）
data.shichen[].isRiPoDesc string 日时相冲说明文字
generated_at string 数据生成时间（YYYY-MM-DD HH:MM:SS）
data.zibai array 紫白九星
data.jishen array 吉神列表
data.xiongsha array 凶煞列表

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=almanac?key=SK-你的密钥&date=2026-09-24"

错误响应

上游业务级错误：

code msg 描述
400 invalid_date 日期格式错误
405 method_not_allowed 仅支持GET

平台级错误（errcode）：11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。

失败时请以响应体中的 code / errcode 与 msg 判断。

注意事项

  • 本接口为平台代理的聚合数据服务，数据与稳定性以上游服务为准
  • 涉及命理、测算类内容（如有）仅供娱乐参考，不构成任何现实建议
  • 请合理控制调用频率，避免高频恶意调用触发风控
  • 密钥请妥善保管，勿在公开代码或前端页面中暴露

开发时间

2026-09-24