1912-2100年黄历(万年历)运势等信息查询。按年月日查询农历、星座、生肖、胎神、喜神、五行、冲、煞、吉日、值日天神、凶神、吉神宜趋、财神、喜神、福神、岁次、宜、忌、星期,吉时与吉神凶煞等黄历信息。
接口ID 47
请求方式 GET/POST
返回格式 JSON
HTTP/HTTPS 支持
接口价格 低至¥0.002/次
接口地址 https://api.yuanxiapi.cn/api/
参数说明 获取秘钥
| 参数 | 必填 | 说明 | 
|---|---|---|
| id | 是 | 接口ID | 
| key | 是 | 对接秘钥 | 
| year | 是 | 年 | 
| month | 是 | 月 | 
| day | 是 | 日 | 
返回参数
| 名称 | 说明 | ||
|---|---|---|---|
| year | 年 | ||
| month | 月 | ||
| day | 日 | ||
| yangli | 阳历日期 | ||
| nongli | 农历日期 | ||
| week | 周几 | ||
| emonth | 英文月 | ||
| eweek | 英文周几 | ||
| star | 星座 | ||
| shengxiao | 生肖 | ||
| wuxing | 五行 | ||
| taishen | 胎神 | ||
| chong | 冲 | ||
| sha | 煞 | ||
| jiri | 吉日 | ||
| zhiri | 值日天神 | ||
| xiongshen | 凶神 | ||
| jishenyiqu | 吉神宜趋 | ||
| caishen | 财神 | ||
| xishen | 喜神 | ||
| fushen | 福神 | ||
| suici | 岁次 | ||
| yi | 宜 | ||
| ji | 忌 | ||
| jishi | 吉时数组 | ||
| jishenxiongsha | 吉神凶煞数组 | ||
| code | 200:成功; 计费 | ||
| user_info | 用户信息; zid:用户ID; cost:单价;rmb:余额; login_time:最近登录; | ||
返回示例
{
    "code": 200,
    "msg": "success",
    "data": {
        "year": "2025",
        "month": "7",
        "day": "4",
        "yangli": "公元2025年07月04日",
        "nongli": "农历二〇二五年六月初十",
        "week": "五",
        "emonth": "July",
        "eweek": "FRIDAY",
        "star": "巨蟹座",
        "shengxiao": "蛇",
        "wuxing": "山头火",
        "taishen": "门鸡栖外西南",
        "chong": "冲(戊辰)龙",
        "sha": "煞北",
        "jiri": null,
        "zhiri": "天刑(黑道日)",
        "xiongshen": "狱日 死气 官符 临日 天刑 五鬼",
        "jishenyiqu": "七圣 神在 天仓 三合 普护 时阴 不将",
        "caishen": "东北",
        "xishen": "东北",
        "fushen": "正北",
        "suici": [
            "乙巳年",
            "壬午月",
            "甲戌日"
        ],
        "yi": [
            "嫁娶",
            "纳采",
            "祭祀",
            "祈福",
            "出行",
            "立券",
            "移徙",
            "入宅",
            "动土",
            "破土",
            "安葬"
        ],
        "ji": [
            "开光",
            "作灶",
            "造屋",
            "架马",
            "开仓"
        ],
        "jishi": {
            "zi": {
                "shizhu": "甲子",
                "shijian": "23:00:00-0:59:59",
                "shichong": "冲马",
                "jixiong": "天牢(凶)",
                "jishen": "无",
                "xiongshen": "天牢"
            },
            "chou": {
                "shizhu": "乙丑",
                "shijian": "1:00:00-2:59:59",
                "shichong": "冲羊",
                "jixiong": "玄武(凶)",
                "jishen": "天乙贵人",
                "xiongshen": "玄武"
            },
            "yin": {
                "shizhu": "丙寅",
                "shijian": "3:00:00-4:59:59",
                "shichong": "冲猴",
                "jixiong": "司命(吉)",
                "jishen": "司命日禄喜神福星贵人",
                "xiongshen": "无"
            },
            "mao": {
                "shizhu": "丁卯",
                "shijian": "5:00:00-6:59:59",
                "shichong": "冲鸡",
                "jixiong": "勾陈(凶)",
                "jishen": "日合",
                "xiongshen": "勾陈"
            },
            "cheng": {
                "shizhu": "戊辰",
                "shijian": "7:00:00-8:59:59",
                "shichong": "冲狗",
                "jixiong": "青龙(吉)",
                "jishen": "青龙",
                "xiongshen": "日破"
            },
            "si": {
                "shizhu": "己巳",
                "shijian": "9:00:00-10:59:59",
                "shichong": "冲猪",
                "jixiong": "明堂(吉)",
                "jishen": "明堂文昌贵人",
                "xiongshen": "无"
            },
            "wu": {
                "shizhu": "庚午",
                "shijian": "11:00:00-12:59:59",
                "shichong": "冲鼠",
                "jixiong": "天刑(凶)",
                "jishen": "无",
                "xiongshen": "天刑"
            },
            "wei": {
                "shizhu": "辛未",
                "shijian": "13:00:00-14:59:59",
                "shichong": "冲牛",
                "jixiong": "朱雀(凶)",
                "jishen": "天乙贵人",
                "xiongshen": "朱雀日刑"
            },
            "shen": {
                "shizhu": "壬申",
                "shijian": "15:00:00-16:59:59",
                "shichong": "冲虎",
                "jixiong": "金匮(吉)",
                "jishen": "金匮日马",
                "xiongshen": "无"
            },
            "you": {
                "shizhu": "癸酉",
                "shijian": "17:00:00-18:59:59",
                "shichong": "冲兔",
                "jixiong": "天德(吉)",
                "jishen": "天德天官贵人",
                "xiongshen": "日害"
            },
            "xu": {
                "shizhu": "甲戌",
                "shijian": "19:00:00-20:59:59",
                "shichong": "冲龙",
                "jixiong": "白虎(凶)",
                "jishen": "无",
                "xiongshen": "白虎"
            },
            "hai": {
                "shizhu": "乙亥",
                "shijian": "21:00:00-22:59:59",
                "shichong": "冲蛇",
                "jixiong": "玉堂(吉)",
                "jishen": "玉堂",
                "xiongshen": "无"
            },
            "ut": "2024-06-04 10:34:13",
            "msg": "查询成功"
        },
        "jishenxiongsha": {
            "niankongwang": "寅卯",
            "nianqisha": "亥",
            "niansansha": "东 三煞寅卯辰 甲乙坐煞",
            "yuekongwang": "申酉",
            "yueqisha": "子",
            "yuesansha": "北 三煞亥子丑 壬癸坐煞",
            "rikongwang": "申酉",
            "riqisha": "辰",
            "risansha": "北 三煞亥子丑 壬癸坐煞",
            "xishen": "东北",
            "yueling": "壬午",
            "rilu": "寅命互禄",
            "fushen": "正北",
            "yuezhi": "午火",
            "niantaisui": "吴遂",
            "caishen": "东北",
            "zhongdong": "季夏",
            "taisuiwei": "东南",
            "yangguishen": "西南",
            "yuexiang": "宵月",
            "suipowei": "西北",
            "yinguishen": "东北",
            "wuhou": "半夏生",
            "fantaisui": "蛇、猪、虎、猴",
            "yjgx": "水山蹇",
            "tjjs": "寅,巳,亥",
            "jiuxing": "八白太阴土星(吉)",
            "esbx": "北方牛宿牛金牛(凶)",
            "zhiri12": "定执位 — 吉:俗称“小黄道日”。吉。依古籍观点,此日宜晏饮、协议,忌医疗、诉讼及选将出师。晏饮是为了固定某种关系和达成某种共识,协议则是对双方的约定,故“定”日宜晏饮、协议;医疗、诉讼和出师则需随机应变,墨守定规的做法是注定要以失败而告终的,故“定”日忌医疗、诉讼和出师。 诗云: 定可魁货及安床,结婚合和百代昌;安葬平基亦可用,不宜见官说短长。 修造用之相无虑,粮解逢之都不良;入宅作灶莫大意,如有紫薇亦无妨。",
            "zhishen12": "天刑 — 凶:俗称“大黑道日”。古籍云:天刑星,利于出师,战无不克,其它动作谋为皆不宜用,大忌词讼。",
            "liuyao": "佛灭 — 凶:依古籍观点,寓意万事化凶。也作弘灭,大凶之日,诸事不宜。 六曜,又称孔明六曜星、小六壬,是中国传统历法中的一种注文。后来传至日本,并于当地流行,而在中国影响日渐式微。",
            "ut": "2024-06-04 10:34:13",
            "msg": "查询成功"
        }
    },
    "user_info": {
        "zid": "217",
        "rmb": "992.85342",
        "login_time": "2025-08-17 22:40:38"
    }
}
   服务级错误码(code)
