AstroWay/api v2.201.6 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/transits

API Grafic de tranzit

Capturează cerul pentru orice dată țintă și pune-l peste cadrul caselor natale al cuiva într-un singur POST. Planetele în tranzit, cuspidele natale în care cad, grila de aspecte dintre corpurile în tranzit, plus paralele și antiscia – precizie Swiss Ephemeris, JSON în ieșire.

Endpoint
POST /v1/transits
Cost
50 credits
Latency
~60 ms
Tier
Tier 3
// 01 / What it computes

API Grafic de tranzit

Endpoint-ul de tranzite primește datele natale ale unei persoane – data nașterii, ora, offset UTC, latitudine, longitudine și sistemul de case – și un moment țintă separat. Transformă data și ora țintă în zi juliană, solicită motorului Swiss Ephemeris longitudinea, latitudinea și viteza geocentrice ale fiecărui corp în tranzit, apoi plasează acele poziții în casele derivate din locația natală. Răspunsul conține planetele în tranzit cu semnele și pozițiile în case, cuspidele caselor natale și grila completă de aspecte calculată între corpurile în tranzit, fiecare cu flaguri de aplicare sau separare și orburi exacte. Returnează și aspecte de paralelă și antiscia (punct oglindă) pentru declinație și lucru pe axa solstițială. Mișcarea retrogradă este marcată din viteza corpului, așa că poți vedea care tranzite sunt directe, staționare sau înapoi la momentul cerut.

// 02 / Live request

POST/v1/transits

curl -X POST https://api.astroway.info/v1/transits \
  -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,
  "transitDate": "2026-06-15",
  "transitTime": "12:00:00",
  "transitTzOffset": 3
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "input": {},
    "julianDay": 2461206.875,
    "planets": [
      {
        "name": "Sun",
        "longitude": 84.29,
        "sign": "Gemini",
        "house": 11
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "parallelAspects": [
      "…"
    ],
    "antiscia": [
      "…"
    ]
  }
}
// 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 (e.g. 3 for Kyiv summer time). 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).
transitDate string (YYYY-MM-DD) yes Required target date for the transit snapshot (YYYY-MM-DD).
transitTime string (HH:MM:SS) no Optional clock time of the transit moment (HH:MM:SS).
transitTzOffset number (hours) no Optional UTC offset for the transit moment, in hours.
// 04 / When to use it

When to use it

Folosește-l când vrei tot cerul așa cum stă peste graficul cuiva într-o anumită zi – un widget de tranzite zilnice, un panou în stil meteo „ce e deasupra acum”, sau cadrul brut pe care un agent AI îl citește înainte să descrie clima astrologică curentă. Pentru că returnează graficul de tranzit peste cadrul caselor natale, nu o listă curată de contacte tranzit-natale, e alegerea potrivită când ai nevoie de captura structurală în sine. Dacă în schimb vrei tranzite-natale cronometate pe o perioadă – date exacte, intrări, puncte de stație – apelează endpoint-ul transit-calendar, făcut pentru asta. Folosește-le împreună: acest endpoint pentru graficul moment-in-time, calendarul pentru lista de evenimente viitoare.

Vezi tranzitele de azi pe graficul tău →

// 05 / Notes

Notes

Fii precis în privința scopului: asta returnează graficul de tranzit așezat peste cadrul caselor natale, nu o listă prefiltrată de aspecte tranzit-natale. Grila de aspecte se calculează între corpurile în tranzit, nu între puncte tranzit și natal. Pentru cronometrare tranzit-natale pe o perioadă de date, folosește /transit-calendar. Casele urmează sistemul natal ales de tine; zodiac tropical și Swiss Ephemeris pe tot parcursul.

Try the Grafic de tranzit API

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

99,9% SLA · planuri plătite · 30 zile status →