太阳回归 API

请求

一个真实的请求：演示星盘 2027 年的太阳回归，按出生地起盘。

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"year":2027}'

响应

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

返回内容

• exactMomentUtc：太阳再次到达本命黄经的时刻，以 UTC 表示。
• location：起盘的地点；除非你另外发送一个地点，否则就是出生地。
• natalSun：计算回归所依据的本命太阳黄经。
• chart：针对这一时刻和地点的完整星盘，结构与本命盘端点相同。

限制

• 仅限 API Pro。用免费密钥调用时，该端点返回 403，并附带升级链接。
• 必须提供出生时间。
• 回归黄道和普拉西度制宫位，与本命盘的设置相同。
• 出生信息读取、使用之后即被忘掉：请求体从不保存。

在 AI 助手中

通过位于 https://www.natalchart.ai/mcp 的 MCP 服务器，助手调用 solar_return 工具，从计算出的星盘解读未来一年。

API 的其他功能

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

常见问题