API de revolução solar

O endpoint solar-return lê primeiro a longitude zodiacal exata do Sol natal a partir dos dados de nascimento fornecidos e depois procura no ano indicado o momento preciso em que o Sol em trânsito regressa a essa mesma longitude — tipicamente dentro de cerca de um dia em relação ao aniversário de calendário. Converte esse instante de retorno num dia juliano, extrai as posições e velocidades geocêntricas do motor Swiss Ephemeris e levanta um mapa completo para ele: os planetas do retorno com signos e posições nas casas, as cúspides das casas e a grelha completa de aspetos com indicadores de aplicação e separação e orbes exatos. A correspondência é tropical e Sol-ao-Sol-natal, não corrigida pela precessão por predefinição, pelo que o Sol do retorno assenta no grau tropical do Sol natal. O mapa resultante é lido como o mapa de tema dominante do ano que vai de um aniversário ao seguinte.

curl -X POST https://api.astroway.info/v1/solar-return \
  -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,
  "year": 2026
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Sun",
        "longitude": 54.23,
        "sign": "Taurus",
        "house": 9
      }
    ],
    "houses": {
      "ascendant": 188.2,
      "mc": 95,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

Use a revolução solar para previsão anual — um relatório de "ano à frente", uma funcionalidade de mapa de aniversário, ou um fluxo de AI que constrói uma perspetiva de doze meses a partir de um único mapa datado. É o cavalo de batalha da previsão baseada em retornos: os ângulos, a casa onde cai o Sol do retorno e os aspetos mais apertados são lidos como os temas principais desse ano solar. Combine-a com trânsitos e progressões para profundidade, mas a revolução solar por si só dá um instantâneo anual limpo e autocontido, ancorado no próprio aniversário da pessoa em vez do calendário. Como passa apenas dados natais mais um ano, encaixa-se bem em acionadores de aniversário e e-mails anuais agendados — recalcule a cada ano para avançar a previsão.

O retorno é correspondido de forma tropical, Sol ao Sol natal, e não é corrigido pela precessão por predefinição, pelo que reflete a revolução solar ocidental convencional e não a variante corrigida pela sideral. É levantado para a localização natal fornecida; revoluções solares relocalizadas exigiriam um novo levantamento noutro lugar. Zodíaco tropical e Swiss Ephemeris ao longo de tudo.