占星地图 API

请求

一个真实的请求：演示星盘对照里斯本。

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

响应

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

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

返回内容

• relocated：这张星盘在该地点的上升点和天顶。
• angularPlanets：落在这些轴点上的行星，每颗都附有所在轴点、容许度和强度。
• spheres：自我、爱情、身体、金钱、家庭、心智，各 0 到 10 分，5 分为中性；overall10 是它们的总评。
• strength：有主要行星距某个轴点 2° 以内为强，4° 以内为中等，否则为弱。这些规则随响应一起给出。
• POST /v1/locations/rank 从目录中返回最佳城市，可以按全部六大领域或你选择的领域排名，范围可以是全球或某一地区。

限制

• 仅限 API Pro。用免费密钥调用时，这两个端点都返回 403，并附带升级链接。
• 必须提供出生时间：迁移改变的是四轴，而四轴需要出生时间。
• 排名比较的是 61 个主要城市，而不是地球上的每个地方；其他任何地点都可以用 POST /v1/locations/score 评分。
• 出生信息读取、使用之后即被忘掉：请求体从不保存。

在 AI 助手中

通过位于 https://www.natalchart.ai/mcp 的 MCP 服务器，助手调用 location_score 为一个地点评分，调用 best_cities 获取最佳城市。

API 的其他功能

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

常见问题