Solar Return API

The solar-return endpoint first reads the natal Sun's exact zodiacal longitude from the supplied birth data, then searches the given year for the precise moment the transiting Sun returns to that same longitude — typically within a day or so of the calendar birthday. It resolves that return instant to a Julian day, pulls geocentric positions and speeds from the Swiss Ephemeris engine, and casts a full chart for it: the return planets with signs and house placements, the house cusps, and the complete aspect grid with applying and separating flags and exact orbs. The match is tropical and Sun-to-natal-Sun, not precession-corrected by default, so the return Sun sits on the natal Sun's tropical degree. The resulting chart is read as the dominant theme map for the year running from one birthday to the next.

curl -X POST https://api.astroway.info/v1/solar-return \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Sun",
        "longitude": 54.23,
        "sign": "Taurus",
        "house": 9
      }
    ],
    "houses": {
      "ascendant": 188.2,
      "mc": 95,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

Use the solar return for annual forecasting — a 'year ahead' report, a birthday-chart feature, or an AI flow that builds a twelve-month outlook from a single dated chart. It is the workhorse of return-based prediction: the angles, the house the return Sun falls in, and the tightest aspects are read as the headline themes for that solar year. Pair it with transits and progressions for depth, but the solar return alone gives a clean, self-contained yearly snapshot keyed to the person's own birthday rather than the calendar. Because you pass only natal data plus a year, it slots neatly into anniversary triggers and scheduled annual emails — recompute each year to roll the forecast forward.

The return is matched tropically, Sun to natal Sun, and is not precession-corrected by default, so it reflects the conventional Western solar return rather than the sidereal-corrected variant. It is cast for the natal location supplied; relocated solar returns would require recasting at a different place. Tropical zodiac and Swiss Ephemeris throughout.