/api/astro/astrocartography/lines/1 créditoLíneas de astrocartografía
Todas las líneas de astrocartografía de un momento de nacimiento, como coordenadas listas para dibujar en un mapa. La astrología de relocalización plantea una pregunta geográfica, no sobre la carta: no dónde estaba un planeta en el cielo, sino en qué lugares de la Tierra estaba saliendo, poniéndose, culminando o en el nadir en el momento del nacimiento. Esas cuatro curvas por planeta, dibujadas sobre un mapamundi, forman el mapa ACG. Para cada uno de los doce cuerpos obtienes cuatro líneas. Las líneas MC e IC son meridianos, así que cada una es una sola longitud. Las líneas AC y DC son curvas y se devuelven como una lista de puntos de latitud/longitud que puedes pasar tal cual a una polilínea: por defecto, uno cada cinco grados de latitud, ajustable con latitude_step. Las curvas se interrumpen donde el cuerpo se vuelve circumpolar, y no es que falten datos: por encima de cierta latitud el cuerpo no llega a cruzar el horizonte, así que allí no hay línea de salida que dibujar. El límite cambia según el planeta, porque depende de la declinación. latitude y longitude son opcionales solo en este endpoint. Una línea ACG la determina el MOMENTO del nacimiento (las fórmulas usan la ascensión recta, la declinación y el tiempo sideral, y nada más), así que pedir un lugar de nacimiento daría a entender que cambia la respuesta, y no la cambia. Usa /api/astro/astrocartography/relocate/ cuando quieras las líneas cercanas a un lugar concreto.
https://api.occultapi.com/api/astro/astrocartography/lines/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 |
|---|---|---|---|
| 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. |
| timezone_as_float | number (double) | obligatorio | 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 |
| bodies | array | opcional | Valor por defecto: los doce. Redúcelo para obtener respuestas más ligeras. |
| close_curves | boolean | opcional | Añade puntos que prolongan cada curva AC/DC hasta su final: la latitud en la que el cuerpo deja de salir y ponerse, donde las curvas AC y DC se unen sobre su línea MC o IC. Actívalo para dibujar; desactivado (por defecto), se mantienen solo las muestras espaciadas de forma uniforme. |
| 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. |
| latitude_step | number (double) | opcional | Grados de latitud entre puntos de las curvas AC/DC. min 1 · max 15 |
| 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. |
| node | string | opcional | Qué nodo lunar es `north_node`: true (valor por defecto) o mean. truemean |
| projection | string | opcional | mundo (valor por defecto): posiciones verdaderas, latitud incluida. zodiac: posiciones proyectadas sobre la eclíptica, que coinciden 1:1 con una carta relocalizada. mundozodiac |
Ejemplo de solicitud
Este ejemplo aún no está verificado
Los nombres y tipos de campo vienen de la definición de la API y son correctos. Pero este cuerpo concreto no devolvió una respuesta correcta la última vez que lo probamos; puede que le falte un valor que no podemos deducir. Úsalo como punto de partida, no como un comando listo para usar.
curl -X POST https://api.occultapi.com/api/astro/astrocartography/lines/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"node":"true","projection":"mundo"}'Respuesta
Aún no hay una respuesta de ejemplo verificada para este endpoint. La solicitud de arriba se genera a partir de la definición de la API y es correcta; solo publicamos ejemplos de respuesta cuando los hemos comprobado con una llamada real.
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.