/api/astro/retrograde/1 créditoPeriodos retrógrados
Todos los periodos retrógrados de un año en una sola respuesta, y ligera. El movimiento retrógrado, o vakri, es el aparente retroceso de un planeta respecto a las estrellas, y en astrología esos tramos se consideran una fase propia del comportamiento del planeta. Envía `year` y nada más. La respuesta es `data.planets`, un objeto indexado por nombre de planeta, cada uno con una lista de marcas de tiempo `{start, end}` en UTC. Los periodos que cruzan el cambio de año se recortan al 1 de enero y al 31 de diciembre, así que una franja que empieza en `01-01 00:00:00` en realidad comenzó el año anterior. Si un planeta no entra en retrogradación ese año, su lista está vacía. Se devuelven diez claves: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu y ketu. El Sol y la Luna no aparecen porque, vistos desde la Tierra, nunca son retrógrados. Rahu y Ketu se derivan del nodo lunar medio, que retrocede de forma constante todo el año sin ninguna estación, así que ambos muestran siempre una única franja que cubre el año entero; con el nodo verdadero saldrían decenas de entradas espurias de pocos días. Para hallar las horas de estación se acota el día en que la velocidad longitudinal cambia de signo y luego se afina dentro de ese día, así que la precisión es de bastante menos de un minuto. Las mismas cifras aparecen en `/api/planetary_details/` junto con otros ocho cálculos; este endpoint devuelve solo los datos de retrogradación.
https://api.occultapi.com/api/astro/retrograde/
Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| year | integer | obligatorio | Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. min 1800 · max 2400 |
Ejemplo de solicitud
curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'Respuesta
{
"data": {
"year": 2026,
"planets": {
"mercury": [
{
"start": "2026-02-26 06:47:34",
"end": "2026-03-20 19:33:02"
},
{
"start": "2026-06-29 17:34:35",
"end": "2026-07-23 22:58:49"
},
{
"start": "2026-10-24 07:12:44",
"end": "2026-11-13 15:54:27"
}
],
"venus": [
{
"start": "2026-10-03 07:13:14",
"end": "2026-11-14 00:29:50"
}
],
"mars": [],
"jupiter": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-03-11 03:53:41"
},
{
"start": "2026-12-13 00:30:39",
"end": "2026-12-31 00:00:00"
}
],
"saturn": [
{
"start": "2026-07-26 18:57:26",
"end": "2026-12-11 00:30:23"
}
],
"uranus": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-02-04 02:56:33"
},
{
"start": "2026-09-10 18:24:34",
"end": "2026-12-31 00:00:00"
}
],
"neptune": [
{
"start": "2026-07-07 09:57:49",
"end": "2026-12-13 00:46:51"
}
],
"pluto": [
{
"start": "2026-05-06 12:13:55",
"end": "2026-10-16 05:33:46"
}
],
"rahu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
],
"ketu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
]
}
},
"message": "successful",
"is_error": false
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.