法达盘API完整文档

基本信息

参数	值
Base URL	`https://chart.12sign.top`
接口URL	`/onechart`
请求方式	POST
Content-Type	application/json

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

法达盘概念

法达盘（Firdaria）是一种中世纪阿拉伯占星术的推运方法，基于出生盘计算人生各阶段的行星统治周期。

大运（Major Period）：人生被分为若干个行星统治的大周期，每个行星统治若干年
小运（Sub Period）：每个大运又被分为7个小周期，由七大传统行星轮流统治
日生/夜生：根据太阳在地平线上下的位置，决定行星序列的起始顺序

日生盘序列：太阳(10年) → 金星(8年) → 水星(13年) → 月亮(9年) → 土星(11年) → 木星(12年) → 火星(7年) → 北交点(3年) → 南交点(2年)
夜盘序列：月亮(9年) → 土星(11年) → 木星(12年) → 火星(7年) → 太阳(10年) → 金星(8年) → 水星(13年) → 北交点(3年) → 南交点(2年)

请求参数

1. 基础参数（必需）

参数名	类型	必选	说明
chart_type	string	是	固定值："developed"
natal_data.datetime	string	是	出生日期时间，格式：YYYY-MM-DD HH:MM:SS
natal_data.lat	number	是	出生地纬度
natal_data.lon	number	是	出生地经度
natal_data.tz	number/string	是	出生地时区，如 8 或 "8" 表示UTC+8，支持小数如 8.5
target_data.datetime	string	是	目标日期时间（要查询的运程时间），格式：YYYY-MM-DD HH:MM:SS
target_data.lat	number	是	目标地点纬度（可与出生地相同）
target_data.lon	number	是	目标地点经度（可与出生地相同）
target_data.tz	number/string	是	目标地点时区，如 8 或 "8" 表示UTC+8，支持小数如 8.5

请求示例

基本请求

{
    "chart_type": "developed",
    "natal_data": {
        "datetime": "1990-06-15 14:30:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "target_data": {
        "datetime": "2025-06-24 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    }
}

返回参数

参数名	类型	说明
success	boolean	请求是否成功
data	object	星盘数据（包含本命盘基础数据和法达盘数据）
data.planets	object	本命盘行星位置数据
data.houses	object	本命盘宫位数据
data.firdaria	object	法达盘核心数据
data.firdaria.day_chart	boolean	是否日生盘（true=日生，false=夜生）
data.firdaria.main_period	object	当前大运信息
data.firdaria.main_period.planet	string	当前大运统治行星（如 "Sun", "Venus" 等）
data.firdaria.main_period.start	string	当前大运开始时间
data.firdaria.main_period.end	string	当前大运结束时间
data.firdaria.sub_period	object	当前小运信息
data.firdaria.sub_period.planet	string	当前小运统治行星
data.firdaria.sub_period.start	string	当前小运开始时间
data.firdaria.sub_period.end	string	当前小运结束时间
data.firdaria.big	array	所有大运列表（包含每个大运的详细时间、年龄等信息）
data.firdaria.small	array	所有小运列表（扁平化数组，每个小运包含其子运列表）
data.firdaria.this_year	number	当前大运在大运列表中的索引
data.firdaria.this_year_vole	number	当前大运的进度（0-1之间的小数）
svg	string	SVG图形数据（如果 include_svg=true）

Python 调用示例

import requests

response = requests.post('https://chart.12sign.top/onechart', json={
    "chart_type": "developed",
    "natal_data": {
        "datetime": "1990-06-15 14:30:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "target_data": {
        "datetime": "2025-06-24 12:00:00",
        "lat": 39.9042,
        "lon": 116.4074,
        "tz": 8
    },
    "include_svg": True
})

result = response.json()
if result['success']:
    firdaria = result['data']['firdaria']
    
    print(f"日生盘: {firdaria['day_chart']}")
    print(f"当前大运: {firdaria['main_period']['planet']}")
    print(f"大运时间: {firdaria['main_period']['start']} ~ {firdaria['main_period']['end']}")
    print(f"当前小运: {firdaria['sub_period']['planet']}")
    print(f"小运时间: {firdaria['sub_period']['start']} ~ {firdaria['sub_period']['end']}")
    
    # 遍历所有大运
    for i, big in enumerate(firdaria['big']):
        print(f"大运{i}: {big['planet_chinese']} ({big['age_start']} ~ {big['age_end']})")

在线测试

请求地址：

https://chart.12sign.top/onechart

请求参数（JSON）：

返回结果：

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

星盘图：

SVG星盘图将在请求成功后显示在这里

法达盘（Firdaria）API文档