/api/astro/lal-kitab/chart/1 créditoMapa do Lal Kitab
O kundli do Lal Kitab: os nove grahas dispostos nas casas fixas, com o pakka ghar de cada um. O Lal Kitab fixa as casas nos signos: a casa 1 é SEMPRE Áries, a casa 2 sempre Touro, e assim por diante até a casa 12, sempre Peixes — em todo mapa, seja qual for o nativo. A casa de um planeta é, portanto, o número do seu signo, e o ascendente não desloca as casas como acontece na astrologia parashari. Por isso, estes endpoints vão divergir de /api/astro/chart/ e /api/astro/planet-positions/ para quase todo mundo. Isso é o sistema, não um erro: são duas tradições diferentes respondendo a duas perguntas diferentes. Cada planeta vem com seu pakka ghar — a casa permanente que o Lal Kitab lhe atribui, que não coincide com a regência de signos. Na astrologia parashari, Vênus rege Touro e Libra, mas seu pakka ghar é apenas a 7ª. Diz-se que um graha no seu próprio pakka ghar está desperto e pode agir plenamente; `in_pakka_ghar` indica quais estão. As posições de base vêm do mesmo motor de /api/astro/planet-positions/, então as longitudes são idênticas — só muda a distribuição pelas casas.
https://api.occultapi.com/api/astro/lal-kitab/chart/Autenticação
Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos da requisição
| Campo | Tipo | Obrigatório | Observações |
|---|---|---|---|
| date_time | string (date-time) | obrigatório | O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes. |
| latitude | number (double) | obrigatório | Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90 |
| longitude | number (double) | obrigatório | Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180 |
| ayanamsa | string | opcional | Ayanamsa para as posições siderais subjacentes. O Lal Kitab em si é baseado em casas e não prescreve nenhum; este valor é repassado ao motor de posições. |
| timezone_as_float | number (double) | opcional | Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14 |
Exemplo de requisição
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}'Resposta
{
"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"
}Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.
Erros
Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.