NatalChart.AI API 就是 NatalChart.AI 应用的计算引擎，现向开发者开放。发送出生日期、时间和坐标，即可拿回星盘：无需托管星历文件，无需维护时区表，也无需不断更新占星库。
你可以构建什么
本命盘页面
太阳星座、月亮星座和上升星座，每颗行星所在的星座和宫位，相位及其容许度，以及元素分布，适用于 1800 年至 2399 年之间的任何出生。 /v1/chart/full, /v1/chart/short
基于真实天象的每日运势
当天对某人星盘的行运，每个都附有容许度以及它正在增强还是减弱，另有月相和本周的天象事件。 /v1/horoscope/daily, /v1/sky
为交友产品提供匹配度
比较两张星盘：两盘之间的每个相位、每个人的行星落入对方的哪些宫位，以及每个生活领域的评分。 /v1/synastry
预测与未来一年
最长 92 天时间段内的每个精确行运，以及任意一年的太阳回归盘，可按出生地或这个人届时所在的地点计算。 /v1/transits, /v1/solar-return
最佳日子
为一段时间内的每一天针对某项活动（商务、恋爱、旅行、健康等）评分，并列出有利和不利的行运。 /v1/timing
占星地图与迁移
对照一张星盘为一座城市评分，或按生活领域和地区，为这张星盘给世界主要城市排名。 /v1/locations/score, /v1/locations/rank
一分钟上手
创建密钥（免费，无需绑卡），然后发送一组出生信息：
curl https://api.natalchart.ai/v1/chart/short \
-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}}'每个端点、字段和错误都写在API 文档中，OpenAPI 文档则为代码生成器描述了它们。
可以核对的精度
回归黄道，普拉西度制（Placidus）宫位，五种主要相位，真交点，位置精确到度的小数点后四位。时区根据坐标并按出生日期的夏令时规则确定；出生时间未知时，宫位和四轴不予给出，而不是去猜测。精度报告将这个引擎与 NASA JPL Horizons 进行了对比，已公开的演示星盘让你在写任何代码之前就能核对响应。
面向 AI 助手：MCP 服务器
同样的计算也以 MCP 服务器的形式提供，地址为 https://www.natalchart.ai/mcp。Claude、ChatGPT、Cursor 和 VS Code 用同一个密钥连接，自行调用星盘、行运和匹配度工具，因此助手解读的是计算出来的星盘，而不是猜出来的。
价格
| 方案 | 价格 | 请求次数 | 端点 |
|---|---|---|---|
| 免费 | $0 | 每天 10 次 | 星盘及其各部分、每日运势、天象、用量 |
| API Pro | 每月 $6.99 | 每天 1,000 次 | 全部：行运、合盘、太阳回归、最佳日子、地点 |
额度按账户计算，在 UTC 时间 00:00 恢复。因无效而被拒绝的请求不计数；出生信息从不保存：日志只记录端点、状态和时间。
常见问题
有免费的占星 API 吗？
有。NatalChart.AI 的密钥免费，每天可发送 10 次请求：完整或分部分的本命盘、当天的天象及其对某张星盘的行运，以及任意日期的行星位置。无需绑卡。API Pro（每月 $6.99）将额度提高到每天 1,000 次，并开放一段时间内的行运、合盘、太阳回归、最佳日子和占星地图。
计算有多准确？
位置来自 Swiss Ephemeris，这是专业占星软件的标准，计算时使用它的数据文件并开启速度标志。NatalChart.AI 应用里的每一张星盘都由同一个引擎绘制，精度报告将它的输出与 NASA JPL Horizons 进行了对比。
可以用它做运势应用或匹配度应用吗？
可以，它就是为此而做的：本命盘页面、基于真实行运的每日运势、交友产品中的匹配度评分、最佳日子选择器和迁移地图。两种方案都允许商业使用；请把密钥保存在你的服务器上。
它会返回写好的解读吗？
不会。API 计算并返回数字：星座、度数、宫位、相位及容许度、各生活领域的评分。它不调用 AI，所以相同的输入总是得到相同的输出，文字部分仍由你或你的模型来写。
它支持哪些编程语言和框架？
任何能发送带 JSON 请求体的 HTTPS 请求的工具都可以：JavaScript、Python、PHP、Swift、Kotlin，以及无代码工具。文档里有可直接复制粘贴的示例，OpenAPI 文档则为代码生成器描述了每个端点。
AI 助手能用它吗？
能，通过 MCP 服务器：Claude、ChatGPT、Cursor 和 VS Code 用同一个密钥连接它，并把这些计算当作工具来调用。