AstroWay/api v2.201.6 · nl
alle systemen normaal
// astrology api · POST /v1/symbolic-directions

Solar Arc Richtingen API

Solar arc verschuift de hele chart één getal vooruit: de afstand die de Sun heeft afgelegd via secondary progression. Elke planeet, elke cusp en beide hoeken verschuiven met diezelfde arc, zodat een natal aspect dat twee graden van exact was, ongeveer twee jaar later exact wordt. Deze endpoint geeft de directed chart en de arc die het heeft geproduceerd.

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

Solar Arc Richtingen API

Van de birth data en een target date berekent de endpoint eerst de chart day-for-a-year, meet hoe ver de progressed Sun is verschoven vanaf zijn natal position, en neemt die afstand als de arc. Daarna voegt hij de arc in één keer toe aan elke natal longitude: alle planets, alle house cusps, de ascendant en de MC. De response bevat de directed positions onder data.planets en data.houses, de arc zelf in graden onder data.arc, en de key die het heeft geproduceerd onder data.key. Omdat één enkele arc uniform wordt toegepast, blijft de geometry van de natal chart behouden en verandert alleen de relatie tot de natal degrees, wat de techniek zo economisch maakt om te lezen: één getal vertelt je de staat van de hele chart op een bepaalde leeftijd. Twee andere keys zijn beschikbaar op dezelfde endpoint. Zet key op naibod voor de mean solar rate van 59'08.3\" per year, of laat het weg voor de plain one degree per year. Stuur converse true om backwards te richten vanaf het birth moment in plaats van forwards, waardoor het teken van de arc omkeert.

// 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

Gebruik solar arc als je timing nodig hebt die symbolisch is in plaats van astronomisch, en als je het in een vorm wilt die een lezer kan volgen. Omdat alles met één snelheid beweegt, landt een directed contact op een specifiek jaar in plaats van een venster, wat goed past bij een life-timeline feature, een age-milestone rapport, of een AI-verhaal dat moet vertellen waar een bepaald jaar over gaat. Het werkt natuurlijk samen met secondary progressions, want de arc is afgeleid van dezelfde progressed Sun: progressions geven je de bewegende inner chart, solar arc geeft je de hele chart naar voren vertaald. Vergelijk de drie keys als precisie belangrijk is voor je publiek. Solar arc volgt de echte Sun en varieert daardoor een beetje per birth date, Naibod gebruikt de mean rate, en one degree per year is de ronde-getal conventie. Voor een geboorte medio mei komen de drie uit op ongeveer 34.5, 35.5 en 36.0 graden over 36 jaar, genoeg om het decennium overeen te laten komen en ver genoeg uit elkaar om verschillende jaren te benoemen.

// 05 / Notes

Notes

De arc is de afstand die de secondary-progressed Sun heeft afgelegd, day for a year, wat de standaarddefinitie is; de Naibod key gebruikt de mean daily motion van de Sun, 59'08.3\" per year. Voor solar arc wordt de progressed chart forwards berekend en de travel direction één keer toegepast, dus converse directions geven de arc negated terug in plaats van doubled. Posities komen van de Swiss Ephemeris engine in de tropical zodiac, met dezelfde bodies en house system als de natal endpoints.

Try the Solar Arc Richtingen API

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

99.9% SLA · betaalde plannen · 30d status →