Ir para o conteúdo

API de cálculo do Ascendente

Envie a data, a hora e o local de nascimento e receba o Ascendente nos dois zodíacos. O Lagna védico vem com signo, grau, nakshatra, pada e regentes; o ascendente ocidental, com elemento e modalidade.

O que é o Ascendente

O Ascendente é o grau do zodíaco que está surgindo no horizonte leste no momento do nascimento. Na astrologia védica, ele é o Lagna: a primeira casa e o ponto de partida para ler o mapa inteiro. Na astrologia ocidental, é o signo ascendente. Ele muda de signo mais ou menos a cada duas horas, por isso o cálculo precisa da hora e do local exatos, e não só da data.

As duas tradições medem a partir de pontos diferentes. O zodíaco védico (sideral) é fixo nas estrelas, e o ocidental (tropical) segue o equinócio. Hoje a diferença entre eles é de cerca de 24°, então a mesma pessoa muitas vezes tem Lagna e signo ascendente diferentes. Este endpoint devolve os dois em uma só chamada.

O que vem em uma chamada

  • lagna: o Ascendente sideral, com signo e rashi, grau, regente do signo, nakshatra, pada, regente do nakshatra e signo no navamsa. Usa Lahiri por padrão; envie ayanamsa para usar outro.
  • rising_sign: o Ascendente tropical da astrologia ocidental, com elemento e modalidade.
  • midheaven: o Meio do Céu (MC) nos dois zodíacos.

O Ascendente não depende do sistema de casas, então não há sistema para escolher. Envie a hora de nascimento com o fuso em relação ao UTC, por exemplo 1990-08-15T10:30:00+05:30, ou informe timezone_as_float. Uma hora sem nenhum dos dois é tratada como horário da Índia (+05:30).

Exemplo de requisição

curl
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}'
Python
import os, requests

response = requests.post(
    "https://api.occultapi.com/api/astro/ascendant/",
    headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
    json={
        "date_time": "1990-08-15T10:30:00+05:30",
        "latitude": 26.9124,
        "longitude": 75.7873
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())
print("credits left:", response.headers.get("X-Credits-Remaining"))
Node.js
const response = await fetch("https://api.occultapi.com/api/astro/ascendant/", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.OCCULT_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "date_time": "1990-08-15T10:30:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873
  }),
});

if (!response.ok) throw new Error(`API error ${response.status}`);
console.log(await response.json());
console.log("credits left:", response.headers.get("X-Credits-Remaining"));
PHP
<?php
$ch = curl_init("https://api.occultapi.com/api/astro/ascendant/");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "X-API-Key: " . getenv("OCCULT_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873}',
]);
echo curl_exec($ch);

Exemplo de resposta

A resposta que essa requisição devolveu.

200 OK
{
  "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"
}

Dúvidas

Por que meu Lagna védico e meu ascendente ocidental são diferentes?
Porque são medidos em zodíacos diferentes. O zodíaco védico é sideral, e o ocidental é tropical. A diferença entre eles, o ayanamsa, hoje é de cerca de 24 graus, então os dois muitas vezes caem em signos diferentes. Cada um está correto dentro do próprio sistema.
A hora de nascimento precisa ser muito exata?
O Ascendente avança cerca de um grau a cada quatro minutos. Poucos minutos podem mudar o grau e, perto da divisa entre dois signos, o próprio signo. A resposta traz o grau exato, para você ver o quanto ele está perto de uma divisa.
Qual ayanamsa é usado no Lagna?
Por padrão, Lahiri (Chitrapaksha), o mais usado na astrologia indiana. Krishnamurti, Raman, Fagan-Bradley e os outros ayanamsas comuns podem ser enviados no campo ayanamsa.
Funciona em qualquer lugar do mundo?
Sim, até 89,9 graus de latitude norte ou sul, inclusive nas latitudes altas em que alguns sistemas de casas falham. Exatamente nos polos, o Ascendente não é definido.

Para os ascendentes especiais (Hora, Ghatika, Bhava e Sree Lagna), veja Lagnas especiais.

Próximos passos