行运 API

请求

针对演示星盘、为期一个月的真实请求：

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

响应

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

返回内容

• window：你请求的日期范围。
• events：行运天体与本命天体形成的精确相位、进入星座和停滞，最多 60 个，按日期排列，每个都附有 UTC 时刻、位置和涉及的宫位。时间段内的事件更多时，保留最重要的那些。
• activeOnFirstDay：第一天就已在容许度以内的行运，以及所用的容许度。
• 每个事件都根据所涉及的天体标有重要程度（high、medium 或 low）。

限制

• 仅限 API Pro，每个请求最长 92 天、最多 60 个事件。用免费密钥调用时，该端点返回 403，并附带升级链接。
• 支持 1800 年至 2399 年间的出生日期。行运涉及的宫位需要出生时间；没有出生时间时，宫位不予给出。
• 每个精确时刻都用 Swiss Ephemeris 搜索得出，并以 UTC 给出。
• 出生信息读取、使用之后即被忘掉：请求体从不保存。

在 AI 助手中

通过位于 https://www.natalchart.ai/mcp 的 MCP 服务器，助手调用 transits 工具获取一段时间内的行运，调用 daily_transits 获取单日行运，读到的是真实的行运，而不是猜出来的。

API 的其他功能

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

常见问题