AstroWay/api v2.201.6 · cs
všechny systémy jsou v pořádku
// astrology api · POST /v1/transits

Transitní graf API

Snímek oblohy na jakýkoli cílový den a položení ho přes natahovací rám domu jedním POST. Přechodné planety, natahovací cusps, do kterých spadají, mřížka aspektů mezi přechodnými tělesy, plus paralely a antiscia - přesnost Swiss Ephemeris, JSON výstup.

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

Transitní graf API

Koncový bod transitů vezme natahovací data osoby - datum narození, čas, UTC offset, šířku, délku a systém domů - a samostatný cílový okamžik. Převede tento cílový datum a čas na juliánský den, požádá motor Swiss Ephemeris o geocentrickou délku, šířku a rychlost každého přechodného tělesa, pak tyto pozice umístí do domů odvozených z natahovacího umístění. Odpověď nese přechodné planety se svými znameními a umístěními v domech, natahovací cusps domů a plnou mřížku aspektů vypočtenou mezi samotnými přechodnými tělesy, každý s příznaky přibližování nebo oddalování a přesnými orbity. Vrací také paralelní a antiscia (zrcadlové body) aspekty pro deklinaci a práci se slunovratnou osou. Retrográdní pohyb je označen z rychlosti tělesa, takže můžete vidět, které transity jsou přímé, stacionární nebo se pohybují dozadu požadovaným okamžikem.

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

Použijte to, když chcete celou oblohu, jak sedí nad něčími grafy v daný den - widget denních transitů, panel počasí 'co je teď nad hlavou' nebo surový rám, který čte AI agent před popisem současného astrologického klimatu. Protože vrací transitní graf přes natahovací rám domů nikoli předfiltrovaný seznam transit-to-natal kontaktů, je to správná volba, když potřebujete samotný strukturní snímek. Pokud chcete naopak časované transit-to-naly údery prohledané přes rozsah dat - přesná data, vstupy, stacionární body - sáhněte po koncovém bodu transitního kalendáře, který je na tuto časovou práci postaven. Spojte oba: tento koncový bod pro graf v daném okamžiku, kalendář pro seznam událostí dopředu.

Podívejte se na dnešní transity proti vašemu vlastnímu grafu →

// 05 / Notes

Notes

Buďte přesní ohledně rozsahu: toto vrací transitní graf položený přes natahovací rám domů, nikoli předfiltrovaný seznam transit-to-natal aspektů. Mřížka aspektů je vypočtena mezi přechodnými tělesy, nikoli mezi transitními a natahovacími body. Pro časování transit-to-natal přes rozsah dat použijte /transit-calendar. Domů následují váš zvolený natahovací systém; tropický zodiak a Swiss Ephemeris celou dobu.

Try the Transitní graf API

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

99,9% SLA · placené plány · 30 dní status →