Developers

Astrology API

Natal charts, transits, synastry, solar returns, best days and astrocartography as JSON, computed with the Swiss Ephemeris. Build a horoscope app, a compatibility feature or an AI astrologer on numbers you can check.

✦ Swiss Ephemeris✦ 10 requests a day free✦ No AI calls

Updated · Next review

The NatalChart.AI API is the calculation engine of the NatalChart.AI app, opened to developers. Send a birth date, time and coordinates, get the chart back: no ephemeris files to host, no time-zone tables to maintain, no astrology library to keep up to date.

What you can build

Birth chart pages

Sun, Moon and rising sign, every planet in its sign and house, the aspects with orbs and the element balance, for any birth from 1800 to 2399. /v1/chart/full, /v1/chart/short

Daily horoscopes from the real sky

The day's transits to a person's chart, each with its orb and whether it is building or fading, plus the Moon's phase and the week's sky events. /v1/horoscope/daily, /v1/sky

Compatibility for dating products

Two charts compared: every aspect between them, where each person's planets fall in the other's houses, and a score for each life sphere. /v1/synastry

Forecasts and the year ahead

The exact transits in a window of up to 92 days (up to 60 events, the most significant first), and the solar return chart for any year, at the birth place or wherever the person will be. /v1/transits, /v1/solar-return

Best days

Each day of a window scored for an activity (business, romance, travel, health and more), with the transits for and against it. /v1/timing

Astrocartography and relocation

One city scored against a chart, or the major cities of the world ranked for it, by life sphere and region. /v1/locations/score, /v1/locations/rank

Start in a minute

Create a key in the app's Settings, on the API & MCP tab (free, no card), then send a birth:

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}}'

Every endpoint, field and error is in the API documentation, and the OpenAPI document describes them for code generators.

Accuracy you can check

Tropical zodiac, Placidus houses, the five major aspects, true lunar node, positions to four decimals of a degree. The time zone is resolved from the coordinates with the daylight-saving rules of the birth date, and an unknown birth time withholds the houses and angles instead of guessing them. The accuracy report compares the engine with NASA JPL Horizons, and the published demonstration chart lets you check a response before you write any code.

For AI assistants: the MCP server

The same calculations are an MCP server at https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor and VS Code connect with the same key and call the chart, transit and compatibility tools themselves, so an assistant reads a chart that was computed rather than guessed.

Pricing

PlanPriceRequestsEndpoints
Free$010 a dayCharts and their parts, daily horoscope, sky, usage
Premium$9.99 a month or $79 a year100 a dayEverything: transits, synastry, solar returns, best days, locations
MAX$19.99 a month or $179 a yearNo daily limitEverything: transits, synastry, solar returns, best days, locations

Premium and MAX are the NatalChart.AI app's plans: one subscription covers the app, the API and the MCP server. The pool is per account, shared by all its keys, and refills at 00:00 UTC. A request rejected as invalid is not counted, one that fails on our side is given back, and birth data is never stored: the log keeps the endpoint, the status and the time only.

How it compares

Seven astrology APIs side by side, from each provider's own pricing page, checked on 16 October 2026. Prices change, so follow the links before you decide.

APIFree tierCheapest planHow calls are countedMCP server
NatalChart.AI10 requests a day on the basic endpoints, no cardPremium: $9.99 a month for 100 requests a day (about 3,000 a month). MAX: $19.99 a month, no daily limit. Both with every endpoint, the app and the MCP server.One request per call, whatever the endpointYes, 10 tools, on the free key too
AstrologyAPI.comTest calls, no card$49 a month for 50,000 requests a month (Western natal data and chart wheel); synastry from $99Requests by plan, or a credit walletYes
Astrology-API.io50 requests a month$11 a month for 1,000 requests a monthOne credit per call; a few endpoints cost moreYes
FreeAstroAPI80 requests a day, no card$8 a month for 50,000 requests a monthOne request per callYes
Prokerala5,000 credits a month$19 a month for 100,000 creditsCredits weighted by endpoint (a Western natal chart is 500)No official server
RoxyAPINone (a playground without sign-up)$39 a month for 50,000 requests a monthOne request per callYes
AstroWay10,000 credits a month$5 a month for 50,000 creditsCredits weighted by endpointYes

What this API does not do: other zodiacs or house systems, chart images, PDF reports, Vedic astrology, written interpretations. Several of the APIs above offer those. What it does: every calculation for one flat request, an accuracy report against NASA JPL Horizons, and birth data that is never stored.

Questions

Is there a free astrology API?

Yes. A NatalChart.AI key is free and gives 10 requests a day: natal charts in full or in parts, the daily sky with transits to a chart, and planetary positions for any date. No card is needed. Premium ($9.99 a month) raises the pool to 100 a day and opens transits for a period, synastry, solar returns, best days and astrocartography, and MAX ($19.99 a month) has no daily limit. Both are plans of the NatalChart.AI app, so one subscription covers the app, the API and the MCP server.

How accurate are the calculations?

Positions come from the Swiss Ephemeris, the standard of professional astrology software, with its data files and the speed flag on. The same engine draws every chart in the NatalChart.AI app, and the accuracy report compares its output with NASA JPL Horizons.

Can I build a horoscope or compatibility app on it?

Yes, that is what it is for: birth chart pages, daily horoscopes from real transits, compatibility scores for dating products, best-day pickers and relocation maps. Commercial use is allowed on every plan; keep the key on your server.

Does it return written interpretations?

No. The API computes and returns numbers: signs, degrees, houses, aspects with orbs, scores per life sphere. There are no AI calls, so the same input always gives the same output, and the words stay yours or your model's.

Which languages and frameworks does it work with?

Anything that can send an HTTPS request with a JSON body: JavaScript, Python, PHP, Swift, Kotlin, no-code tools. The documentation has copy-paste examples, and an OpenAPI document describes every endpoint for code generators.

Can AI assistants use it?

Yes, through the MCP server: Claude, ChatGPT, Cursor and VS Code connect to it with the same key and call the calculations as tools.

Ready to see your real chart?

Generate my free chart