Natal Transit Timing Daily API

Natal Transit Timing Daily

This endpoint is a precision-focused variant of the Natal Transit Daily API. While the standard natal transit endpoint identifies which transit-to-natal aspects are active on a given day, this endpoint goes further by calculating the exact timing of each aspect — pinpointing the precise moment a transit aspect perfects (becomes exact) within the current day.

What This API Does

Given a person's natal birth data and a target date, this API computes all active transit-to-natal planetary aspects for that day and returns detailed timing information for each one. It determines:

• The exact time of perfection — the moment the transiting planet forms a precise aspect angle with the natal planet

• The ingress and egress times — when the aspect window opens and closes throughout the day

• The active duration — the full window during which the aspect is considered operative

This makes it possible to identify not just which transits are active, but when they are most potent during the day.

What Data It Returns

The response provides a structured list of transit-to-natal aspects active on the specified day, each enriched with timing details:

• Transiting planet and natal planet involved in the aspect

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

• Exact perfection time — the precise time (hour, minute, second) when the aspect is exact

• Ingress time — when the aspect enters its orb of influence

• Egress time — when the aspect exits its orb of influence

• Aspect strength or orb at the moment of perfection

Main Use Cases

• Electional and timing astrology — Identify the single most powerful moment of a transit within a day for planning important actions or decisions

• Daily astrological forecasting — Provide clients or users with hour-by-hour transit timing for personalized daily guidance

• Astrological alert systems — Trigger notifications or events at the exact moment a significant transit perfects

• Transit journaling and research — Record and analyze the precise timing of transits for retrospective or predictive study

• Complementing natal transit reports — Use alongside the Natal Transit Daily endpoint to add a temporal dimension to aspect listings

Key Functionality

• Aspect filtering via aspectsType — Control which aspects are included in the response: all (major and minor), major (conjunctions, sextiles, squares, trines, oppositions), or none (returns timing data without aspect filtering)

• Geographic and timezone sensitivity — Timing calculations account for the observer's geographic coordinates (lat, lon) and timezone (tzone), ensuring locally accurate perfection times

• Full natal chart context — Birth data (date, time, location) anchors all transit calculations to the individual's natal planetary positions

• Localization support — Planet and aspect names can be returned in the requested language via the Accept-Language header

• Configurable astrological settings — Ayanamsha, house system, and node type can be adjusted via request headers to match different Western astrological traditions

Relationship to Other Endpoints

This endpoint complements the Natal Transit Daily endpoint. Where Natal Transit Daily provides a snapshot of which transit aspects are active on a given day, Natal Transit Timing Daily adds the critical dimension of when — making it the go-to endpoint whenever precise timing of astrological influences is required.