API de revolución lunar
Halla el siguiente momento en que la Luna regresa a su longitud natal en una fecha elegida o después de ella —aproximadamente cada 27,3 días— y levanta la carta para él en la ubicación que elijas. Pasa datos natales y una fecha de inicio, obtén la carta de revolución lunar. Precisión de Swiss Ephemeris, salida en JSON.
API de revolución lunar
El endpoint lunar-return lee la longitud exacta de la Luna natal a partir de los datos de nacimiento suministrados, y luego busca hacia adelante desde la fecha de inicio dada el primer instante en que la Luna en tránsito regresa a esa misma longitud. Como la Luna completa un ciclo sidéreo en unos 27,3 días, ese retorno cae aproximadamente cada mes. El endpoint resuelve el instante coincidente a un día juliano, extrae las posiciones y velocidades geocéntricas del motor Swiss Ephemeris y levanta una carta completa para él: planetas del retorno con signos y posiciones por casa, cúspides de casas y la malla completa de aspectos con indicadores de aplicación y separación y orbes exactos. De forma predeterminada la carta se levanta para el lugar natal, pero puedes suministrar una latitud y longitud distintas para relocalizar el retorno, lo que reconfigura los ángulos y las casas manteniendo el mismo momento de retorno. El resultado se lee como el mapa temático emocional y rítmico del mes lunar que viene.
POST/v1/lunar-return
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": [
"…"
]
}
}Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | sí | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sí | Birth-place longitude, decimal degrees (east positive). |
| afterDate | string (YYYY-MM-DD) | sí | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | no | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | no | Optional UTC offset for the start point, in hours. |
| locationLat | number | no | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | no | Optional longitude in decimal degrees to relocate the return chart, east positive. |
Cuándo usarlo
Usa la revolución lunar para la previsión de ciclo corto, aproximadamente mensual: una funcionalidad de «el mes lunar que viene», un seguidor de ritmo emocional, o un complemento de grano más fino para la revolución solar anual. Mientras que la revolución solar enmarca todo un año, la revolución lunar enmarca las próximas cuatro semanas, lo que la hace muy adecuada para informes mensuales recurrentes y ciclos de hábitos o estado de ánimo. Pasa la fecha de inicio como el punto tras el cual quieres el siguiente retorno —a menudo hoy, o la fecha del último retorno— y el endpoint avanza hasta el próximo. La anulación opcional de ubicación te permite levantar el retorno para dondequiera que la persona esté realmente ese mes en lugar de su lugar de nacimiento, lo que importa para las casas sensibles a los ángulos. Encadena llamadas sucesivas para construir una secuencia rodante de cartas mensuales.
Notas
El endpoint devuelve el siguiente retorno único en la fecha dada o después de ella, no una serie: llama repetidamente, avanzando la fecha de inicio, para construir una secuencia. La cifra de ~27,3 días es el mes sidéreo, así que los retornos se desplazan respecto al calendario. Si no se suministra ubicación, la carta se levanta en el lugar natal; una anulación relocaliza solo los ángulos y las casas. Zodíaco tropical y Swiss Ephemeris en todo momento.
Prueba la API de Revolución lunar
Consigue una clave y haz tu primera llamada en menos de un minuto.