Current Transits
astral_current_transitsRead current or date-specific planetary transits against a natal chart to see active aspects, upcoming activation windows, and moon phase for your personal astrology questions.
Instructions
Read the current (or a chosen date's) planetary transits against a natal chart. Returns the active transit aspects to the natal planets and angles, upcoming activation windows over the next days, and the current moon phase. Supply the same birth data you would for a natal chart; pass on_date/on_time to read a specific moment. Useful for 'what's happening for me astrologically' questions. Set privacy_mode=summary for just the moon phase and top transit aspects (omitting the full current-sky planet map), 'structured' for a leaner payload, or 'full' (default) for everything.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zodiac | No | Zodiac. 'tropical' (Western, season-anchored) or 'sidereal' (Vedic/constellation-anchored). | tropical |
| on_date | No | Local date to read transits for as YYYY-MM-DD. Defaults to today. | |
| on_time | No | Local time of the transit reading as 24h HH:MM. Defaults to noon. | |
| latitude | Yes | Birth latitude in decimal degrees, -90..90. Resolve from a city name with astral_search_birthplace if you don't have it. | |
| timezone | Yes | IANA timezone of the BIRTHPLACE at birth, e.g. America/Fortaleza. Not the caller's timezone. astral_search_birthplace returns this for each match. | |
| longitude | Yes | Birth longitude in decimal degrees, -180..180 (negative = West). Resolve with astral_search_birthplace if unknown. | |
| birth_date | Yes | Birth date as YYYY-MM-DD, e.g. 1989-02-23. Years before 1900 and after 2100 are supported but less precise. | |
| birth_time | No | Local birth time as 24h HH:MM, e.g. 14:30. Optional — if unknown, noon is assumed and house/ascendant accuracy drops (planets stay accurate). | |
| house_system | No | House system. 'placidus' is the modern default; 'whole-sign' is common in traditional/Hellenistic work; others: koch, campanus, regiomontanus, topocentric, equal-house. | placidus |
| privacy_mode | No | Payload verbosity — how much of the chart to return, independent of response_format (which only picks markdown vs json). 'full' (default) returns the complete payload: every planet, house and aspect plus the per-planet precision audit. 'structured' keeps the full structure but drops redundant/derivable fields (absolute longitudes, element/modality, the precision audit rows) for a leaner machine payload. 'summary' returns only the high-signal essentials (luminaries + Ascendant, dominant element/modality, chart pattern, top aspects, precision status) to save tokens. Request 'summary' for a quick read, 'full' when you need every placement. | full |
| include_angles | No | Include transits to the Ascendant and Midheaven. Requires an accurate birth_time to be meaningful. | |
| response_format | No | Output shape. 'markdown' is a readable briefing for display; 'json' returns the full structured chart for further processing. | markdown |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| moon | Yes | ||
| note | No | ||
| abridged | No | ||
| timezone | Yes | ||
| upcoming | Yes | ||
| localDate | Yes | ||
| localTime | Yes | ||
| highlights | Yes | ||
| generatedAt | Yes | ||
| privacy_mode | No | ||
| currentPlanets | Yes |