POSThttps://api.occultapi.com/api/astro/kalsarp/

Kala Sarpa yoga

Corpo da requisiçãoJSON

Cole uma chave de API acima para enviar.

Trecho de código

curl -X POST https://api.occultapi.com/api/astro/kalsarp/ \
  -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}'

Se o mapa forma Kala Sarpa — todos os sete grahas, do Sol a Saturno, confinados em um dos dois semicírculos em que o eixo Rahu–Ketu divide o zodíaco — e, se formar, qual das doze formas nomeadas ele é. A maioria dos mapas NÃO é Kala Sarpa: basta um único graha do outro lado do eixo para desfazer o yoga. Por isso, este endpoint não retorna um simples sim ou não. `between_rahu_and_ketu` e `between_ketu_and_rahu` mostram de que lado ficou cada graha, o que permite ver por que a resposta saiu assim — e é o que distingue um mapa em que só um graha escapa de outro em que escapam quatro. Os doze nomes (Anant, Kulik, Vasuki, Shankhpal, Padma, Mahapadma, Takshak, Karkotak, Shankhachud, Ghatak, Vishdhar, Sheshnag) dependem da casa que Rahu ocupa, e `name` só é preenchido quando o yoga está de fato formado — nunca para um mapa que apenas chegou perto. Um graha a menos de um grau de qualquer um dos nodos não pertence a nenhum dos lados. Esses grahas aparecem em `conjunct_a_node` e marcam `partial`, em vez de serem empurrados para um dos lados só para forçar um veredito. As posições vêm do mesmo motor de /api/astro/planet-positions/, então as longitudes são necessariamente idênticas.

Campos 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
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

Referência completa deste endpoint