API de revolução lunar

O endpoint lunar-return lê a longitude exata da Lua natal a partir dos dados de nascimento fornecidos e depois procura, a partir da data de início indicada, o primeiro instante em que a Lua em trânsito regressa a essa mesma longitude. Como a Lua completa um ciclo sideral em cerca de 27,3 dias, esse retorno ocorre aproximadamente uma vez por mês. O endpoint converte o instante correspondido num dia juliano, extrai as posições e velocidades geocêntricas do motor Swiss Ephemeris e levanta um mapa completo para ele — planetas do retorno com signos e posições nas casas, cúspides das casas e a grelha completa de aspetos com indicadores de aplicação e separação e orbes exatos. Por predefinição, o mapa é levantado para o local natal, mas pode fornecer uma latitude e longitude diferentes para relocalizar o retorno, o que remodela os ângulos e as casas mantendo o mesmo momento de retorno. O resultado lê-se como o mapa de tema emocional e rítmico do mês lunar que se avizinha.

curl -X POST https://api.astroway.info/v1/lunar-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,
  "afterDate": "2026-06-15"
}'

{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 282.7,
        "sign": "Capricorn",
        "house": 6
      }
    ],
    "houses": {
      "ascendant": 201.5,
      "mc": 110.3,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}

Use a revolução lunar para previsão de ciclo curto, aproximadamente mensal — uma funcionalidade de "mês lunar à frente", um rastreador de ritmo emocional, ou um companheiro de granularidade mais fina para a revolução solar anual. Onde a revolução solar enquadra um ano inteiro, a revolução lunar enquadra as próximas quatro semanas, tornando-a bem adequada a relatórios mensais recorrentes e a ciclos de hábitos ou de humor. Passe a data de início como o ponto a partir do qual quer o próximo retorno — muitas vezes hoje, ou a data do último retorno — e o endpoint avança até ao próximo. A substituição opcional de localização permite levantar o retorno para onde a pessoa realmente está nesse mês em vez do seu local de nascimento, o que importa para as casas sensíveis aos ângulos. Encadeie chamadas sucessivas para construir uma sequência rolante de mapas mensais.

O endpoint devolve o próximo retorno único na data indicada ou depois dela, não uma série — chame repetidamente, avançando a data de início, para construir uma sequência. O valor de ~27,3 dias é o mês sideral, pelo que os retornos vão deslizando em relação ao calendário. Se não for fornecida uma localização, o mapa é levantado no local natal; uma substituição relocaliza apenas os ângulos e as casas. Zodíaco tropical e Swiss Ephemeris ao longo de tudo.