八字-流年财运分析

文档说明

        根据《子平真诠》、《渊海子平》、《三命通会・论财》基于用户提供的出生时间（年/月/日/时）、性别及目标流年，结合八字命理中的“五行生克”“干支关系”“身强身弱”“财星显隐”等核心逻辑，计算并返回该流年的财运综合分析报告，包含财运等级、财星类型、漏财风险、每月财运建议及风水提升方向等信息，为用户提供命理层面的流年财运参考。

请求方式

POST GET 

https://api.yuanfenju.com/index.php/v1/Bazi/caiyunfenxi

请求头

字段 类型 描述
Content-Type String application/x-www-form-urlencoded

请求参数

字段 类型 描述
api_key String 密钥
name String 姓名
sex Int 性别 0男 1女
type Int 历类型 0农历 1公历
year Int 出生年 例: 1988
liu_year Int 需要分析哪个流年的财运 例: 2030 
此参数只能大于等于当前公历年份
month Int 出生月 例: 8
如果是闰月，请参考 工具-阴阳历互相转换 获取公历再行带入
day Int 出生日 例: 7
hours Int 出生时 例: 12
minute Int 出生分 例: 30     
如果不知道具体分，可以传数字 0
sect Int 流派 例：1：晚子时日柱算明天 2：晚子时日柱算当天     
非必传，如果不传递这个参数，默认1
zhen Int 是否使用真太阳时 例：
1：使用中国真太阳时(需传省和市)
2：不使用真太阳时
3：使用全球真太阳时(需传经纬度)    
非必传，如果不传递这个参数，默认2
province String 省 例：北京市    
非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表
city String 市 例：北京    
非必传，但若 zhen=1，则省与市皆为必传参数。点击此处了解省市列表
longitude float 十进制经度 例：-77.036871    
非必传，但若 zhen=3，则经度与纬度皆为必传参数。
经度范围：-180～180，浮点数，小数点后最多6位。
latitude float 十进制纬度 例：38.907192    
非必传，但若 zhen=3，则经度与纬度皆为必传参数。
纬度范围：-90～90，浮点数，小数点后最多6位。
timezone string 时区（IANA 格式），例：Asia/Shanghai
非必传，默认 Asia/Shanghai
● zhen = 1（中国真太阳时）：时区固定为 Asia/Shanghai（程序会忽略传入值）
● zhen = 2（不使用真太阳时）：本参数不影响计算
● zhen = 3（全球真太阳时）：建议传出生地的 IANA 时区
例：纽约 America/New_York，新加坡 Asia/Singapore
使用当地时区可确保正确处理夏令时（DST）。
点击 此处 查看完整时区列表。
lang String 多语言：zh-cn 、zh-tw、en-us     
非必传，如果不传递这个参数，默认为 zh-cn

请求参数示例

$request_data = [
'api_key' => 'FsF1CsVevk3N17w7oBkSydfSk',
'name' => '张三',
'sex' => '1',
'type' => '1',
'year' => '1988',
'liu_year' => '2025',
'month' => '1',
'day' => '8',
'hours' => '12',
'minute' => '20',
'zhen' => '1',
'province' => '北京市',
'city' => '北京',
];

返回参数

字段 类型 描述
errcode String 请求状态码 0成功 其它为失败
errmsg String 状态码说明
notice String 声明
data Json 数据信息

成功返回示例

