卜卦盘API文档

基本信息

通用参数（动态天体配置、恒星、阿拉伯点等）请参考 单盘接口通用参数说明

请求参数

1. 基础参数（必需）

2. 可选参数

请求示例

{
    "chart_type": "horary",
    "data": {
        "datetime": "2026-09-22 12:00:00",
        "lat": 30.59,
        "lon": 114.31,
        "tz": 8
    }
}

带可选参数

{
    "chart_type": "horary",
    "data": {
        "datetime": "2026-09-22 12:00:00",
        "lat": 30.59,
        "lon": 114.31,
        "tz": 8
    },
    "house_system": "R",
    "include_analysis": true,
    "include_svg": true
}

返回参数

data.horary 字段

radicality.checks 每条的字段

返回示例（节选）

{
    "success": true,
    "data": {
        "chart_type": "natal",
        "planets": {
            "SUN":  { "longitude": 179.18, "speed": 0.9778 },
            "MOON": { "longitude": 305.44, "speed": 13.13 },
            "TRUE_NODE": { "longitude": 329.58, "speed": -0.0529 },
            "ASC":  { "longitude": 252.75, "speed": 0 },
            "MC":   { "longitude": 174.93, "speed": 0 }
            // ... 其余天体与宫位、分析数据结构与单盘接口一致
        },
        "horary": {
            "house_system": "Regiomontanus (芮氏)",
            "dignity_options": {
                "terms": "lilly",
                "faces": "chaldean",
                "rulership": "traditional",
                "triplicity_sect": "on"
            },
            "moment_utc": "2026-09-22 04:00",
            "sunrise_local": "2026-09-22 06:11",
            "sunset_local": "2026-09-22 18:20",
            "planetary_hour": {
                "hour_ruler": "Saturn",
                "hour_ruler_cn": "土星",
                "day_ruler": "Mars",
                "day_ruler_cn": "火星",
                "hour_index": 6,
                "is_day": true,
                "is_day_cn": "日间盘"
            },
            "radicality": {
                "radical": true,
                "verdict_cn": "具备根本性要素，但另有 1 项提醒（行星对冲其庙宫），可评估但需谨慎",
                "is_day": true,
                "checks": [
                    {
                        "rule": 1,
                        "name_cn": "时主星与上升守护星的一致性",
                        "status": "positive",
                        "detail": "时主星土星为上升星座射手座的三分主星"
                    },
                    {
                        "rule": 2,
                        "name_cn": "月亮空亡",
                        "status": "ok",
                        "detail": "月亮入相位火星对冲，约 0.78 天内完美，不空亡"
                    }
                    // ... rule 3 至 rule 12
                ]
            }
        },
        "dignities": {
            "options": { "terms": "lilly", "faces": "chaldean", "rulership": "traditional", "triplicity_sect": "on", "sect_detected": "diurnal" },
            "planets": [
                {
                    "name": "Venus", "name_cn": "金星",
                    "essential": { "score": 0, "dignities": ["dayTrip"], "dignities_cn": ["日三分"] },
                    "accidental": { "score": 14 },
                    "mutual_receptions": [],
                    "total": 14
                }
                // ... 七大行星每颗一条
            ],
            "summary": { "strongest": { "...": "..." }, "weakest": { "...": "..." }, "total_planets": 7 }
        }
    },
    "svg": null
}

Python 调用示例

import requests

response = requests.post('https://chart.12sign.top/onechart', json={
    "chart_type": "horary",
    "data": {
        "datetime": "2026-09-22 12:00:00",
        "lat": 30.59,
        "lon": 114.31,
        "tz": 8
    },
    "include_svg": True
})

result = response.json()
if result['success']:
    data = result['data']

    # 保存星盘图
    if result.get('svg'):
        with open('horary.svg', 'w', encoding='utf-8') as f:
            f.write(result['svg'])

    # 时主星
    ph = data['horary']['planetary_hour']
    print(f"时主星: {ph['hour_ruler_cn']} (第{ph['hour_index']}时, {ph['is_day_cn']})")

    # 根本性判断
    rad = data['horary']['radicality']
    print(f"根本性: {rad['verdict_cn']}")
    for c in rad['checks']:
        print(f"[{c['status']}] {c['name_cn']}: {c['detail']}")

    # 行星先天/后天得分 (需要 include_dignity=True)
    for p in data.get('dignities', {}).get('planets', []):
        print(f"{p['name_cn']}: 先天={p['essential']['score']} 后天={p['accidental']['score']} 总分={p['total']}")

在线测试

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