Find Aspect Times
find_aspect_timesFind exact dates when a transiting planet forms an aspect to a natal point, including multiple hits from retrograde loops. Specify natal position by birth data or longitude.
Instructions
Find the exact moments a transiting body perfects an aspect to a natal position — "when exactly does Saturn square my Sun?" Retrograde loops produce multiple hits (typically three) and each is returned.
The natal position can be given two ways:
natal_datetime (+ natal_timezone) and natal_body — computed for you
natal_longitude directly, if already known
Examples:
"When does transiting Saturn square my natal Sun (born 1990-03-15 15:45 Riga)?" -> { transiting_body: "Saturn", aspect: "square", natal_datetime: "1990-03-15T15:45", natal_timezone: "Europe/Riga", natal_body: "Sun", from_datetime: "2026-01-01", to_datetime: "2030-01-01" }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aspect | Yes | Which classical aspect to search for. | |
| natal_body | No | Which natal body/point is aspected. | |
| to_datetime | Yes | End of the search window (max 120 years after start). | |
| from_datetime | Yes | Start of the search window. | |
| natal_datetime | No | Birth date/time (with natal_body). | |
| natal_timezone | No | IANA timezone the datetime is local to, e.g. "Europe/Riga" or "America/New_York". Omit when the datetime already carries Z or a UTC offset. | |
| natal_longitude | No | Natal longitude in degrees, as an alternative to natal_datetime + natal_body. | |
| transiting_body | Yes | The moving body. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes |