Natal Transit Monthly API

Natal Transit Monthly

The Natal Transit Monthly API calculates and returns transit-to-natal planetary aspects across an entire calendar month. For each day of the specified month, it compares the positions of transiting planets against the planets in an individual's natal (birth) chart, producing a comprehensive month-long astrological transit picture.

This endpoint is the monthly counterpart to the Natal Transit Daily and Natal Transit Weekly endpoints, offering a broader temporal view of how current planetary movements interact with a person's natal placements over a full month.

What This API Returns

For each day of the requested month, the API returns the active aspects formed between transiting planets and natal planets. Each aspect entry typically includes:

• The transiting planet and natal planet involved

• The type of aspect formed (e.g., conjunction, opposition, trine, square, sextile)

• Aspect strength or orb information

• Localized planet and aspect names (based on the Accept-Language header)

The response covers all days of the month in a single call, making it efficient for generating monthly transit calendars or summaries.

Main Use Cases

• Monthly horoscope generation — Build personalized monthly transit reports for users based on their birth data.

• Astrological planning tools — Help users identify favorable or challenging periods within a month by highlighting key transit-to-natal aspects.

• Transit calendars — Populate day-by-day transit calendars with aspect data for an entire month at once.

• Comparative transit analysis — Use alongside the Daily and Weekly endpoints to offer users transit insights at different levels of granularity.

• Astrology apps and dashboards — Power monthly overview screens that display a user's most significant planetary influences.

Key Functionality

• Full-month coverage — Computes transit-to-natal aspects for every day of the given month in a single request, eliminating the need for repeated daily calls.

• Aspect filtering — The aspectsType field controls which aspects are included in the response: all returns every aspect, major returns only the most significant aspects (conjunction, opposition, trine, square, sextile), and none can be used to suppress aspect data.

• Natal chart anchoring — The birth date, time, and geographic coordinates provided in the request body define the individual's natal chart, which serves as the fixed reference point for all transit comparisons throughout the month.

• Ayanamsha support — The X-Ayanamsha header allows the calculation to be performed using different ayanamsha systems, accommodating various Western and Vedic astrological traditions.

• House system flexibility — The X-House-Type header lets you specify the house system (e.g., Placidus, Whole Sign, Koch) used in the natal chart calculations.

• Node type selection — The X-Node-Type header controls whether the True Node or Mean Node is used for lunar node calculations.

• Localization — The Accept-Language header enables localized names for planets, signs, and aspects, supporting multi-language astrology applications.