logo

Complete Natal Chart Details

Natal planetary positions, house cusps, natal chart aspects and much more in a single API.

Get dominant element, dominant mode and hemisphere along with moon phase at the time of birth.

We offer both bite-sized contents that you can show in an app for free and detailed interpretation APIs for premium users.

Get StartedGet a demo
Natal Chart

Detailed planetary positions

Get the snapshot of planetary position during birth time. Reveal how planets are placed in the natal chart with planetary position API.

image

House Cusps Calculation

The API provides an idea of planets near or far from the house cusp. Know which planetary influence is increased or decreased based on vicinity of the planet near/far from house cusp.

image

Natal Aspects with Custom Orbs

Know how various planet and sign energies play out with Natal Aspect. Get the exact deviation from the aspect with Custom Orbs. The API provides accurate aspects and orbs at the time of birth.

Dominant Element and Modes

Learn the dominant element from the basic four elements of fire, earth, air and water. Also get the modality or modus operandi with these simple API.

Detailed Natal Chart Interpretation

Reveal hidden treasure of birth chart with detailed Natal chart interpretation API. Get accurate readings for natal chart with precise calculations.

image

What our natal chart API returns

A natal chart, also called a birth chart, is a map of the sky at the moment a person was born. It shows where each planet was, which zodiac sign it was in and which house it fell in. Our natal chart API works this out for any birth date, time and place.

We use the tropical zodiac, the sign system of Western astrology. You send one set of birth details and we return clean JSON. Draw your own chart from it, show short facts to free users, or add longer readings for paying users.

Each part of the chart has its own endpoint. Call western_horoscope for the whole chart in one go. Call planets/tropical or house_cusps/tropical when you only need one piece.

  • Planet positions

    The Sun, the Moon and the planets out to Pluto, plus the Node, Chiron and Part of Fortune. Each comes with sign, degree, house and a retrograde flag.

  • House cusps

    Houses are the 12 areas of life in a chart. We return where each one starts, with sign and degree, plus the ascendant, midheaven and vertex.

  • Aspects

    An aspect is an angle between two planets, such as a conjunction or a trine. Each one has a type and an orb, which is how far it is from exact.

  • Elements and modes

    The share of fire, earth, air and water in the chart, and of cardinal, fixed and mutable signs. We name the dominant one and explain it in plain words.

  • Hemispheres and birth moon

    Which half of the chart carries the most weight, east or west and north or south. Also the moon phase the person was born under.

  • Chart wheel image

    A drawn natal wheel as SVG or PNG, in your own colours and size.

Four calls that build a birth chart

Every call is a POST with the same birth fields: day, month, year, hour, min, lat, lon and tzone. Add house_type to choose the house system. These samples are trimmed from our docs.

Base URL: https://json.astrologyapi.com/v1

POST/western_horoscope

The full birth chart in one call

Planets, houses, ascendant, midheaven, vertex, Lilith and the aspects between planets. Lilith is a point tied to the Moon’s orbit. Set is_asteroids to true to add asteroids.

1{
2  "planets": [
3    { "name": "Sun", "norm_degree": 5.6427, "sign": "Capricorn", "house": 2 },
4    { "name": "Moon", "norm_degree": 12.271, "sign": "Aries", "house": 5 },
5    { "name": "Mars", "norm_degree": 22.2381, "sign": "Scorpio", "house": 12 }
6  ],
7  "houses": [{ "house": 1, "sign": "Sagittarius", "degree": 240.71431 }],
8  "ascendant": 240.71431015862024,
9  "midheaven": 156.92135925483103,
10  "lilith": { "name": "Lilith", "sign": "Leo", "house": 9 },
11  "aspects": [
12    {
13      "aspecting_planet": "Sun",
14      "aspected_planet": "Mercury",
15      "type": "Conjunction",
16      "orb": 2.66
17    }
18  ]
19}
Read the /western_horoscope reference →
POST/planets/tropical

Planet positions only

A lighter call for a simple placements list. We return each planet and the ascendant with sign, degree, speed, house and isRetro. Retrograde means the planet seems to move backwards from Earth.

1[
2  { "name": "Sun", "sign": "Sagittarius", "house": 11, "isRetro": "false" },
3  { "name": "Moon", "sign": "Cancer", "house": 7, "isRetro": "false" },
4  { "name": "Mercury", "sign": "Sagittarius", "house": 12, "isRetro": "true" },
5  { "name": "Ascendant", "sign": "Capricorn", "house": 1, "isRetro": "false" }
6]
Read the /planets/tropical reference →
POST/house_cusps/tropical

