AstroWay/api v2.201.6 · de
alle Systeme in Ordnung
// astrology api · POST /v1/profections

Jährliche Profektionen API

Jährliche Profektionen sind die einfachste Timing-Technik im hellenistischen Werkzeugkasten und eine der am häufigsten genutzten: Das Horoskop wandert jedes Lebensjahr ein Haus weiter, und der Herrscher des Zeichens in diesem Haus wird zum Herrscher des Jahres. Eine Zahl rein, ein Planet raus, und das ganze Jahr hat eine Signatur.

Endpunkt
POST /v1/profections
Kosten
20 Credits
Latenz
~48 ms
Stufe
Tier 2
// 01 / Was es berechnet

Jährliche Profektionen API

Der endpoint nimmt die Geburtsdaten und ein Ziel-Datum, zählt die vollendeten Jahre seit dem Geburtsmoment und wandert für jedes Jahr ein ganzes Zeichen vom Aszendenten weiter. Die response gibt das gezählte Alter, den nullbasierten Index des Zeichens, in dem das Jahr landet, und den Planeten, der dieses Zeichen regiert als lordOfYear, sowie den natalen Aszendenten, MC, Sun und Moon zurück, sodass du das Jahr ohne einen zweiten Aufruf im Chart darstellen kannst. Die Haus-Nummer ergibt sich direkt aus dem Alter: Der Zyklus dauert zwölf Jahre, also ist das profektierte Haus das Alter modulo zwölf plus eins. Alter 36 kehrt zum ersten Haus und damit zum eigenen Zeichen des Aszendenten zurück, weshalb das Beispiel-Chart mit einem Aszendenten bei 169.97° in Jungfrau signIndex 5 und Mercury als Herrscher dieses Jahres meldet. Da die Zählung vom Geburtsmoment und nicht vom Kalender ausgeht, wechselt das Profektions-Jahr am Geburtstag und nicht am 1. Januar.

// 02 / Live-Anfrage

POST/v1/profections

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"
}'
Antwort (Auszug)
{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}
// 03 / Parameter

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date.
time string (HH:MM:SS) ja Local clock time at birth.
timezoneOffset number (hours) ja UTC offset in effect at the birth moment.
latitude number ja Birth-place latitude, decimal degrees (north positive).
longitude number ja Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) ja The date whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1.
// 04 / Wann verwenden

Wann verwenden

Benutze Profektionen, wenn du eine Timing-Ebene brauchst, der ein Leser ohne Ephemeride folgen kann. Jedes Jahr hat einen herrschenden Planeten, also kannst du eine Jahresprognose, einen Geburtstagsbericht oder eine KI-Erzählung um eine klare Aussage herum bauen, statt einer Tabelle von Transiten. Sie lässt sich besonders gut mit Transiten und Rückläufern kombinieren: Finde hier den lord of the year, dann sieh dir an, was mit diesem Planeten durch einen Transit passiert, und du hast die klassische Zwei-Schritt-Lesung in zwei Aufrufen. Sie passt auch zum Solar Return, der dasselbe Jahr aus einem anderen Blickwinkel abdeckt. Die Technik ist bewusst grob. Sie sagt dir, welcher Lebensbereich aktiviert wird und wer dafür verantwortlich ist, nicht, was an einem bestimmten Nachmittag geschieht – betrachte sie also als Rahmen, an dem du feinere Timing-Details aufhängst.

// 05 / Hinweise

Hinweise

Ganzzeichen-Profektionen vom Aszendenten, ein Zeichen pro vollendetem Jahr, wobei die traditionellen Domizil-Herrscher den lord of the year liefern. Das Alter wird seit dem Geburtsmoment gezählt, sodass das Jahr am Geburtstag wechselt. Der natal Aszendent, MC, Sun und Moon stammen aus der Swiss Ephemeris-Engine im tropischen Tierkreis und werden in Grad zurückgegeben.

Jährliche Profektionen-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →