API Direzioni delle Arci Solari
L'arco solare sposta l'intero grafico avanti di un numero: la distanza che il Sole ha percorso per progressione secondaria. Ogni pianeta, ogni cuspide e entrambe le angolazioni si spostano di quell'arco stesso, quindi un aspetto natale che era a due gradi dalla precisione raggiunge la precisione circa due anni dopo. Questo endpoint restituisce il grafico diretto e l'arco che lo ha prodotto.
API Direzioni delle Arci Solari
Dati i dati di nascita e una data target, l'endpoint prima progredisce il grafico giorno per anno, misura quanto il Sole progredito si è mosso dalla sua posizione natale e prende quella distanza come arco. Poi aggiunge l'arco a ogni longitudine natale contemporaneamente: tutti i pianeti, tutte le case, l'ascendente e il MC. La risposta porta le posizioni dirette sotto data.planets e data.houses, l'arco stesso in gradi sotto data.arc, e la chiave che lo ha prodotto sotto data.key. Poiché un singolo arco viene applicato uniformemente, la geometria del grafico natale è preservata e solo la sua relazione con i gradi natali cambia, il che rende la tecnica così economica da leggere: un numero ti dice lo stato dell'intero grafico a un dato età. Altre due chiavi sono disponibili sullo stesso endpoint. Imposta key su naibod per il tasso solare medio di 59'08.3" all'anno, o omettila per il semplice grado all'anno. Inviando converse true si dirige all'indietro dal momento della nascita invece che in avanti, invertendo il segno dell'arco.
POST/v1/symbolic-directions
curl -X POST https://api.astroway.info/v1/symbolic-directions \
-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",
"key": "solar_arc"
}' {
"ok": true,
"data": {
"arc": 34.5083,
"key": "solar_arc",
"planets": [
{
"id": 0,
"name": "Sun",
"longitude": 88.8843,
"isRetrograde": false
}
],
"houses": {
"system": "P",
"ascendant": 204.4763,
"mc": 111.5826
}
}
} 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. Decimal allowed for half-hour zones. |
| 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 the chart is directed to. |
| key | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| converse | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |
When to use it
Ricorri all'arco solare quando hai bisogno di un timing che sia simbolico piuttosto che astronomico, e quando vuoi in una forma che un lettore possa seguire. Poiché tutto si muove a un tasso, un contatto diretto cade in un anno specifico piuttosto che in una finestra, il che si adatta a una funzione di timeline di vita, un report di traguardi età, o un narrativo AI che deve dire di cosa si tratta un dato anno. Si abbina naturalmente con le progressioni secondarie, poiché l'arco deriva dallo stesso Sole progredito: le progressioni ti danno il grafico interno mobile, l'arco solare ti dà l'intero grafico tradotto in avanti. Confronta le tre chiavi quando la precisione conta per il tuo pubblico. L'arco solare segue il Sole effettivo e quindi varia leggermente per data di nascita, Naibod usa il tasso medio, e un grado all'anno è la convenzione del numero intero. Per una nascita a metà maggio le tre vengono a circa 34.5, 35.5 e 36.0 gradi su 36 anni, abbastanza vicine per concordare sul decennio e abbastanza distanti per nominare anni diversi.
Notes
L'arco è la distanza percorsa dal Sole progredito per secondaria, giorno per anno, che è la definizione standard; la chiave Naibod usa il moto medio giornaliero del Sole, 59'08.3" all'anno. Per l'arco solare il grafico progredito è calcolato in avanti e la direzione del viaggio viene applicata una volta, quindi le direzioni converse restituiscono l'arco negato anziché raddoppiato. Le posizioni provengono dal motore Swiss Ephemeris nello zodiaco tropicale, sugli stessi corpi e sistema di case degli endpoint natali.
Try the Direzioni delle Arci Solari API
Grab a key and make your first call in under a minute.