| 错误码 | 说明 | 
|---|---|
| 201 | 请求参数错误 | 
| 202 | 查询失败 | 
| 203 | 请求错误 | 
| 204 | 查无结果 | 
系统级错误码(error_code)
| 错误码 | 说明 | 
|---|---|
| 101 | 错误的请求KEY | 
| 102 | 被禁止的KEY | 
| 103 | 被禁止的IP | 
| 104 | 请求超过次数限制 | 
| 105 | 此IP请求超过限制 | 
| 106 | 未知的请求源 | 
| 107 | 接口维护 | 
| 108 | 余额不足 | 
| 109 | 未完成认证 | 
| 110 | 接口不存在 | 
PHP代码示例:
<?php
//GET请求记得用:urlencode
$api_url='https://api.yuanxiapi.cn/api/';
$api_id='接口ID';
$key='秘钥';
$post_arr=array('id'=>$api_id,'key'=>$key,'phone'=>'参数值');
$post=http_build_query($post_arr);
$data=get_curl($api_url,$post);
print_r($data);
function get_curl($url, $post=0, $referer=0, $cookie=0, $header=0, $ua=0, $nobaody=0, $addheader=0){
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
	curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
	$httpheader[] = "Accept: */*";
	$httpheader[] = "Accept-Encoding: gzip,deflate,sdch";
	$httpheader[] = "Accept-Language: zh-CN,zh;q=0.8";
	$httpheader[] = "Connection: close";
	if($addheader){
		$httpheader = array_merge($httpheader, $addheader);
	}
	curl_setopt($ch, CURLOPT_HTTPHEADER, $httpheader);
	if ($post) {
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
	}
	if ($header) {
		curl_setopt($ch, CURLOPT_HEADER, true);
	}
	if ($cookie) {
		curl_setopt($ch, CURLOPT_COOKIE, $cookie);
	}
	if($referer){
		if($referer==1){
			curl_setopt($ch, CURLOPT_REFERER, 'http://m.qzone.com/infocenter?g_f=');
		}else{
			curl_setopt($ch, CURLOPT_REFERER, $referer);
		}
	}
	if ($ua) {
		curl_setopt($ch, CURLOPT_USERAGENT, $ua);
	}
	else {
		curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Linux; U; Android 4.0.4; es-mx; HTC_One_X Build/IMM76D) AppleWebKit/534.30 (KHTML, like Gecko) Version/4.0");
	}
	if ($nobaody) {
		curl_setopt($ch, CURLOPT_NOBODY, 1);
	}
	curl_setopt($ch, CURLOPT_ENCODING, "gzip");
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	$ret = curl_exec($ch);
	curl_close($ch);
	return $ret; }
?>