Western Astrology

Eclipses

Solar and lunar eclipses in a date range, past or future, up to 10 years. Each gives the type, time of greatest eclipse, start and end (UTC) and the eclipse degree in the tropical zodiac (Swiss Ephemeris). Add birth data to get, for each eclipse, the natal planets and angles within 3° of the eclipse degree by conjunction or opposition. Without a birth time the Ascendant and MC are skipped and the natal Moon is approximate.

post/v1/western/eclipses

Request

  • Base URL: https://api.asterwise.com
  • URL: https://api.asterwise.com/v1/western/eclipses
  • Auth: HTTP bearer

Request body

from_datestring required

First day of the range (YYYY-MM-DD, UTC).

to_datestring required

Last day of the range (YYYY-MM-DD, UTC, inclusive). At most 10 years after from_date.

house_system'placidus' | 'koch' | 'equal' | 'whole_sign'

House system used to compute the natal Ascendant and MC.

Example request

{
  "from_date": "2026-01-01",
  "to_date": "2026-12-31",
  "birth": {
    "ayanamsa": "lahiri",
    "date": "1985-11-12",
    "latitude": 19.055,
    "location": "Mumbai",
    "longitude": 72.8692,
    "name": "Arjun Mehta",
    "time": "06:45",
    "timezone": "Asia/Kolkata"
  }
}

Response

Successful Response

successboolean

True if the request succeeded

messagestring

Human-readable status message

Example response

{
  "data": {
    "eclipses": [
      {
        "natal_contacts": [
          {
            "natal_point": "Sun"
          }
        ]
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.