Cargando el Playground
curl -X POST https://api.occultapi.com/api/astro/cazimi/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-09T12:00:00+00:00","latitude":26.9124,"longitude":75.7873,"timezone_as_float":0}'Las tres condiciones solares de cada planeta en un momento dado. Un planeta cercano al Sol está en uno de tres estados, y no son lo mismo aunque se confundan a menudo. CAZIMI significa estar a menos de unos 17 minutos de arco del centro del Sol («en el corazón»), y se considera el estado MÁS FUERTE de un planeta. COMBUSTO significa estar a menos de unos 8.5 grados, y es casi lo peor: las significaciones quedan quemadas. BAJO LOS RAYOS significa estar a menos de unos 15 grados: debilitado, pero no destruido. La distinción importa porque cazimi y combusto están a medio grado de distancia y tienen significados opuestos; por eso se comprueba primero el cazimi, y un planeta que está dentro de ambos orbes es cazimi. Un endpoint que solo comprobara la combustión presentaría la mejor posición de la astrología tradicional como la peor. Para cada planeta se devuelve además la elongación exacta en grados y minutos de arco, a qué lado del Sol está y si se está aplicando al Sol o separando de él (según las dos velocidades en longitud), que es lo que distingue a un planeta que entra en combustión de uno que sale de ella. Los tres orbes son campos de la solicitud, porque las fuentes no coinciden en sus valores. No confundir con /api/astro/combustion/, que recorre un año entero buscando los periodos en que un planeta está combusto; este indica el estado de cada planeta en este momento y cubre también el cazimi y el estado bajo los rayos.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| date_time | string (date-time) | obligatorio | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. |
| altitude | number (double) | opcional | Elevación del OBSERVADOR en metros, no la altura de un cuerpo. |
| cazimi_orb | number (double) | opcional | Grados. Valor por defecto: 0.2833, es decir, 17 minutos de arco. min 0 · max 5 |
| combust_orb | number (double) | opcional | Grados. Valor por defecto: 8.5. min 0 · max 30 |
| keys | array | opcional | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. |
| latitude | number (double) | opcional | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -89.9 · max 89.9 |
| longitude | number (double) | opcional | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| planet_names | array | opcional | Cuerpos que se comprueban. Si envías el Sol o los nodos, se ignoran. |
| time_zone | number (double) | opcional | Diferencia con UTC. Usa este campo o timezone_as_float; son equivalentes. min -12 · max 14 |
| timezone_as_float | number (double) | opcional | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |
| under_beams_orb | number (double) | opcional | Grados. Valor por defecto: 15.0. min 0 · max 45 |