{
  "errcode": 0,
  "errmsg": "请求成功",
  "notice": "本次测算结果仅供娱乐使用，请勿用于封建迷信和违法用途。",
  "data": {
    "base_info": {//基本信息
      "zhen": { //考虑真太阳时才会有此字段，不考虑真太阳时就没有这个字段
        "province": "北京市",  //真太阳时省市
        "city": "北京",  //真太阳时省市
        "jingdu": "116.46",//真太阳经度
        "weidu": "39.92", //真太阳纬度
        "shicha": "晚0小时18分57秒" //考虑真太阳的时差
      },
      "sex": "坤造",//性别
      "name": "张三",//求测者姓名
      "gongli": "1988年1月8日12时1分",    //公历年
      "nongli": "丁卯年 十一月 十九日 午时", //农历年
      "qiyun": "9年1月23天起运",         //起运
      "jiaoyun": "1997年1月14日1时12分38秒", //交运
      "dayun": "丙辰",   //流年所在的大运干支
      "liunian": "乙巳", //指定的流年干支
      "qiangruo": "八字偏弱", //八字身强身弱
      "zhengge": "正官格" //八字正格
    },
    "bazi_info": { //八字信息
      "kw": "子丑",  //空亡
      "tg_cg_god": [ //天干十神
        "正财",  //年干十神
        "劫财",  //月干十神
        "日元",  //日干十神
        "偏财"   //时干十神
      ],
      "bazi": [ //四柱八字信息
        "丁卯",  //年干支
        "癸丑",  //月干支
        "壬戌",  //日干支
        "丙午"   //时干支
      ],
      "dz_cg": [ //地支藏干
        "乙",  //年支藏干
        "己|癸|辛",//月支藏干
        "戊|辛|丁",//日支藏干
        "丁|己"    //时支藏干
      ],
      "dz_cg_god": [ //地支藏干十神
        "伤官",    //地支藏干十神【年】
        "正官|劫财|正印",  //地支藏干十神【月】
        "七杀|正印|正财",  //地支藏干十神【日】
        "正财|正官"  //地支藏干十神【时】
      ],
      "day_cs": [ //八字长生衰旺
        "死",     //八字长生衰旺【年】
        "衰",     //八字长生衰旺【月】
        "冠带",   //八字长生衰旺【日】
        "胎"      //八字长生衰旺【时】
      ],
      "na_yin": [  //五行纳音
        "炉中火",  //五行纳音【年】
        "桑柘木",  //五行纳音【月】
        "大海水",  //五行纳音【日】
        "天河水"   //五行纳音【时】
      ]
    },
    "caiyun_info": { //财运分析结果
      //流年整体财运分数
      "yearlyOverallFortuneScore": 86,
      //流年财星显隐
      "yearlyFortuneStarVisibility": "此年财星隐于地支，表面机会不显，但....",
      //流年财星类别[正财或者偏财]
      "yearlyFortuneStarCategory": "正财气足，固定收入进账稳定，职场能力....",
      //身强与身弱分析
      "bodyStrengthVsWeakness": "日主身弱，但流年吉星护持，显示虽自身能力有限，但....",
      //流年与命支分析
      "yearlyVsDestinyBranch": "流年与命支呈现合多于冲，财星安稳。今年是....",
      //流年财库分析
      "yearlyFortuneTreasuryInfo": "无财库的命局，今年财星却旺，格局为“财星有根，流动生财”....",
      //大运与流年分析
      "majorFortunePeriodVsYearly": "大运为财星长生之地，流年为财星沐浴之地，运岁地支相....",
      //流年每月财运 + 投资提示
      "yearlyMonthlyFortuneAndInvestmentTips": [
        //1月财运投资提示
        "本月正财气足，固定薪资环比增长，职场稳定性高，稳健理财可放大收益。....",
        //2月财运投资提示
        "流月正财旺盛，主业收入无断层，职场能力持续变现，适合中长期稳健规....",
        //3月财运投资提示
        "本月正财得势，固定收益来源扎实，职场晋升近在眼前，依托主业理财更可靠。....",
        //4月财运投资提示
        "流月正财兴旺，主业薪资、福利双优，日常开支无压力，可布局低风险投资....",
        //5月财运投资提示
        "本月正财旺相，固定收入稳步上涨，职场发展助力财气，坚守主业是聚财关键....",
         //6月财运投资提示
        "流月正财得力，主业提成、奖金进账稳定，适合专注业务，同步做稳健理财。....",
         //7月财运投资提示
        "本月正财气足，固定薪资有明确涨幅，职场环境佳，低风险理财易见成效。流....",
         //8月财运投资提示
        "流月正财旺盛，主业收入持续向好，职场能力获器重，财富积累以稳为核心。....",
         //9月财运投资提示
        "本月正财得势，固定收益（薪资、奖金）可观，职场晋升机会清晰，适配稳健理....",
         //10月财运投资提示
        "流月正财兴旺，主业收益无波动，职场福利到位，适合依托主业做财富规划。....",
        "本月正财旺相，固定薪资环比提升，职场发展顺风顺水，低风险投资易获利。....",
         //12月财运投资提示
        "流月正财得力，主业收入稳定增长，职场机遇多，坚守现有岗位易聚财。流月....",
      ],
      //先天财运格局
      "innateFortunePattern": "日主五行属水，而水克火，故财星属火，财运好....",
      //漏财风险提示
      "fortuneLeakageRiskTips": "财星得扶，漏财仅在“社交礼仪开支”（如红包、....",
      //提升财运建议
      "fortuneImprovementSuggestions": "财星属火，主光明与热情之财，宜南....",
      //大师财运建议
      "masterFortuneSuggestions": "身弱逢此年财星临贵人，财运与贵人运交织....",
    }
  }
}

失败返回示例

{
  "errcode": -1,
  "errmsg": "日期有误",
}
汇总