终生运势 API 接口文档

接口描述

提供个人终身运势分析服务，根据姓名、出生年月日时及性别，推算八字排盘、五行分析，并提供本命详解、一生旺运劫数、最佳配偶及流年运势等综合命理分析。（注意：接入前请查看详情中的免责声明）

功能特性

• 提供个人终身运势分析服务，根据姓名、出生年月日时及性别，推算八字排盘、五行分析，并提供本命详解、一生旺运劫数、最佳配偶及…
• 返回 JSON 结构化数据，便于程序解析
• 支持 GET / POST 两种调用方式
• 平台统一密钥鉴权与调用统计，支持积分计费

接口地址

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

请求方式

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

鉴权方式

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

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

请求参数

请求参数 (JSON格式)

[
  {"name": "username", "type": "string", "required": true, "description": "姓名"},
  {"name": "birthday", "type": "string", "required": true, "description": "出生日期（格式：YYYY-MM-DD）"},
  {"name": "hour", "type": "integer", "required": true, "description": "出生小时（0-23），自动换算为时辰"},
  {"name": "sex", "type": "integer", "required": true, "description": "性别（1=男，0=女）"}
]

响应格式

JSON 格式响应

成功返回示例：

{"code":1,"msg":"查询成功","data":{"username":"李飞","xs":"李","mz":"飞","birthday":{"year":"2026","month":7,"day":7,"hour":11},"sex":"男","shengxiao":"马","wuxing":{"j":0,"m":1,"s":1,"h":5,"t":1,"b":"水火","k":"金木土","w":"火","q":"金","o":null},"bazi":{"nayin":[{"jiazi":"丙午","layin":"天河水","whsx":{"sx":"马","sx_py":"ma","wh_py":"shui","wx_py":"火火"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"壬午","layin":"杨柳木","whsx":{"sx":"马","sx_py":"ma","wh_py":"mu","wx_py":"水火"}},{"jiazi":"丙午","layin":"天河水","whsx":{"sx":"马","sx_py":"ma","wh_py":"shui","wx_py":"火火"}}],"table":{"time":["2026年","7月","7日","巳时"],"ganzhi":["丙午","乙未","壬午","丙午"],"main_stars":["偏财","伤官","日主","偏财"],"tian_gan":["丙","乙","壬","丙"],"di_zhi":["午","未","午","午"],"wx_full":["火火","木土","水火","火火"],"cang_gan":["丁 己","己 丁 乙","丁 己","丁 己"],"di_shi":["帝旺","养","胎","帝旺"],"kong_wang":[],"shen_sha":["将星","","将星","将星"],"na_yin":["天河水","沙中金","杨柳木","天河水"]},"wx_score":{"木":11,"火":43,"土":13,"金":0,"水":10},"wx_count":{"木":1,"火":5,"土":1,"金":0,"水":1},"day_gan":"壬","day_wx":"水","bazi_str":"丙午 乙未 壬午 丙午"},"bzjx":"## 整体\n\n属马人在2021年运势逐渐平稳，但又恰逢害太岁，仍然会受到部分冲击，主要反映在人际关系上，容易遭小人陷害中伤。但有月德吉星拱招，代表逢凶化吉，事业上有贵人相助；玉堂吉星代表金玉满堂，带来了不错的赚钱机会。但也有小耗凶星带来轻微破财；咸池桃花飞临，带来墙外桃花，已婚者要小心别卷入三角关系。害太岁年份人事较为纷乱，易遭小人陷害，需谨慎低调行事，不宜锋芒太露。\n## 财运\n\n牛年有代表金玉满堂的玉堂星拱照，财运逐渐顺遂。还有月德吉星带来强有力的贵人，加上使人际关系畅旺的咸池桃花，若从事销售等行业，有望凭借人缘使业绩提升。但仍有小耗凶星入主，会带来突如其来的开支，可能会破财漏财。以正财为主，不宜作高风险投资，亦不宜留太多现金，可主动购买实物保值，以破欢喜财的方式应验运势。\n## 事业\n\n事业上，喜获月德吉星带来贵人相助，长辈领导会对属马人赏识提拔，加上玉堂吉星，有升职加薪的机会。另有咸池桃花临门，此星利桃花及人缘，对从事地产、保险、销售者等行业比较有利，有望得到客户信任，业绩增长，收入翻番。不过人际关系不算顺利，与同事的关系紧张，要提防小人陷害，谨言慎行，以免拖垮本来不错的事业运。\n## 感情\n\n2021年属马人的桃花缘分畅旺，有利人缘的咸池桃花飞临，单身者魅力大增，有机会开展一段新恋情，但咸池桃花带来的多是镜花水月的短暂感情，难以修成正果。已婚者遇上此星代表墙外桃花，需要洁身自好，以免卷入三角关系。另外，要留心桃花破财情况，避免与异性发生金钱纠葛。破太岁年份人际较为复杂，感情运势顺利中暗藏变故，需要注意。\n## 健康\n\n2021年是害太岁的年份，会有皮肤敏感、鼻炎等琐碎小毛病，健康运被轻微冲击，可主动养生或购买医保提升健康运。另有咸池桃花星驾临，此星代表应酬、进入娱乐场所的机会较多，长期如此对健康比较不利，还需要适可而止、规律作息。另外，害太岁年份人际关系较为紧张，容易带来负面情绪和焦虑，建议多运动多亲近自然，以此放松身心。","wyjs":"## 命理基础信息\n\n生年地支：午年生。\n\n五行：午属火。\n\n五常：火属礼。\n\n吉吉祥方位：东北、西南及西北方。\n\n吉祥颜色：啡、黄、紫，忌蓝、白、金等色。\n\n幸运花：海芋、慈姑花、茉莉。。\n## 一生总概况及说明\n\n人从出生八字就已经固定了，无法去改变，每个八字都对应了相应的命理和运势，从您的八字命盘来看：您，午年生人，其性好动不好静，多喜出风头，而对社会交际极为巧妙，且多管他人事，备受人敬爱，并有贵人牵引以至成功，此人欲好外观，对内事缺乏观察，又好投机事业，且有怪癖之主张。致所思想及计划之事，难保其机密，此人有伶俐、敏速、为人亲切、好旅行、牺牲、自夸、焦燥、悲观的素质。\n\n古人云：命中注定！虽命中注定不可违，但我们可以从八字中获取一生的旺运和一生的劫数，旺运阶段，全力迎合，不可颓废，将运势最大化；劫数阶段，万分小心，不可懈怠，将劫数最小化。方能达到命中最好的结果，下面根据周易八字排盘数据列出您的一生旺运和劫数，请您细细斟酌与参考。\n\n## 一生的旺运\n\n25岁左右遇到贵人\n\n您拥有良好的社交能力，出门在外，能够结识到不少能够帮助到自己的朋友，在事业上，也能得到贵人的相助。25岁左右的您，虽然刚进入职场不久，但却能够充分发挥自身的优点，且眼光独到头脑很机灵，哪怕此时资历不够，可依旧会得到合作伙伴的垂青。这个年龄段的您，会利用自身的优势吸引很多贵人，积攒下强大的人脉，为将来的飞黄腾达做准备。虽然表面上看这个年龄段的您，还没有太大的成就，但未来的格局早已经注定，千万不可小瞧。\n\n37岁左右财运旺盛\n\n您的一生中注定会拥有很多财富，不过早年间大多四处奔走没有定性，钱财来的快去的也很快。您真正发家致富，要等到37岁左右，此时财运将达到第一次巅峰，事业上的逐渐稳定，会让正财方面的收入滚滚而来。经济有了基础之后，您将会充分发挥冒险的精神，在其他领域里一展风采。特别是地产和金融行业，对您来说很合适，独到的眼光和敏锐的市场嗅觉，会让您每每投资必将获利。这个年龄段，不管正财还是偏门财都很旺盛，同时也是您成家立业的时候，此时堪称他们人生中的辉煌时光。\n\n49岁左右名利双收\n\n成功的人生，不仅仅是拥有财富和地位，更需要拥有良好的口碑。您平时为人很豪爽，对待朋友也相当仗义，在朋友圈中口碑通常比较好。不过早年您由于年轻气盛，也很容易得罪他人，就算身边有很多好友支持，但难免有人在背后诋毁。不过您做事坦荡问心无愧，在进入50岁之后，一直以来积攒的口碑得到了体现。不管在职场上还是平时的朋友圈子中，您都非常受人尊重。到了这个年纪的您，不仅财富事业都有，家庭也很幸福，更重要的是在外口碑不错，可以说是名利双收，成为了人生赢家。\n\n## 一生的劫数\n\n28岁左右小人劫\n\n您的28岁左右会被小人陷害，生活变得困难起来，而且会因此失去一些人心的，这样的事情发生是很糟糕的。您这个年龄里的经验不够，是容易相信别人的话的，轻易的相信就会被利用了。您被小人纠缠上的时候自己想要的发展都会推迟，麻烦会变得越来越多。\n\n32岁左右情劫\n\n您的32岁左右有情劫，这一年里您面对感情的时候是左右为难的，感情上不能够果断的做出决定来。感情上您会越来越消极，您也容易因为一些暧昧关系而变得头痛。您这一年里面对感情是比较贪心的，什么都想要，最后很可能是什么都没有了的。\n\n45岁左右婚姻劫\n\n您的45岁左右婚姻生活上是有麻烦的，这样的事情发生很糟糕，您要多考虑自己伴侣的感受，面对婚姻的时候不能够太自私。您结婚之后是容易恃宠而骄的，慢慢的忘记了婚姻生活是需要维持的，时间久了之后，您就会失去自己的婚姻的，到时候是后悔都来不及了。\n\n52岁左右破财劫\n\n您的52岁左右会因为身边的人有金钱上的损失的，破财劫在这个时候到来了，您是很讲义气的人，由于您在49岁左右能够积累一定的财富，所以身边人有经济困难的时候您是会主动的帮助的。不过这一年里，您给出的帮助是有些盲目的，会忽略了自己的经济状况，最后给自己的经济状况带来了新的麻烦。","zjpo":"## 最佳配偶\n\n午马和未羊六合，所以属马人比较适合找一个属羊的对象，此乃上上等婚配。其次寅虎和戌狗三合，所以属虎和属狗也比较相配，，此乃上等婚配。午马与子鼠相冲，所以最忌找属鼠的，此乃下下等婚配。午马与丑牛相害，因此也要尽量避免找属牛的，此乃中下等婚配。有时又讲午午自刑，所以属马人也应该避免找同属相的配偶，此乃中下等婚配。\n## 最后总结\n\n总体来看，您您的一生过的十分精彩，事业运势也一直以来都很不错，在感情方面更是相当潇洒，人生中将会经历几段可贵的爱情。不过您真正富贵，还是在有了婚姻之后，因此婚后要忠于爱人，稳定夫妻关系，因为家庭的变故，容易给您带来负面的影响。另外，您对待子女比较宠溺，很可能导致孩子不争气，因此在这方面也要多多注意，避免过度呵护，否则影响了孩子的未来。"},"time":1786089500}

失败返回示例：

{"code":0,"msg":"请提供姓名参数(username)","data":null,"time":1786089464}

代码示例

curl "https://api.souxiaocha.com/apis/gateway?api=zhongsheng?key=SK-你的密钥&username=%E5%BC%A0%E4%BC%9F&birthday=1993-05-20&hour=10&sex=1"

错误响应

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

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

注意事项

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

开发时间

2026-09-24