Natal Transit Weekly API

Natal Transit Weekly

The Natal Transit Weekly endpoint provides a comprehensive overview of transit-to-natal planetary aspects spanning a full 7-day window. It compares the positions of transiting planets across the entire week against the fixed planetary positions in an individual's natal (birth) chart, revealing how current celestial movements interact with a person's unique astrological blueprint over the course of the week.

What This API Does

This API calculates and returns all significant planetary aspects formed between transiting planets and natal planets for each day within the current week. By evaluating the week as a whole, it offers a broader astrological perspective than a single-day snapshot — allowing users to see how energies build, peak, and shift across multiple days.

It is the weekly counterpart to the Natal Transit Daily endpoint. While the daily endpoint focuses on aspects active on a specific day, this endpoint aggregates transit-to-natal aspect data across the full 7-day period, giving a holistic view of the week's astrological influences.

What Data It Returns

The response delivers a structured breakdown of transit-to-natal aspects for each day of the week, typically including:

• Transiting planet — the planet currently moving through the sky

• Natal planet — the planet in the individual's birth chart being aspected

• Aspect type — the angular relationship between the two planets (e.g., conjunction, opposition, trine, square, sextile)

• Aspect strength or orb — how exact or wide the aspect is

• Day-by-day listing — aspects organized across the 7-day window so users can track how influences evolve throughout the week

The scope of aspects returned is controlled by the aspectsType field, which can be set to return all aspects, only major aspects, or none.

Main Use Cases

• Weekly astrological forecasting — Generate personalized weekly horoscopes or transit reports for individuals based on their birth data

• Astrology applications & platforms — Power weekly transit widgets, dashboards, or reports in consumer-facing astrology apps

• Personal planning tools — Help users identify favorable or challenging days within the week based on their natal chart interactions

• Astrological research — Analyze patterns in transit-to-natal aspect activity over weekly cycles

• Comparative analysis — Use alongside the Natal Transit Daily endpoint to drill down from a weekly overview into specific daily details

Key Functionality

• Full 7-day transit window — Covers the entire current week rather than a single day, providing a complete weekly astrological picture

• Natal chart integration — All transit aspects are calculated relative to the individual's personal birth chart, making results unique to each person

• Flexible aspect filtering — The aspectsType parameter allows control over whether all aspects, only major aspects, or no aspects are included in the response

• Localization support — Planet names, aspect names, and other labels can be returned in different languages via the Accept-Language header

• Configurable astrological settings — Supports multiple ayanamsha systems, house systems, and node types, enabling compatibility with various Western astrological traditions

• Precise birth data input — Accepts full birth date, time, and geographic coordinates to ensure accurate natal chart calculations