Calendario Lunar

Calculad información sobre las fases lunares, los períodos de Luna Vacía de Curso, los tránsitos de signos y los próximos aspectos lunares.

Detalle del Día

Obtened información lunar detallada para un día 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"]
  }'

Rango de Fechas

Obtened una vista general del calendario lunar para un rango de fechas (máximo 31 días):

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 de Día

Parámetro	Tipo	Obligatorio	Descripción
dateTime	string	Sí	Fecha y hora en formato YYYY-MM-DDTHH:mm
location	object	Sí	Ubicación con latitud, longitud y zona horaria
aspects	array	No	Aspectos a considerar para el cálculo de VOC

Endpoint de Rango

Parámetro	Tipo	Obligatorio	Descripción
startDate	string	Sí	Fecha de inicio en formato YYYY-MM-DD
endDate	string	Sí	Fecha de fin en formato YYYY-MM-DD (máximo 31 días)
location	object	Sí	Ubicación con latitud, longitud y zona horaria
aspects	array	No	Aspectos a considerar para el cálculo de VOC

Aspectos Disponibles

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

Respuesta del Día

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

Respuesta del Rango

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

Luna Vacía de Curso

La Luna Vacía de Curso (VOC, por sus siglas en inglés) es el período en el que la Luna no forma ningún aspecto mayor con los planetas antes de entrar en un nuevo signo. Tradicionalmente, este período se considera desfavorable para iniciar nuevos proyectos.

Cómo se Calcula la VOC

1. Se determina la posición actual de la Luna y su signo
2. Se calcula el momento exacto en que la Luna entra en el siguiente signo
3. Se encuentran todos los aspectos entre la Luna y los planetas mayores hasta el cambio de signo
4. El último aspecto marca el inicio del período VOC
5. El período VOC termina cuando la Luna entra en el nuevo signo

Campos de los Datos VOC

Campo	Descripción
isVoid	Si la Luna está actualmente vacía de curso
start	Cuándo comenzó el período VOC (hora del último aspecto)
end	Cuándo termina el VOC (la Luna entra en el nuevo signo)
durationMinutes	Duración del período VOC en minutos
lastAspect	Detalles del último aspecto realizado
nextSign	El signo en el que entrará la Luna a continuación

Casos de Uso

• Astrología Electiva: Evitad iniciar actividades importantes durante la Luna Vacía de Curso
• Planificación por Fases Lunares: Seguid los momentos óptimos para las actividades según las fases lunares
• Calendarios Astrológicos: Mostrad los tránsitos de signos y las fases lunares
• Sincronización de Rituales: Planificad actividades alineadas con los ciclos lunares