POST/api/astro/chart_analysis/1 crédito

Análisis de la carta

Catorce lecturas estructurales de una carta natal en una sola llamada, más una comparación entre una carta natal y una carta de tránsito. Es la capa interpretativa que está por encima de /api/astro/chart/: no te da posiciones, te dice lo que esas posiciones significan. La respuesta siempre incluye los mismos campos. `house_from_reference_chart` indica en qué casa cae `target_celestial` de la carta de tránsito, contando desde `ref_celestial` de la carta natal. `kendras` agrupa los cuerpos natales por casa angular. `argala` y `virodhargala` dan los planetas que intervienen y los que obstruyen para cada cuerpo, indexados por las casas 2, 4, 5 y 11 y por las casas 12, 10, 9 y 3, respectivamente. `bhava_arudhas` y `ghara_arudhas` son las imágenes proyectadas de las casas y de los planetas. `temporary_relationships` y `compound_relationships` son las amistades propias de la carta. `karakas` son los chara karakas; `nakshatra_count`, la distancia en estrellas desde el cuerpo de referencia, y `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` y `pachakadi_relations`, las comprobaciones de dignidad. Las dos cartas son siempre cartas Rashi: `chart_name_natal` y `chart_name_transit` son etiquetas de formato libre y, pese a su nombre, no seleccionan una carta divisional. `mode` elige entre ocho o siete chara karakas, y `rahu` elige nodos verdaderos o medios solo para el bloque de karakas. Puedes poner `ref_celestial` en 'ascendant'; en ese caso, los dos campos de relaciones, que por definición son entre planetas, devuelven null.

https://api.occultapi.com/api/astro/chart_analysis/

Probar solicitud

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/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
chart_name_natal	string	obligatorio	Etiqueta de FORMATO LIBRE, NO un selector de tipo de carta. Pese al nombre, este endpoint siempre construye un RashiChart; la cadena se guarda solo como etiqueta para mostrar y nunca se valida. Sirve cualquier cadena no vacía.
chart_name_transit	string	obligatorio	Etiqueta de FORMATO LIBRE, NO un selector de tipo de carta. Igual que chart_name_natal.
date_time_natal	string (date-time)	obligatorio	Restricción de FORMATO. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC).
date_time_transit	string (date-time)	obligatorio	Restricción de FORMATO. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC).
latitude_natal	number (double)	obligatorio	min -180 · max 180
latitude_transit	number (double)	obligatorio	min -180 · max 180
longitude_natal	number (double)	obligatorio	min -180 · max 180
longitude_transit	number (double)	obligatorio	min -180 · max 180
mode	integer	obligatorio	`78` Un entero (no una cadena) con valores restringidos: 8 = ocho chara karakas (incluye Pitri Karaka y Rahu), 7 = siete karakas (sin Rahu). Solo tienen sentido 7 y 8.
rahu	string	obligatorio	`truemean` En minúsculas; distingue mayúsculas y minúsculas. Solo se comprueba expresamente 'true'; cualquier otro valor (incluido 'mean') va a la rama else y se comporta como 'mean'. Solo afecta al bloque `karakas`.
ref_celestial	string	obligatorio	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` En minúsculas; distingue mayúsculas y minúsculas. 'ascendant' funciona en las partes house_from_reference_chart y nakshatra_count; con ref_celestial='ascendant', los campos temporary_relationships y compound_relationships devuelven null a propósito. Un nombre que no se reconoce devuelve 400 (KeyError).
target_celestial	string	obligatorio	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` Admite los mismos valores que ref_celestial.
bhava_arudha_exceptions	boolean	opcional
graha_arudha_exceptions	boolean	opcional
nakshatras	string	opcional

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/chart_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"mercury","target_celestial":"mars","rahu":"true","mode":0}'

Respuesta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"house_from_reference_chart\": {\"house_from_ref\": 9, \"zodiac_sign_in_ref\": \"Cn\"}, \"kendras\": [[\"venus\", \"jupiter\", \"pluto\"], [\"sun\", \"moon\", \"mercury\", \"mars\", \"uranus\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], [\"saturn\", \"neptune\"]], \"argala\": {\"sun\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"moon\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"mercury\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"venus\": {\"2\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"4\": [\"pluto\"], \"5\": [\"northtruenode\", \"northmeannode\"], \"11\": [\"southtruenode\", \"southmeannode\"]}, \"mars\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"jupiter\": {\"2\": [\"southtruenode\", \"southmeannode\"], \"4\": [\"venus\"], \"5\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"11\": [\"uranus\"]}, \"saturn\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"uranus\": {\"2\": null, \"4\": [\"southtruenode\", \"southmeannode\"], \"5\": null, \"11\": [\"saturn\", \"neptune\"]}, \"neptune\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"pluto\": {\"2\": [\"northtruenode\", \"northmeannode\"], \"4\": null, \"5\": [\"uranus\"], \"11\": [\"sun\", \"moon\", \"mercury\", \"mars\"]}, \"northtruenode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"northmeannode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"southtruenode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}, \"southmeannode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}}, \"virodhargala\": {\"sun\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"moon\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"mercury\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"venus\": {\"3\": null, \"9\": null, \"10\": [\"jupiter\"], \"12\": null}, \"mars\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"jupiter\": {\"3\": null, \"9\": [\"saturn\", \"neptune\"], \"10\": null, \"12\": null}, \"saturn\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"uranus\": {\"3\": [\"jupiter\"], \"9\": [\"pluto\"], \"10\": [\"northtruenode\", \"northmeannode\"], \"12\": null}, \"neptune\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"pluto\": {\"3\": [\"saturn\", \"neptune\"], \"9\": null, \"10\": [\"venus\"], \"12\": null}, \"northtruenode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"northmeannode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"southtruenode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}, \"southmeannode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}}, \"bhava_arudhas\": {\"A1\": \"Taurus\", \"A2\": \"Aries\", \"A3\": \"Scorpio\", \"A4\": \"Gemini\", \"A5\": \"Pisces\", \"A6\": \"Aries\", \"A7\": \"Pisces\", \"A8\": \"Scorpio\", \"A9\": \"Capricorn\", \"A10\": \"Cancer\", \"A11\": \"Leo\", \"A12\": \"Aquarius\"}, \"ghara_arudhas\": {\"A1\": \"Leo\", \"A2\": \"Leo\", \"A3\": \"Leo\", \"A4\": \"Cancer\", \"A5\": \"Leo\", \"A6\": \"Pisces\", \"A7\": \"Scorpio\", \"A8\": \"Pisces\", \"A9\": \"Scorpio\", \"A10\": \"Taurus\", \"A11\": \"Aries\", \"A12\": \"Aries\"}, \"temporary_relationships\": {\"friends\": [\"venus\", \"pluto\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], \"enemies\": [\"sun\", \"moon\", \"mars\", \"jupiter\", \"saturn\", \"uranus\", \"neptune\"]}, \"compound_relationships\": \"Satru\", \"karakas\": {\"ak\": {\"venus\": {\"degree\": 23, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 43}}, \"amk\": {\"mars\": {\"degree\": 17, \"sign\": \"Sc\", \"minutes\": 52, \"seconds\": 44}}, \"bk\": {\"moon\": {\"degree\": 15, \"sign\": \"Sc\", \"minutes\": 20, \"seconds\": 27}}, \"mk\": {\"northtruenode\""
}

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.