logo

Transit and Forecast API

Whether you need current sky positions of planets or personalised transits with custom orbs, we have got you covered.

We also offer daily, weekly, monthly and yearly personalised transit interpretation APIs.

Sign up fo freeSchedule a demo
Transit API

Current planetary transits

Get the current planetary transits to create your own yearly transit calendar. Integrate the current transit API to provide major transits to users well before time.

image

Personalised transit details

The API reveals the current ongoing movements of planets as they transit natal chart. Integrate the personalised transit details for your business now.

image

Transit interpretations

Check the detailed transit interpretations

image

Personal transits for each day, week and month

A transit is a moving planet compared with a birth chart. When a moving planet forms an angle to a birth planet, astrologers read it as a theme for that time. Our Transit API finds these links for you.

You send a person’s birth details. We return the transits for a day, a week or a month as JSON. Each transit names the moving planet, the birth planet and the aspect between them.

We offer two styles. natal_transits gives start, exact and end times for each transit. tropical_transits adds the house each planet is passing through, retrogrades and moon phases.

  • Transit aspects

    Each transit names the moving planet, the birth chart planet and the aspect type, such as square or trine.

  • Timing

    start_time, exact_time and end_time show when a transit begins, becomes exact and ends.

  • Transit houses

    Which house of the birth chart each planet is passing through on that day.

  • Retrogrades

    Planets that seem to move backwards during the period.

  • Moon phases

    The monthly forecast lists each moon phase with its date, sign and house in the birth chart.

  • Three time frames

    Daily and weekly natal transits, plus daily, weekly and monthly tropical transits.

Transit endpoints, with real responses

Each call is a POST with the birth fields day, month, year, hour, min, lat, lon, tzone and house_type. The response states the period it covers. Samples are trimmed from our docs.

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

POST/natal_transits/daily

Daily natal transits

Transits for transit_date, with start, exact and end times. Each one also gives the transit sign, the natal house and a retrograde flag.

1{
2  "transit_date": "8-13-2024",
3  "ascendant": "Libra",
4  "transit_relation": [
5    {
6      "transit_planet": "Sun",
7      "natal_planet": "Sun",
8      "aspect_type": "Square",
9      "start_time": "2024-08-08 23:23:57",
10      "exact_time": "2024-08-12 02:27:10",
11      "end_time": "2024-08-15 05:26:33",
12      "is_retrograde": false,
13      "transit_sign": "Leo",
14      "natal_house": 11
15    }
16  ]
17}
Read the /natal_transits/daily reference →
POST/natal_transits/weekly

Weekly natal transits

Every transit between start_date and end_date, with its exact time. It suits a weekly email or a planner view.

1{
2  "start_date": "1-25-2023",
3  "end_date": "2-1-2023",
4  "natal_ascendant": "Sagittarius",
5  "transit_relation": [
6    {
7      "transit_planet": "Sun",
8      "natal_planet": "Mercury",
9      "aspect_type": "Conjunction",
10      "start_time": "2023-01-23 05:57:47",
11      "exact_time": "2023-01-25 05:08:14",
12      "end_time": "2023-01-27 04:20:14"
13    }
14  ]
15}
Read the /natal_transits/weekly reference →
POST/tropical_transits/daily

Daily tropical transits

Transit houses and transit aspects with their orb, which is the distance from exact. Any retrogrades come back too. Use it for a short daily forecast.

1{
2  "transit_date": "17-6-2017",
3  "ascendant": "Leo",
4  "transit_house": [
5    {
6      "planet": "Sun",
7      "natal_sign": "Taurus",
8      "transit_house": 11,
9      "is_retrograde": false
10    }
11  ],
12  "transit_relation": [
13    {
14      "transit_planet": "Sun",
15      "natal_planet": "Jupiter",
16      "type": "Sextile",
17      "orb": 0.66
18    }
19  ],
20  "retrogrades": []
21}
Read the /tropical_transits/daily reference →
POST/tropical_transits/monthly

Monthly tropical transits

The month’s transit aspects with dates, plus retrogrades and the moon phases that fall in that month.

1{
2  "month_start_date": "1-6-2017",
3  "month_end_date": "30-6-2017",
4  "transit_relation": [
5    {
6      "transit_planet": "Mars",
7      "natal_planet": "Moon",
8      "type": "Trine",
9      "orb": 3.84,
10      "date": "1-6-2017"
11    }
12  ],
13  "moon_phase": [
14    {
15      "phase_type": "Full Moon",
16      "date": "2017-06-09T13:11:00.000Z",
17      "sign": "Sagittarius",
18      "house": 5
19    }
20  ]
21}
Read the /tropical_transits/monthly reference →

Who builds with transit data

More than 3,000+ businesses use AstrologyAPI. Transits are what make a forecast personal.

Daily horoscope apps

Write daily readings from each user’s real transits instead of general sun sign text.

How to automate daily horoscope content →

Alert and reminder apps

Send a push note on the day a transit you care about becomes exact.

Building a transit alert system →

AI astrology chat

Answer “what is going on for me this week” with real transit data, not a guess.

Ground an LLM on computed charts →

Yearly forecast products

Pair monthly transits with a solar return chart for a full view of the year.

Solar Return API →

Docs and guides

Read the reference for every field. The guides show transits inside real products.

Transit API FAQ

What is a transit API?

It compares where the planets are moving with a person’s birth chart. We return the aspects they form, with timing, for a day, a week or a month.

How do natal_transits and tropical_transits differ?

natal_transits is about timing. It gives start, exact and end times for each transit. tropical_transits gives orbs, transit houses, retrogrades and moon phases. You can use both together.

Which periods can I request?

natal_transits comes in daily and weekly versions. tropical_transits comes in daily, weekly and monthly versions. Each response tells you the dates it covers.

Do I need the birth time?

Yes. Transit calls take the full birth details, including hour and min. The ascendant and the houses in the response depend on the birth time.

Which languages are supported?

The transit endpoints return English.

How do I start?

Sign up to get an API key and 150 free credits. Try natal_transits/daily first, since its timing fields are easy to show as a list.

Ready to add this to your app? See our plans and pricing.

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