Annual Profections API

The endpoint takes the birth data and a target date, counts completed years from the birth moment, and advances one whole sign from the ascendant for each of them. The response reports the age it counted, the zero-based index of the sign the year lands on, and the planet ruling that sign as lordOfYear, alongside the natal ascendant, MC, Sun and Moon so you can render the year against the chart without a second call. The house number itself follows directly from the age: the cycle is twelve years long, so the profected house is the age modulo twelve, plus one. Age 36 returns to the first house and therefore to the ascendant's own sign, which is why the sample chart, with an ascendant at 169.97 degrees in Virgo, reports signIndex 5 and Mercury as the lord of that year. Because the count runs from the birth moment rather than the calendar, the profection year turns on the birthday and not on the first of January.

curl -X POST https://api.astroway.info/v1/profections \
  -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,
  "targetDate": "2026-05-15"
}'

{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}

Use profections when you need a timing layer a reader can follow without an ephemeris. Each year has one ruling planet, so a yearly forecast, a birthday report or an AI narrative can be built around a single clear statement rather than a table of transits. It composes especially well with transits and returns: find the lord of the year here, then look at what is happening to that planet by transit, and you have the classical two-step reading in two calls. It also pairs with the solar return, which covers the same year from a different angle. The technique is deliberately coarse. It tells you which department of life is activated and who is in charge of it, not what happens on a given afternoon, so treat it as the frame you hang finer timing on.

Whole-sign profections from the ascendant, one sign per completed year, with the traditional domicile rulers giving the lord of the year. Ages are counted from the birth moment, so the year turns on the birthday. The natal ascendant, MC, Sun and Moon come from the Swiss Ephemeris engine in the tropical zodiac and are returned in degrees.