Natal Transit Timing Monthly API

Natal Transit Timing Monthly

The Natal Transit Timing Monthly endpoint calculates the precise date and time each transit-to-natal aspect perfects (becomes exact) across a full calendar month, anchored to an individual's natal chart. It is the monthly counterpart to Natal Transit Timing Daily and Natal Transit Timing Weekly, and the timing-focused complement to Natal Transit Monthly — delivering the complete month's aspect perfection schedule in a single call.

What This API Does

Given a person's natal birth data and a target month, this endpoint computes every moment during that month when a transiting planet forms an exact aspect to a natal planet or point. Rather than simply listing which transits are active, it pinpoints the exact perfection time for each aspect — the precise instant the angular relationship between the transiting and natal body reaches its defined degree.

What Data It Returns

The response provides a structured monthly schedule of transit-to-natal aspect perfections, including:

• Transiting planet forming the aspect

• Natal planet or point being aspected

• Aspect type (e.g., conjunction, sextile, square, trine, opposition, and others depending on the aspectsType filter)

• Exact perfection date and time for each aspect within the requested month

• Results localized according to the Accept-Language header and adjusted for the specified timezone

Main Use Cases

• Astrological timing and forecasting — Identify the most significant days and times within a month when key natal placements are activated by transiting planets.

• Monthly planning tools — Power calendar-style astrology apps that highlight peak transit moments for a user throughout the month.

• Comparative transit analysis — Use alongside Natal Transit Monthly to enrich active-transit data with exact perfection timestamps.

• Personalized astrology reports — Generate detailed monthly transit reports for clients, showing not just which transits occur but precisely when they peak.

• Research and pattern analysis — Study the distribution and clustering of aspect perfections across a month for a given natal chart.

Key Functionality

• Full-month coverage in one call — Returns all transit-to-natal aspect perfections for the entire calendar month, eliminating the need for multiple daily or weekly requests.

• Aspect filtering via aspectsType — Control which aspects are included: all returns every supported aspect type, major (the default) returns only the five major aspects (conjunction, sextile, square, trine, opposition), and none can be used to suppress aspects.

• Natal chart anchoring — All transit calculations are relative to the individual's natal chart, derived from the supplied birth date, time, geographic coordinates, and timezone.

• Configurable astrological settings — Supports customization of the ayanamsha system, house system, and node type via request headers, allowing the endpoint to serve both Western tropical and other astrological traditions.

• Localization support — The Accept-Language header enables localized planet, sign, and aspect names in the response, making it suitable for multi-language applications.

• Timezone-aware output — Perfection times are calculated and returned relative to the natal timezone, ensuring accurate local-time scheduling.