Find Eclipses
find_eclipsesRead-onlyIdempotent
Search lunar and solar eclipses in a date range up to 30 years. Returns the sign and longitude of the eclipsed luminary, and optionally shows local solar eclipse visibility.
Instructions
Find lunar and solar eclipses in a date range (max 30 years), with the sign and longitude of the eclipsed luminary — the astrologically relevant datum.
When latitude/longitude are provided, each solar eclipse also reports whether it is visible from that location and how much of the Sun is obscured there.
Examples:
"Eclipses in 2026" -> { from_datetime: "2026-01-01", to_datetime: "2027-01-01" }
"Will I see the August 2026 eclipse from Riga?" -> add latitude: 56.95, longitude: 24.11
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| types | No | Restrict to lunar or solar eclipses. Default: both. | |
| latitude | No | Observer latitude for local solar-eclipse visibility. | |
| longitude | No | Observer longitude for local solar-eclipse visibility. | |
| to_datetime | Yes | End of the search window (max 30 years after start). | |
| from_datetime | Yes | Start of the search window. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| eclipses | Yes |