Natal Transit Timing Weekly API

Natal Transit Timing Weekly

Calculates the precise timing of every transit-to-natal aspect perfection across a full 7-day window. For each transiting planet forming an aspect to a natal planet, this endpoint identifies the exact date and time the aspect becomes exact (perfects) during the week, along with the active orb window during which the aspect is in effect. It is the weekly counterpart to Natal Transit Timing Daily, and the timing-focused counterpart to Natal Transit Weekly.

What This API Returns

For each transit-to-natal aspect active during the 7-day period, the response provides:

• The transiting planet and the natal planet involved in the aspect

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

• The exact perfection date and time — the moment the aspect becomes mathematically exact

• The active window — the start and end times during which the aspect is within orb

• Aspect strength and directional motion context (direct/retrograde)

Main Use Cases

• Weekly astrological planning — Identify the most significant planetary triggers across an entire week at a glance, with precise timing for each

• Event timing — Pinpoint the exact moment a transit perfects to time decisions, launches, or important actions

• Predictive astrology workflows — Build weekly transit reports or forecasts that go beyond listing active aspects to showing when each one peaks

• Comparative analysis — Use alongside Natal Transit Weekly to enrich aspect listings with perfection timing data

• Scheduling tools — Power applications that help users plan their week around astrological windows

Key Functionality

• Covers a full 7-day window, making it ideal for weekly reports and planning tools — a broader scope than the daily timing variant

• Supports filtering via aspectsType (all, major, or none) to control which aspects are included in the analysis

• Accepts a complete natal birth profile (date, time, geographic coordinates, and timezone) to compute personalized transit-to-natal aspects

• Localization is supported via the Accept-Language header, enabling multi-language responses

• Configurable astrological settings via headers: Ayanamsha system, house system, and node type (mean/true) — allowing the results to align with different Western astrological traditions