/api/astro/lal-kitab/chart/1 créditoCarta de Lal Kitab
El kundli de Lal Kitab: los nueve grahas situados en las casas fijas, cada uno con su pakka ghar. Lal Kitab fija las casas a los signos: la casa 1 es SIEMPRE Aries, la casa 2 siempre Tauro, y así hasta la casa 12, siempre Piscis, en todas las cartas, sea quien sea el nativo. Por tanto, la casa de un planeta es su número de signo, y el ascendente no mueve las casas como en la astrología parashari. Esto significa que estos endpoints discreparán de /api/astro/chart/ y /api/astro/planet-positions/ para casi todo el mundo. Es el sistema, no un error: son dos tradiciones distintas que responden a dos preguntas distintas. Cada planeta se devuelve con su pakka ghar: la casa permanente que Lal Kitab le asigna, que no coincide con su regencia de signo. En la astrología parashari, Venus rige Tauro y Libra, pero su pakka ghar es solo la casa 7. Se dice que un graha situado en su propio pakka ghar está despierto y puede actuar plenamente; `in_pakka_ghar` te indica cuáles lo están. Las posiciones subyacentes proceden del mismo motor que /api/astro/planet-positions/, así que las longitudes son idénticas: solo difiere la distribución en casas.
https://api.occultapi.com/api/astro/lal-kitab/chart/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. |
| latitude | number (double) | obligatorio | 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 -90 · max 90 |
| longitude | number (double) | obligatorio | 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 |
| ayanamsa | string | opcional | Ayanamsa para las posiciones siderales subyacentes. Lal Kitab en sí se basa en las casas y no prescribe ninguno; se pasa directamente al motor de posiciones. |
| 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 |
Ejemplo de solicitud
curl -X POST https://api.occultapi.com/api/astro/lal-kitab/chart/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Respuesta
{
"data": {
"system": "Lal Kitab",
"house_system": "fixed",
"note": "Houses are fixed to signs: house 1 is always Aries. A planet's house is its sign number, and the ascendant does not move the houses.",
"ascendant": {
"longitude": 177.7489463338338,
"zodiac_name": "Virgo",
"nakshatra": "Chitra",
"pada": 2
},
"planets": [
{
"planet": "sun",
"sign": "Cancer",
"house": 4,
"longitude": 118.395,
"nakshatra": "Aasresha",
"pakka_ghar": [
1
],
"in_pakka_ghar": false
},
{
"planet": "moon",
"sign": "Taurus",
"house": 2,
"longitude": 48.93,
"nakshatra": "Rohini",
"pakka_ghar": [
4
],
"in_pakka_ghar": false
},
{
"planet": "mars",
"sign": "Aries",
"house": 1,
"longitude": 27.487,
"nakshatra": "Krittika",
"pakka_ghar": [
3,
8
],
"in_pakka_ghar": false
},
{
"planet": "mercury",
"sign": "Leo",
"house": 5,
"longitude": 145.446,
"nakshatra": "Poorva Phalguni",
"pakka_ghar": [
6,
7
],
"in_pakka_ghar": false
},
{
"planet": "jupiter",
"sign": "Cancer",
"house": 4,
"longitude": 95.607,
"nakshatra": "Pushyami",
"pakka_ghar": [
2,
5,
9,
12
],
"in_pakka_ghar": false
},
{
"planet": "venus",
"sign": "Cancer",
"house": 4,
"longitude": 97.843,
"nakshatra": "Pushyami",
"pakka_ghar": [
7
],
"in_pakka_ghar": false
},
{
"planet": "saturn",
"sign": "Sagittarius",
"house": 9,
"longitude": 266.148,
"nakshatra": "Poorvaashaadha",
"pakka_ghar": [
8,
10,
11
],
"in_pakka_ghar": false
},
{
"planet": "rahu",
"sign": "Capricorn",
"house": 10,
"longitude": 283.503,
"nakshatra": "Sravanam",
"pakka_ghar": [
12
],
"in_pakka_ghar": false
},
{
"planet": "ketu",
"sign": "Cancer",
"house": 4,
"longitude": 103.503,
"nakshatra": "Pushyami",
"pakka_ghar": [
6
],
"in_pakka_ghar": false
}
],
"houses": [
{
"house": 1,
"sign": "Aries",
"planets": [
"mars"
]
},
{
"house": 2,
"sign": "Taurus",
"planets": [
"moon"
]
},
{
"house": 3,
"sign": "Gemini",
"planets": []
},
{
"house": 4,
"sign": "Cancer",
"planets": [
"sun",
"jupiter",
"venus",
"ketu"
]
},
{
"house": 5,
"sign": "Leo",
"planets": [
"mercury"
]
},
{
"house": 6,
"sign": "Virgo",
"planets": []
},
{
"house": 7,
"sign": "Libra",
"planets": []
},
{
"house": 8,
"sign": "Scorpio",
"planets": []
},
{
"house": 9,
"sign": "Sagittarius",
"planets": [
"saturn"
]
},
{
"house": 10,
"sign": "Capricorn",
"planets": [
"rahu"
]
},
{
"house": 11,
"sign": "Aquarius",
"planets": []
},
{
"house": 12,
"sign": "Pisces",
"planets": []
}
],
"in_pakka_ghar": []
},
"status": 200,
"is_error": false,
"message": "successful"
}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.