/api/astro/kp-chart/1 créditoMapa KP (cúspides, signos e planetas)
Um mapa de Krishnamurti Paddhati dividido em partes com nome, em vez de um único bloco opaco. O KP é uma tradição própria, com muitos seguidores, e até agora só dava para obter o mapa completo se você já conhecesse os nomes das cinco chaves a pedir. Este endpoint retorna o ascendente, as doze cúspides das casas com início, meio e fim, o signo em cada cúspide, a longitude de cada planeta e a casa em que cada planeta cai. O KP usa cúspides Placidus em um zodíaco sideral, e é por isso que suas posições nas casas diferem das de /api/astro/chart/ para o mesmo nascimento. É o sistema funcionando como deve, não uma divergência entre os dois endpoints.
https://api.occultapi.com/api/astro/kp-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 -89.9 · max 89.9 |
| 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 |
| timezone_as_float | number (double) | obrigatório | 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 |
| keys | array | opcional | Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas. |
| new_start | integer | opcional | Início do ajuste de cúspide, repassado diretamente ao motor. |
| notation | string | opcional |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/kp-chart/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-05-10T19:55:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"notation":"degree","new_start":50}'Resposta
{
"data": {
"system": "krishnamurti_paddhati",
"ascendant": 216.7733892763535,
"houses": [
{
"house": 1,
"sign": "Sc",
"start": 216.7733892763535,
"middle": 231.85829168898027,
"end": 246.94319410160705
},
{
"house": 2,
"sign": "Sg",
"start": 246.94319410160705,
"middle": 263.38929149306404,
"end": 279.835388884521
},
{
"house": 3,
"sign": "Cp",
"start": 279.835388884521,
"middle": 296.8815490763593,
"end": 313.92770926819765
},
{
"house": 4,
"sign": "Aq",
"start": 313.92770926819765,
"middle": 329.81303441531793,
"end": 345.69835956243827
},
{
"house": 5,
"sign": "Pi",
"start": 345.69835956243827,
"middle": 179.37096263847687,
"end": 13.043565714515491
},
{
"house": 6,
"sign": "Ar",
"start": 13.043565714515491,
"middle": 24.90847749543448,
"end": 36.77338927635347
},
{
"house": 7,
"sign": "Ta",
"start": 36.77338927635347,
"middle": 51.858291688980245,
"end": 66.94319410160702
},
{
"house": 8,
"sign": "Ge",
"start": 66.94319410160702,
"middle": 83.38929149306404,
"end": 99.83538888452104
},
{
"house": 9,
"sign": "Cn",
"start": 99.83538888452104,
"middle": 116.88154907635936,
"end": 133.92770926819765
},
{
"house": 10,
"sign": "Le",
"start": 133.92770926819765,
"middle": 149.813034415318,
"end": 165.6983595624383
},
{
"house": 11,
"sign": "Vi",
"start": 165.6983595624383,
"middle": 179.3709626384769,
"end": 193.04356571451547
},
{
"house": 12,
"sign": "Li",
"start": 193.04356571451547,
"middle": 204.90847749543448,
"end": 216.7733892763535
}
],
"planet_longitudes": {
"sun": 25.059,
"moon": 213.651,
"mercury": 14.844,
"venus": 342.642,
"mars": 320.082,
"jupiter": 74.022,
"saturn": 270.704,
"uranus": 254.688,
"neptune": 259.811,
"pluto": 201.695,
"northtruenode": 286.265,
"northmeannode": 286.99,
"southtruenode": 106.265,
"southmeannode": 106.99
},
"planet_houses": {
"sun": 6,
"moon": 12,
"mercury": 6,
"venus": 4,
"mars": 4,
"jupiter": 8,
"saturn": 2,
"uranus": 2,
"neptune": 2,
"pluto": 12,
"northtruenode": 3,
"northmeannode": 3,
"southtruenode": 9,
"southmeannode": 9
}
},
"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.