六爻排盘API文档

接口说明

本接口用于六爻排盘：支持时间起卦（传年月日时自动起卦）与手动装卦（传六爻阴阳与动爻）两种模式，按12类问事（求财、事业、婚姻、疾病、失物等）自动定用神，返回本卦/变卦、卦宫世应、纳甲装卦（六亲、地支、五行、旺衰）、六神、神煞、旬空月破、合会局、动静太岁环境、断诀与应期等完整六爻分析。

基本信息

参数	值
Base URL（紫微服务）	`https://chart.12sign.top/liuyao`
接口URL	`/liuyao/cast`
请求方式	GET
返回格式	application/json

请求参数

参数名	类型	必选	说明
askType	string	是	问事类型：self自身 / wealth求财 / career事业官职 / marriage_m婚姻(男测) / marriage_f婚姻(女测) / illness疾病 / lost失物 / travel出行 / lawsuit官司 / home家宅 / children子女 / parents父母文书
year / month / day / hour	int	二选一	时间起卦模式：起卦时间（hour为0-23时辰）
lines	string	二选一	手动装卦模式：六爻阴阳，自初爻至上爻，1阳0阴，如 "111000"
moving	string	否	手动模式动爻位置，逗号分隔，如 "1" 或 "1,4"

时间模式与手动模式二选一：传 year/month/day/hour 即时间起卦；传 lines（+moving）即手动装卦。

请求示例

# 时间起卦（2026-09-01 14时 求财）
GET https://chart.12sign.top/liuyao/cast?askType=wealth&year=2026&month=9&day=1&hour=14

# 手动装卦（乾卦初爻动，问自身）
GET https://chart.12sign.top/liuyao/cast?askType=self&lines=111000&moving=1

返回参数

参数名	类型	说明
ok	boolean	是否成功
method	string	起卦方式：time / manual
lines / moving	array	六爻阴阳与动爻位置
ganzhi	object	起卦时刻四柱干支
result.gua	object	本卦：name卦名、index卦序、value六爻
result.palaceType	object	卦宫、世爻/应爻位置、本宫/变宫
result.yaos	array	纳甲装卦：每爻地支、五行、六亲、世应、旺衰、与日月的冲合刑害破关系
result.dongBian	object	变卦与动爻变化（进神/退神等）
result.liuShen	array	六神（青龙朱雀等）及每神主象
result.yongShen	object	用神：按问事自动定用神/元神/忌神/仇神及所在爻
result.shenSha	object	神煞：贵人禄刃马桃花等及逐爻神煞
result.kongPair / monthKong	string	旬空、月空
result.env	object	太岁、岁破、月建、月破、日辰、日破
result.heHui	array	三合局/半合等合会
result.shiYingRel	object	世应关系（相冲/相合等及含义）
result.dongTai	object	动爻统计（独发/群动等及含义）
result.duanJue	object	断诀：绝处逢生、随官入墓、主鬼附身等逐项断语
result.yingqi	object	应期：按规则的应期推断（值日/长生月等）
result.riYue	object	日月对爻的作用明细（得生/受克等逐爻标签）

返回示例

{
    "ok": true,
    "method": "time",
    "lines": [1, 1, 0, 1, 1, 0],
    "moving": [6],
    "ganzhi": { "year": "丙午", "month": "丙申", "day": "戊寅", "hour": "己未" },
    "result": {
    "gua": { "name": "兑为泽", "index": 56, "value": [1, 1, 0, 1, 1, 0] },
    "palaceType": { "type": "本宫", "shi": 6, "ying": 3, "palace": "兑" },
    "guaXing": { "ben": "六冲卦", "bian": "" },
    "yaos": [
        { "pos": 1, "yin": false, "moving": false, "zhi": "巳", "wuxing": "火", "liuqin": "官鬼", "wangShuai": "囚",
          "dayRel": { "chong": false, "he": false, "xing": true, "hai": true, "po": false } }
    ],
    "dongBian": { "bianGua": { "name": "天泽履", "index": 21 }, "moves": [...] },
    "liuShen": [ { "pos": 1, "liushen": "勾陈", "xiang": "田土、房产、牵连、迟滞" } ],
    "yongShen": { "key": "wealth", "label": "求财/买卖/价格/雇员", "yong": "妻财", ... },
    "kongPair": "申酉",
    "monthKong": "辰巳",
    "env": { "taiSui": "午", "suiPo": "子", "yueJian": "申", "yuePo": "寅", "riZhi": "寅", "riPo": "申" },
    "shiYingRel": { "rel": "世应相冲", "note": "相冲主对立、难成" },
    "dongTai": { "count": 1, "tai": "独发", "note": "一爻独动、力专而显、事之关键" },
    "duanJue": { ... },
    "yingqi": { "rules": [ { "rule": "用神值日(得信/应事)", "targets": ["卯"] } ] }
    }
    }

Python测试代码示例

import requests

BASE = "https://chart.12sign.top/liuyao/cast"

def test_liuyao():
    # 时间起卦：求财
    r = requests.get(BASE, params={
        "askType": "wealth",
        "year": 2026, "month": 9, "day": 1, "hour": 14
    })
    d = r.json()
    res = d["result"]
    print(f"本卦: {res['gua']['name']}  变卦: {res['dongBian']['bianGua']['name']}")
    print(f"卦宫: {res['palaceType']['palace']} 世:{res['palaceType']['shi']} 应:{res['palaceType']['ying']}")
    print(f"四柱: {d['ganzhi']}")
    for y in res["yaos"]:
        mark = "（动）" if y["moving"] else ""
        print(f"{y['pos']}爻 {y['zhi']}{y['wuxing']} {y['liuqin']}{mark}")

    # 手动装卦
    r2 = requests.get(BASE, params={"askType": "self", "lines": "111000", "moving": "1"})
    print(f"\n手动卦: {r2.json()['result']['gua']['name']}")

if __name__ == "__main__":
    test_liuyao()

在线测试

请求地址：

https://chart.12sign.top/liuyao/cast

起卦信息（JSON）：

时间模式：填 askType+year/month/day/hour；手动模式：改为 {"askType":"self","lines":"111000","moving":"1"}

返回结果：

点击"发送请求"后在此显示结果

卦象：