Jaarlijkse Profecties API
Jaarlijkse profecties zijn de eenvoudigste timingtechniek in de hellenistische gereedschapskist en een van de meest gebruikte: de kaart vordert één huis per levensjaar, en de heerser van het teken in dat huis wordt de heer van het jaar. Eén getal in, één planeet uit, en het hele jaar heeft een handtekening.
Jaarlijkse Profecties API
De endpoint neemt de geboortedata en een doeldatum, telt voltooide jaren vanaf het geboortemoment, en vordert één heel teken vanaf de ascendant voor elk van die jaren. De response geeft de getelde leeftijd, de nulgebaseerde index van het teken waarop het jaar landt, en de planeet die dat teken regeert als lordOfYear, naast de natal ascendant, MC, Sun en Moon zodat je het jaar tegen de chart kunt renderen zonder een tweede call. Het huisnummer volgt direct uit de leeftijd: de cyclus is twaalf jaar lang, dus het geprofekte huis is leeftijd modulo twaalf, plus één. Leeftijd 36 keert terug naar het eerste huis en dus naar het eigen teken van de ascendant, daarom geeft de voorbeeldchart, met een ascendant op 169,97 graden in Maagd, signIndex 5 en Mercury als de lord of dat jaar. Omdat de telling vanaf het geboortemoment loopt in plaats van de kalender, draait het profectiejaren op de verjaardag en niet op 1 januari.
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"
}'{
"ok": true,
"data": {
"age": 36,
"signIndex": 5,
"lordOfYear": "Mercury",
"ascendant": 169.9680,
"mc": 77.0743,
"sun": 54.3760,
"moon": 296.9047
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| targetDate | string (YYYY-MM-DD) | yes | 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. |
When to use it
Gebruik profecties wanneer je een timinglaag nodig hebt die een lezer kan volgen zonder een efemeriden. Elk jaar heeft één heersende planeet, dus een jaarlijkse voorspelling, een verjaardagsrapport of een AI-verhaal kun je bouwen rond één duidelijke uitspraak in plaats van een tabel met transits. Het combineert vooral goed met transits en returns: vind hier de lord of het jaar, kijk daarna wat er met die planeet gebeurt via een transit, en je hebt de klassieke twee-stappen lezing in twee calls. Het past ook bij de solar return, die hetzelfde jaar vanuit een andere hoek bekijkt. De techniek is bewust grof. Hij vertelt je welke levenssector geactiveerd wordt en wie erover heerst, niet wat er op een bepaalde middag gebeurt, dus beschouw het als het kader waaraan je fijnere timing hangt.
Notes
Whole-sign profections vanaf de ascendant, één teken per voltooid jaar, met de traditionele domicil-heersers die de lord of het jaar geven. Leeftijden worden geteld vanaf het geboortemoment, dus het jaar draait op de verjaardag. De natal ascendant, MC, Sun en Moon komen uit de Swiss Ephemeris engine in de tropische dierenriem en worden geretourneerd in graden.
Try the Jaarlijkse Profecties API
Grab a key and make your first call in under a minute.