API de trânsitos

O endpoint transits recebe os dados natais de uma pessoa — data de nascimento, hora, desvio UTC, latitude, longitude e sistema de casas — e um momento-alvo separado. Converte essa data-alvo e hora de relógio num dia juliano, solicita ao motor Swiss Ephemeris a longitude, a latitude e a velocidade geocêntricas de cada corpo em trânsito e depois projeta essas posições nas casas derivadas da localização natal. A resposta contém os planetas em trânsito com os seus signos e posições nas casas, as cúspides das casas natais e a grelha completa de aspetos calculada entre os próprios corpos em trânsito, cada um com indicadores de aplicação ou separação e orbes exatos. Devolve também aspetos de paralelo e de antiscia (ponto-espelho) para trabalho de declinação e do eixo solsticial. O movimento retrógrado é assinalado a partir da velocidade do corpo, para que veja quais trânsitos estão diretos, estacionários ou em movimento retrógrado no momento solicitado.

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
}'

{
  "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": [
      "…"
    ]
  }
}

Use isto quando quiser todo o céu tal como se encontra sobre o mapa de alguém num dado dia — um widget de trânsitos diários, um painel ao estilo "que tempo astrológico paira agora", ou a estrutura em bruto que um agente de AI lê antes de descrever o clima astrológico atual. Como devolve o mapa de trânsitos sobre a estrutura de casas natais em vez de uma lista curada de contactos trânsito-a-natal, é a chamada certa quando precisa do próprio instantâneo estrutural. Se, em vez disso, quiser contactos trânsito-a-natal temporizados ao longo de um intervalo de datas — datas exatas, ingressos, pontos de estação — recorra ao endpoint /transit-calendar, construído para esse trabalho de temporização. Combine os dois: este endpoint para o mapa do momento, o calendário para a lista de eventos voltada para o futuro.

Seja preciso quanto ao âmbito: isto devolve o mapa de trânsitos sobreposto à estrutura de casas natais, não uma lista pré-filtrada de aspetos trânsito-a-natal. A grelha de aspetos é calculada entre os corpos em trânsito, não entre pontos de trânsito e natais. Para temporização a-natal ao longo de um intervalo de datas, use /transit-calendar. As casas seguem o sistema natal escolhido; zodíaco tropical e Swiss Ephemeris ao longo de tudo.