Calendário Lunar

Calcula informações sobre a fase lunar, períodos de Vácuo de Curso, trânsitos de signos e próximos aspectos lunares.

Detalhe do Dia

Obtém informações lunares detalhadas para um dia específico:

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/day" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Intervalo de Datas

Obtém uma visão geral do calendário lunar para um intervalo de datas (máx. 31 dias):

curl -X POST "https://api.astroapi.cloud/api/calc/moon-calendar/range" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    },
    "aspects": ["conjunction", "sextile", "square", "trine", "opposition"]
  }'

Parâmetros

Endpoint do Dia

Parâmetro	Tipo	Obrigatório	Descrição
dateTime	string	Sim	Data e hora no formato YYYY-MM-DDTHH:mm
location	object	Sim	Localização com latitude, longitude e fuso horário
aspects	array	Não	Aspectos a considerar para o cálculo do VOC

Endpoint do Intervalo

Parâmetro	Tipo	Obrigatório	Descrição
startDate	string	Sim	Data de início no formato YYYY-MM-DD
endDate	string	Sim	Data de fim no formato YYYY-MM-DD (máx. 31 dias)
location	object	Sim	Localização com latitude, longitude e fuso horário
aspects	array	Não	Aspectos a considerar para o cálculo do VOC

Aspectos Disponíveis

• conjunction — 0 graus
• sextile — 60 graus
• square — 90 graus
• trine — 120 graus
• opposition — 180 graus

Resposta do Dia

{
  "data": {
    "date": "2024-06-15",
    "moon": {
      "sign": "leo",
      "signEntry": "2024-06-15T08:23:00Z",
      "signExit": "2024-06-17T14:45:00Z",
      "phase": {
        "name": "Waxing Gibbous",
        "illumination": 0.72,
        "age": 9.3
      }
    },
    "voidOfCourse": {
      "isVoid": true,
      "start": "2024-06-15T18:45:00Z",
      "end": "2024-06-17T14:45:00Z",
      "durationMinutes": 2640,
      "lastAspect": {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z"
      },
      "nextSign": "virgo"
    },
    "upcomingAspects": [
      {
        "planet": "venus",
        "aspect": "sextile",
        "exactTime": "2024-06-15T14:30:00Z",
        "applying": true
      },
      {
        "planet": "mars",
        "aspect": "trine",
        "exactTime": "2024-06-15T18:45:00Z",
        "applying": true
      }
    ]
  }
}

Resposta do Intervalo

{
  "data": {
    "startDate": "2024-06-01",
    "endDate": "2024-06-30",
    "phases": [
      {
        "type": "new_moon",
        "date": "2024-06-06T12:37:00Z",
        "sign": "gemini"
      },
      {
        "type": "first_quarter",
        "date": "2024-06-14T05:18:00Z",
        "sign": "virgo"
      },
      {
        "type": "full_moon",
        "date": "2024-06-22T01:08:00Z",
        "sign": "capricorn"
      },
      {
        "type": "last_quarter",
        "date": "2024-06-28T21:53:00Z",
        "sign": "aries"
      }
    ],
    "signTransits": [
      {
        "sign": "gemini",
        "entry": "2024-06-01T03:15:00Z",
        "exit": "2024-06-03T08:45:00Z"
      },
      {
        "sign": "cancer",
        "entry": "2024-06-03T08:45:00Z",
        "exit": "2024-06-05T15:20:00Z"
      }
    ],
    "voidPeriods": [
      {
        "start": "2024-06-02T15:30:00Z",
        "end": "2024-06-03T08:45:00Z",
        "durationMinutes": 1035,
        "lastAspect": {
          "planet": "saturn",
          "aspect": "square"
        },
        "fromSign": "gemini",
        "toSign": "cancer"
      }
    ]
  }
}

Lua em Vácuo de Curso

A Lua em Vácuo de Curso (VOC) é o período em que a Lua não forma mais aspectos maiores com os planetas antes de entrar num novo signo. Tradicionalmente, este período é considerado desfavorável para iniciar novos empreendimentos.

Como o VOC é Calculado

1. A posição actual da Lua e o seu signo são determinados
2. O momento exacto em que a Lua entra no próximo signo é calculado
3. Todos os aspectos entre a Lua e os planetas principais são encontrados até à mudança de signo
4. O último aspecto marca o início do período VOC
5. O período VOC termina quando a Lua entra no novo signo

Campos de Dados do VOC

Campo	Descrição
isVoid	Se a Lua está actualmente em Vácuo de Curso
start	Quando o período VOC começou (hora do último aspecto)
end	Quando o VOC termina (Lua entra no novo signo)
durationMinutes	Duração do período VOC em minutos
lastAspect	Detalhes do último aspecto formado
nextSign	O signo para o qual a Lua entrará a seguir

Casos de Uso

• Astrologia Electiva: Evita iniciar actividades importantes durante a Lua em VOC
• Planeamento pela Fase Lunar: Acompanha os momentos óptimos para actividades com base nas fases lunares
• Calendários Astrológicos: Exibe trânsitos de signos e fases da Lua
• Timing de Rituais: Planeia actividades alinhadas com os ciclos lunares