合盘 API

请求

一个真实的请求，对象是两个虚构的人：基辅的演示出生数据，以及纽约的另一组出生数据。

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

响应

这是该请求响应的一部分：只列出主要字段，每个列表只保留前三项。

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

返回内容

• aspects：一张星盘的天体与另一张星盘的天体之间的每个主要相位，附有角度和容许度。
• overlays：每个人的行星落入对方星盘的哪个宫位，双向给出。如果对方的出生时间未知，这一侧为 null，因为宫位取决于出生时间。
• sphereScores：自我、爱情、身体、金钱、家庭、心智，各 0 到 100 分，由两盘之间的相位（60%）和宫位叠加（40%）计算得出。
• scoring：评分背后的规则，写在响应中。它描述的是两张星盘的几何关系，而不是一段关系的未来。

限制

• 仅限 API Pro。用免费密钥调用时，该端点返回 403，并附带升级链接。
• 支持 1800 年至 2399 年间的出生日期。回归黄道，普拉西度制宫位，五种主要相位。
• 不做地理编码：请发送坐标。时区根据坐标确定，并采用出生日期的夏令时规则。
• 出生信息读取、使用之后即被忘掉：请求体从不保存。

在 AI 助手中

位于 https://www.natalchart.ai/mcp 的 MCP 服务器以 synastry 工具的形式提供同样的计算，因此 Claude、ChatGPT 或 Cursor 可以先比较两张星盘，再谈匹配度。

API 的其他功能

同一个密钥可以使用整个占星 API：本命盘、每日行运、合盘、一段时间内的行运、太阳回归、最佳日子和占星地图。每个端点、字段和错误都写在文档中，价格页面则说明了怎样算一次请求。

常见问题