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

Calculadora do ascendente (signo ascendente / Lagna)

O ascendente é o grau do zodíaco que se eleva no horizonte leste no momento e no local do nascimento, também chamado signo ascendente ou Lagna. Uma única chamada o retorna nos dois zodíacos. `lagna` é o ascendente sideral da astrologia védica: signo e rashi, grau, senhor do signo, nakshatra e pada com o senhor do nakshatra, e o signo do navamsa. `rising_sign` é o ascendente tropical da astrologia ocidental, com seu elemento e sua modalidade. O Meio do Céu também vem nos dois zodíacos. O ascendente não depende do sistema de casas, por isso não é preciso informar um. O ayanamsa padrão é Lahiri; passe `ayanamsa` para usar outro. Envie a hora de nascimento com o deslocamento UTC ou informe `timezone_as_float`.

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

Testar requisição

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

Campos da requisição

Campo	Tipo	Obrigatório	Observações
date_time	string	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
ayanamsa	string	opcional	Ayanamsa para o Lagna sideral (védico), sem diferenciar maiúsculas de minúsculas: LAHIRI (padrão), KRISHNAMURTI, RAMAN, FAGAN_BRADLEY e os demais.
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/ascendant/ \
  -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}'

Resposta

{
  "data": {
    "lagna": {
      "longitude": 177.748946,
      "sign": "Virgo",
      "sign_index": 6,
      "degree_in_sign": 27.748946,
      "formatted": "27°44'56\" Virgo",
      "sign_lord": "Mercury",
      "element": "Earth",
      "modality": "Mutable",
      "rashi": "Kanya",
      "nakshatra": "Chitra",
      "nakshatra_index": 14,
      "pada": 2,
      "nakshatra_lord": "Mars",
      "navamsa_sign": "Virgo",
      "navamsa_rashi": "Kanya"
    },
    "rising_sign": {
      "longitude": 201.479077,
      "sign": "Libra",
      "sign_index": 7,
      "degree_in_sign": 21.479077,
      "formatted": "21°28'45\" Libra",
      "sign_lord": "Venus",
      "element": "Air",
      "modality": "Cardinal"
    },
    "midheaven": {
      "sidereal": {
        "longitude": 88.617386,
        "sign": "Gemini",
        "sign_index": 3,
        "degree_in_sign": 28.617386,
        "formatted": "28°37'03\" Gemini",
        "sign_lord": "Mercury",
        "element": "Air",
        "modality": "Mutable"
      },
      "tropical": {
        "longitude": 112.347516,
        "sign": "Cancer",
        "sign_index": 4,
        "degree_in_sign": 22.347516,
        "formatted": "22°20'51\" Cancer",
        "sign_lord": "Moon",
        "element": "Water",
        "modality": "Cardinal"
      }
    },
    "ayanamsa": "LAHIRI",
    "ayanamsa_degrees": 23.73013,
    "date_time_utc": "1990-08-15T05:00:00+00:00",
    "latitude": 26.9124,
    "longitude": 75.7873
  },
  "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.