AstroWay/api v2.201.6 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/symbolic-directions

API des Directions d'Arc Solaire

L'arc solaire déplace tout le chart d'un cran : la distance parcourue par le Sun grâce à la secondary progression. Chaque planet, chaque cusp et les deux angles se déplacent du même arc, ainsi un natal aspect qui était à deux degrees de l'exact devient exact environ deux ans plus tard. Ce endpoint renvoie le chart dirigé et l'arc qui l'a produit.

Endpoint
POST /v1/symbolic-directions
Cost
50 credits
Latency
~50 ms
Tier
Tier 3
// 01 / What it computes

API des Directions d'Arc Solaire

À partir des birth data et d'une target date, le endpoint progresse d'abord le chart day-for-a-year, mesure la distance parcourue par le Sun progressé depuis sa position natal, et prend cette distance comme arc. Il ajoute ensuite l'arc à chaque longitude natal d'un coup : toutes les planets, tous les house cusps, l'ascendant et le MC. La response renvoie les positions dirigées sous data.planets et data.houses, l'arc lui-même en degrees sous data.arc, et la key qui l'a produit sous data.key. Comme un seul arc est appliqué uniformément, la géométrie du natal chart est préservée et seule sa relation aux natal degrees change, ce qui rend la technique très économique à lire : un nombre te dit l'état du chart complet à un âge donné. Deux autres keys sont disponibles sur le même endpoint. Mets key à naibod pour le mean solar rate de 59'08.3" per year, ou omets-la pour le simple one degree per year. Envoyer converse true dirige en arrière depuis le moment de naissance au lieu d'en avant, inversant le signe de l'arc.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "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
    }
  }
}
// 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. 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.
// 04 / When to use it

When to use it

Utilise l'arc solaire quand tu as besoin d'un timing symbolique plutôt qu'astronomique, et quand tu le veux sous une forme que le lecteur peut suivre. Comme tout bouge à un même rythme, un contact dirigé tombe sur une année précise plutôt que sur une fenêtre, ce qui convient à une fonctionnalité de frise de vie, un rapport d'étape d'âge, ou un récit IA qui doit expliquer ce qu'est une année donnée. Il se combine naturellement avec les secondary progressions, puisque l'arc provient du même Sun progressé : les progressions te donnent le chart intérieur qui bouge, l'arc solaire te donne le chart complet traduit en avant. Compare les trois keys quand la précision compte pour ton audience. L'arc solaire suit le Sun réel et varie légèrement selon la date de naissance, Naibod utilise le mean rate, et one degree per year est la convention arrondie. Pour une naissance mi-mai, les trois donnent environ 34.5, 35.5 et 36.0 degrees sur 36 ans, assez proches pour s'accorder sur la décennie et assez éloignés pour nommer des années différentes.

// 05 / Notes

Notes

L'arc est la distance parcourue par le Sun secondary-progressed, jour pour un an, ce qui est la définition standard ; la key Naibod utilise le mean daily motion du Sun, 59'08.3" per year. Pour l'arc solaire le chart progressé est calculé en avant et la direction du déplacement est appliquée une fois, ainsi les converse directions renvoient l'arc négatif plutôt que doublé. Les positions proviennent du moteur Swiss Ephemeris dans le tropical zodiac, sur les mêmes bodies et house system que les natal endpoints.

Try the Directions d'Arc Solaire API

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

99,9% SLA · forfaits payants · 30 j statut →