AstroWay/api v2.201.6 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/profections

API di Profezioni Annuali

Le profezioni annuali sono la tecnica di timing più semplice nel toolkit ellenistico e una delle più utilizzate: il tema avanza di una casa all'anno di vita, e il governatore del segno su quella casa diventa il signore dell'anno. Un numero in, un pianeta fuori, e tutto l'anno ha una firma.

Endpoint
POST /v1/profections
Cost
20 credits
Latency
~48 ms
Tier
Tier 2
// 01 / What it computes

API di Profezioni Annuali

L'endpoint prende i dati di nascita e una data di destinazione, conta gli anni completati dal momento della nascita, e avanza di un segno intero dall'ascendente per ciascuno di essi. La risposta riporta l'età calcolata, l'indice a base zero del segno in cui ricade l'anno, e il pianeta che governa quel segno come lordOfYear, insieme all'ascendente natale, MC, Sole e Luna in modo che tu possa rappresentare l'anno sul tema senza una seconda chiamata. Il numero della casa segue direttamente dall'età: il ciclo è di dodici anni, quindi la casa proiettata è l'età modulo dodici, più uno. L'età 36 torna alla prima casa e quindi al segno dell'ascendente stesso, per cui il tema di esempio, con un ascendente a 169.97 gradi in Vergine, riporta signIndex 5 e Mercurio come signore di quell'anno. Poiché il conteggio parte dal momento della nascita e non dal calendario, l'anno proiettato cambia il giorno del compleanno e non il primo gennaio.

// 02 / Live request

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

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

Usa le profezioni quando hai bisogno di un livello di timing che un lettore possa seguire senza un ephemeris. Ogni anno ha un pianeta governante, quindi una previsione annuale, un report di compleanno o una narrazione AI possono essere costruiti attorno a una singola chiara affermazione anziché una tabella di transiti. Si combina particolarmente bene con transiti e ritorni: trova qui il signore dell'anno, poi guarda cosa succede a quel pianeta per transito, e hai la lettura classica a due passi in due chiamate. Si abbina anche con il ritorno solare, che copre lo stesso anno da un'angolazione diversa. La tecnica è deliberatamente grezza. Ti dice quale settore della vita è attivato e chi ne ha la responsabilità, non cosa succede in un pomeriggio specifico, quindi trattala come la cornice su cui appendere un timing più fine.

// 05 / Notes

Notes

Profezioni a segno intero dall'ascendente, un segno per anno completato, con i governatori tradizionali delle case che danno il signore dell'anno. Le età sono contate dal momento della nascita, quindi l'anno cambia il giorno del compleanno. L'ascendente natale, MC, Sole e Luna provengono dal motore Swiss Ephemeris nello zodiaco tropicale e sono restituiti in gradi.

Try the Profezioni Annuali API

Grab a key and make your first call in under a minute.

99.9% SLA · piani a pagamento · 30d stato →