提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）
提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| username | string | 是 | 姓名 | |
| birthday | string | 是 | 出生日期（格式：YYYY-MM-DD） | |
| hour | integer | 是 | 出生小时（0-23），自动换算为时辰用于八字排盘 | |
| sex | integer | 是 | 性别（1=男，0=女） |
[
{
"name": "username",
"type": "string",
"required": true,
"description": "姓名",
"example": ""
},
{
"name": "birthday",
"type": "string",
"required": true,
"description": "出生日期（格式：YYYY-MM-DD）",
"example": ""
},
{
"name": "hour",
"type": "integer",
"required": true,
"description": "出生小时（0-23），自动换算为时辰用于八字排盘",
"example": ""
},
{
"name": "sex",
"type": "integer",
"required": true,
"description": "性别（1=男，0=女）",
"example": ""
}
]{"openapi":"3.1.1","info":{"title":"流年运势","description":"提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）","version":"1.0.0"},"paths":{"/apis/gateway?api=liunian":{"get":{"summary":"流年运势","description":"提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）","parameters":[{"name":"username","in":"query","required":true,"schema":{"type":"string"},"description":"姓名"},{"name":"birthday","in":"query","required":true,"schema":{"type":"string"},"description":"出生日期（格式：YYYY-MM-DD）"},{"name":"hour","in":"query","required":true,"schema":{"type":"integer"},"description":"出生小时（0-23），自动换算为时辰用于八字排盘"},{"name":"sex","in":"query","required":true,"schema":{"type":"integer"},"description":"性别（1=男，0=女）"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"流年运势","description":"提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）","parameters":[{"name":"username","in":"query","required":true,"schema":{"type":"string"},"description":"姓名"},{"name":"birthday","in":"query","required":true,"schema":{"type":"string"},"description":"出生日期（格式：YYYY-MM-DD）"},{"name":"hour","in":"query","required":true,"schema":{"type":"integer"},"description":"出生小时（0-23），自动换算为时辰用于八字排盘"},{"name":"sex","in":"query","required":true,"schema":{"type":"integer"},"description":"性别（1=男，0=女）"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://api.souxiaocha.com","description":"当前访问入口（https）"}]}
{"code":1,"msg":"查询成功","data":{"username":"李华","birthday":{"year":2006,"month":7,"day":7,"hour":10},"sex":"男","zodiac":"6","bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"丁酉","layin":"山下火","whsx":{"sx":"鸡","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","7月","7日","巳时"],"ganzhi":["丙戌","乙未","丁酉","乙巳"],"main_stars":["劫财","偏印","日主","偏印"],"tian_gan":["丙","乙","丁","乙"],"di_zhi":["戌","未","酉","巳"],"wx_full":["火土","木土","火金","木火"],"cang_gan":["戊 辛 丁","己 丁 乙","辛","丙 庚 戊"],"sub_stars":["伤官\/偏财\/比肩","食神\/比肩\/偏印","偏财","劫财\/正财\/伤官"],"di_shi":["墓","养","长生","沐浴"],"kong_wang":["辰、巳","辰、巳","辰、巳","辰、巳"],"shen_sha":["华盖","","天乙贵人 文昌贵人 学堂","羊刃"],"na_yin":["屋上土","沙中金","山下火","覆灯火"]},"wx_score":{"木":21,"火":30,"土":15,"金":11,"水":0},"wx_count":{"木":2,"火":3,"土":2,"金":1,"水":0},"wx_wangshuai":{"木":"偏旺","火":"偏旺","土":"中和","金":"中和","水":"偏弱"},"wx_percent":{"木":27.3,"火":39,"土":19.5,"金":14.3,"水":0},"day_gan":"丁","day_wx":"火","bazi_str":"丙戌 乙未 丁酉 乙巳"},"yunshi":{"info":"本年度对于你而言，整体基调偏向内敛与滋养，情感的深度似乎比往常更受关注。年初阶段可能会对周围环境的变化较为敏感，多一些自我关照或许有助于平稳过渡。从大环境来看，本年度似乎为你提供了更多回归内心、整理情绪的空间，尤其在面对人际关系或生活变动时，直觉可能会成为一个值得信任的向导。上半年或许更适合营造舒适的生活氛围、修复消耗的能量，而下半年则可能逐渐感受到一种想要向外拓展的温和冲动。当然，每个人的情感节奏和处境各不相同，这些趋势仅作为一种柔和的参考。\n在个人成长层面，本年度你可能会对\"归属感\"与\"安全感\"有新的理解，无论是家庭、亲密关系还是自我认同，重新锚定内心的支点或许会成为贯穿全年的主题。生活中可能会遇到一些需要细腻处理的情境，保持温柔而坚定的态度会比较有利。同时，本年度也可能出现一些与过去相关的人事重遇，如何带着成长后的视角去回应，值得给自己多一些耐心。需要注意的是，过度沉浸于某种情绪或回忆有时可能会限制前行的脚步，适当允许自己放下、向前看，或许能发现不一样的风景。\n感情与人际方面，本年度亲密关系的质量有望得到深化，与重要的人相处时，真诚的关怀与细微的体贴往往比华丽的表达更有分量。单身者在社交中或许更容易被温暖、踏实的气质所吸引，但建立信任的过程大概率不会一蹴而就，慢慢来或许更符合本年度的节奏。人际交往中，本年度似乎容易在熟悉的小圈子中获得情感支持，不过偶尔敞开心扉、让新的人走进来，也可能为生活带来意想不到的慰藉。健康方面，关注消化系统与情绪之间的关联，保持规律的饮食和适度的情绪释放，对于维持身心平衡会有一定的助益。总的来说，本年度是一个适合滋养与重建的年份，向内扎根、向外生长，或许能在温柔中积蓄起意想不到的力量。","pfen":"0"}},"time":1786159546}https://api.souxiaocha.com/apis/gateway?api=liunianGET https://api.souxiaocha.com/apis/gateway?api=liunian apikey=你的API密钥&username=请填写username&birthday=请填写birthday&hour=请填写hour&sex=请填写sex
GET 参数放在查询字符串中。参数值请替换为实际有效值。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
username | string | 是 | 姓名 | |
birthday | string | 是 | 出生日期（格式：YYYY-MM-DD） | |
hour | integer | 是 | 出生小时（0-23），自动换算为时辰用于八字排盘 | |
sex | integer | 是 | 性别（1=男，0=女） |
{"code":1,"msg":"查询成功","data":{"username":"李华","birthday":{"year":2006,"month":7,"day":7,"hour":10},"sex":"男","zodiac":"6","bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"丁酉","layin":"山下火","whsx":{"sx":"鸡","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","7月","7日","巳时"],"ganzhi":["丙戌","乙未","丁酉","乙巳"],"main_stars":["劫财","偏印","日主","偏印"],"tian_gan":["丙","乙","丁","乙"],"di_zhi":["戌","未","酉","巳"],"wx_full":["火土","木土","火金","木火"],"cang_gan":["戊 辛 丁","己 丁 乙","辛","丙 庚 戊"],"sub_stars":["伤官\/偏财\/比肩","食神\/比肩\/偏印","偏财","劫财\/正财\/伤官"],"di_shi":["墓","养","长生","沐浴"],"kong_wang":["辰、巳","辰、巳","辰、巳","辰、巳"],"shen_sha":["华盖","","天乙贵人 文昌贵人 学堂","羊刃"],"na_yin":["屋上土","沙中金","山下火","覆灯火"]},"wx_score":{"木":21,"火":30,"土":15,"金":11,"水":0},"wx_count":{"木":2,"火":3,"土":2,"金":1,"水":0},"wx_wangshuai":{"木":"偏旺","火":"偏旺","土":"中和","金":"中和","水":"偏弱"},"wx_percent":{"木":27.3,"火":39,"土":19.5,"金":14.3,"水":0},"day_gan":"丁","day_wx":"火","bazi_str":"丙戌 乙未 丁酉 乙巳"},"yunshi":{"info":"本年度对于你而言，整体基调偏向内敛与滋养，情感的深度似乎比往常更受关注。年初阶段可能会对周围环境的变化较为敏感，多一些自我关照或许有助于平稳过渡。从大环境来看，本年度似乎为你提供了更多回归内心、整理情绪的空间，尤其在面对人际关系或生活变动时，直觉可能会成为一个值得信任的向导。上半年或许更适合营造舒适的生活氛围、修复消耗的能量，而下半年则可能逐渐感受到一种想要向外拓展的温和冲动。当然，每个人的情感节奏和处境各不相同，这些趋势仅作为一种柔和的参考。\n在个人成长层面，本年度你可能会对\"归属感\"与\"安全感\"有新的理解，无论是家庭、亲密关系还是自我认同，重新锚定内心的支点或许会成为贯穿全年的主题。生活中可能会遇到一些需要细腻处理的情境，保持温柔而坚定的态度会比较有利。同时，本年度也可能出现一些与过去相关的人事重遇，如何带着成长后的视角去回应，值得给自己多一些耐心。需要注意的是，过度沉浸于某种情绪或回忆有时可能会限制前行的脚步，适当允许自己放下、向前看，或许能发现不一样的风景。\n感情与人际方面，本年度亲密关系的质量有望得到深化，与重要的人相处时，真诚的关怀与细微的体贴往往比华丽的表达更有分量。单身者在社交中或许更容易被温暖、踏实的气质所吸引，但建立信任的过程大概率不会一蹴而就，慢慢来或许更符合本年度的节奏。人际交往中，本年度似乎容易在熟悉的小圈子中获得情感支持，不过偶尔敞开心扉、让新的人走进来，也可能为生活带来意想不到的慰藉。健康方面，关注消化系统与情绪之间的关联，保持规律的饮食和适度的情绪释放，对于维持身心平衡会有一定的助益。总的来说，本年度是一个适合滋养与重建的年份，向内扎根、向外生长，或许能在温柔中积蓄起意想不到的力量。","pfen":"0"}},"time":1786159546}提供个人年度流年运势分析服务，根据姓名、出生日期、出生小时及性别，综合八字命理进行年度运势解读，涵盖八字排盘、整体基调、个人成长、感情人际、健康等维度的综合分析。（注意：接入前请查看详情中的免责声明）
https://api.souxiaocha.com/apis/gateway?api=liunianGET / POST（业务参数 GET 通过 URL 传递，POST 支持表单或 JSON）
调用需携带平台密钥（用户中心「令牌管理」获取，SK- 开头）：
key=SK-你的密钥X-API-Key: SK-你的密钥| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| username | string | 是 | 姓名 |
| birthday | string | 是 | 出生日期（格式：YYYY-MM-DD） |
| hour | integer | 是 | 出生小时（0-23），自动换算为时辰用于八字排盘 |
| sex | integer | 是 | 性别（1=男，0=女） |
[
{"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=女）"}
]成功返回示例：
{"code":1,"msg":"查询成功","data":{"username":"李华","birthday":{"year":2006,"month":7,"day":7,"hour":10},"sex":"男","zodiac":"6","bazi":{"nayin":[{"jiazi":"丙戌","layin":"屋上土","whsx":{"sx":"狗","sx_py":"gou","wh_py":"tu","wx_py":"火土"}},{"jiazi":"乙未","layin":"沙中金","whsx":{"sx":"羊","sx_py":"yang","wh_py":"jin","wx_py":"木土"}},{"jiazi":"丁酉","layin":"山下火","whsx":{"sx":"鸡","sx_py":"ji","wh_py":"huo","wx_py":"火金"}},{"jiazi":"乙巳","layin":"覆灯火","whsx":{"sx":"蛇","sx_py":"she","wh_py":"huo","wx_py":"木火"}}],"table":{"time":["2006年","7月","7日","巳时"],"ganzhi":["丙戌","乙未","丁酉","乙巳"],"main_stars":["劫财","偏印","日主","偏印"],"tian_gan":["丙","乙","丁","乙"],"di_zhi":["戌","未","酉","巳"],"wx_full":["火土","木土","火金","木火"],"cang_gan":["戊 辛 丁","己 丁 乙","辛","丙 庚 戊"],"sub_stars":["伤官\/偏财\/比肩","食神\/比肩\/偏印","偏财","劫财\/正财\/伤官"],"di_shi":["墓","养","长生","沐浴"],"kong_wang":["辰、巳","辰、巳","辰、巳","辰、巳"],"shen_sha":["华盖","","天乙贵人 文昌贵人 学堂","羊刃"],"na_yin":["屋上土","沙中金","山下火","覆灯火"]},"wx_score":{"木":21,"火":30,"土":15,"金":11,"水":0},"wx_count":{"木":2,"火":3,"土":2,"金":1,"水":0},"wx_wangshuai":{"木":"偏旺","火":"偏旺","土":"中和","金":"中和","水":"偏弱"},"wx_percent":{"木":27.3,"火":39,"土":19.5,"金":14.3,"水":0},"day_gan":"丁","day_wx":"火","bazi_str":"丙戌 乙未 丁酉 乙巳"},"yunshi":{"info":"本年度对于你而言，整体基调偏向内敛与滋养，情感的深度似乎比往常更受关注。年初阶段可能会对周围环境的变化较为敏感，多一些自我关照或许有助于平稳过渡。从大环境来看，本年度似乎为你提供了更多回归内心、整理情绪的空间，尤其在面对人际关系或生活变动时，直觉可能会成为一个值得信任的向导。上半年或许更适合营造舒适的生活氛围、修复消耗的能量，而下半年则可能逐渐感受到一种想要向外拓展的温和冲动。当然，每个人的情感节奏和处境各不相同，这些趋势仅作为一种柔和的参考。\n在个人成长层面，本年度你可能会对\"归属感\"与\"安全感\"有新的理解，无论是家庭、亲密关系还是自我认同，重新锚定内心的支点或许会成为贯穿全年的主题。生活中可能会遇到一些需要细腻处理的情境，保持温柔而坚定的态度会比较有利。同时，本年度也可能出现一些与过去相关的人事重遇，如何带着成长后的视角去回应，值得给自己多一些耐心。需要注意的是，过度沉浸于某种情绪或回忆有时可能会限制前行的脚步，适当允许自己放下、向前看，或许能发现不一样的风景。\n感情与人际方面，本年度亲密关系的质量有望得到深化，与重要的人相处时，真诚的关怀与细微的体贴往往比华丽的表达更有分量。单身者在社交中或许更容易被温暖、踏实的气质所吸引，但建立信任的过程大概率不会一蹴而就，慢慢来或许更符合本年度的节奏。人际交往中，本年度似乎容易在熟悉的小圈子中获得情感支持，不过偶尔敞开心扉、让新的人走进来，也可能为生活带来意想不到的慰藉。健康方面，关注消化系统与情绪之间的关联，保持规律的饮食和适度的情绪释放，对于维持身心平衡会有一定的助益。总的来说，本年度是一个适合滋养与重建的年份，向内扎根、向外生长，或许能在温柔中积蓄起意想不到的力量。","pfen":"0"}},"time":1786159546}失败返回示例：
{"code":0,"msg":"请提供姓名参数(username)","data":null,"time":1786159572}| 参数名 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码，1表示成功 |
| msg | string | 返回消息，如"查询成功" |
| data | object | 流年运势核心数据对象 |
| time | integer | 数据生成时间戳（Unix时间戳） |
| 其他参数见接口详情 | string | 其他参数见接口详情 |
curl "https://api.souxiaocha.com/apis/gateway?api=liunian?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
curl "https://api.souxiaocha.com/apis/gateway?api=liunian?key=SK-你的密钥&username=%E5%BC%A0%E4%BC%9F&birthday=1993-05-20&hour=10"// 结果将在此处显示