House cusps and chart angles

A cusp is the line where one house begins. We return all 12 cusps with sign and degree. The ascendant, midheaven and vertex come back in degrees.

1{
2  "houses": [
3    { "house": 1, "sign": "Cancer", "degree": 114.19653 },
4    { "house": 2, "sign": "Leo", "degree": 141.2691 },
5    { "house": 3, "sign": "Virgo", "degree": 171.57387 }
6  ],
7  "ascendant": 138.21237548900893,
8  "midheaven": 47.54697697669932,
9  "vertex": 235.92360650178892
10}
Read the /house_cusps/tropical reference →
POST/natal_chart_interpretation

Chart patterns and readings

Everything in western_horoscope, plus the moon phase at birth, the hemisphere balance, the element and mode split, and the dominant sign. Most of these include a short written reading.

1{
2  "elements": {
3    "elements": [
4      { "name": "Fire", "percentage": 0 },
5      { "name": "Earth", "percentage": 16.666 },
6      { "name": "Air", "percentage": 75 },
7      { "name": "Water", "percentage": 8.333 }
8    ],
9    "dominant_element_id": 3
10  },
11  "modes": {
12    "modes": [
13      { "name": "Cardinal", "percentage": 16.666 },
14      { "name": "Fixed", "percentage": 41.666 },
15      { "name": "Mutable", "percentage": 41.666 }
16    ],
17    "dominant_mode_id": 2
18  },
19  "dominant_sign": { "sign_id": 3, "sign_name": "Gemini", "percentage": 26.38 }
20}
Read the /natal_chart_interpretation reference →

Who uses a birth chart API

More than 3,000+ businesses build on AstrologyAPI. Here is how teams put natal chart data to work.

Horoscope and astrology apps

Build a “my chart” screen from one call. Show the Sun, Moon and rising sign first, then the full planet list. The rising sign is the ascendant.

Western birth chart integration guide →

Web and mobile developers

Follow a working example that renders a chart page in a React app.

Build a birth chart app with Next.js →

Dating and social apps

Save each user’s natal chart once. Then compare two charts with our synastry endpoints.

Synastry API →

Report sellers

Turn the same birth details into a natal report PDF with your logo on it.

Western PDF Report API →

AI astrology chat

Give your chatbot real chart data, so it never guesses planet positions.

Why ChatGPT can’t calculate birth charts →

Docs and guides for natal charts

Read the reference first. Then pick the guide that fits your stack.

Natal chart API FAQ

What is a natal chart API?

It is an API that works out a birth chart for you. You send a birth date, time and place. We return the planets, houses, aspects and short readings as JSON, ready to show in your app.

Is a natal chart the same as a birth chart?

Yes. Natal chart and birth chart are two names for the same thing. Both describe the sky at the exact moment a person was born.

What do I need to send?

Send the birth date (day, month, year) and the local birth time (hour, min). Add the birth place as lat and lon, and tzone, the UTC offset at that moment. Most natal endpoints also need house_type, such as placidus.

Can I get the chart as an image?

Yes. natal_wheel_chart returns a chart_url that links to a drawn chart wheel. Set image_type to svg or png and pick a chart_size. You can also choose the colours for planet icons, sign icons and backgrounds.

Which languages are supported?

western_horoscope, planets/tropical, house_cusps/tropical and natal_chart_interpretation support English, Spanish, Portuguese, French, Italian, German and Russian. Some longer report endpoints, such as natal_aspects_report, are in English only.

How can I try it?

Sign up for free and we give you an API key with 150 free credits. Call western_horoscope with your own birth details first.

Get started with AstrologyAPI

Create a free account and test every endpoint with free credits. No credit card needed.

Products
Astrology APIPDF APIHoroscope APIGeo Location APIAstroPagesAstrocartography APIHuman Design API
Astro AI
Astro-Chat APIPalmistry APIFace Reading APIVastu APIAudio Reports APIMCP Servers
Solutions
Vedic AstrologyWestern AstrologyHoroscopeNumerologyTarot Readings
Use Cases
Astrology AppsMatrimonial/DatingJewellery & GemstonesMedia and EntertainmentUtility and Lifestyle
Developers
Get Started GuideAPI ReferenceGuides & TutorialsBlogDownload SDKPostman CollectionWordPress Plugins
More Links
PricingAbout UsContact UsSchedule a DemoPrivacy PolicyTerms of UseRefund and Cancellation
astrology api logo© 2026 AstrologyAPI. All rights reserved.
facebooktwitter