Aller au contenu

API de calcul de l’ascendant

Envoyez une date, une heure et un lieu de naissance ; vous recevez l’ascendant dans les deux zodiaques. Le lagna védique est fourni avec son signe, son degré, son nakshatra, son pada et ses maîtres ; le signe ascendant occidental avec son élément et sa modalité.

Qu’est-ce que l’ascendant ?

L’ascendant est le degré du zodiaque qui se lève à l’horizon est au moment de la naissance. En astrologie védique, c’est le lagna, la première maison, le point à partir duquel on lit tout le thème ; en astrologie occidentale, c’est le signe ascendant. Il change de signe environ toutes les deux heures : il faut donc l’heure et le lieu exacts, pas seulement la date.

Les deux traditions ne le mesurent pas à partir du même point de départ. Le zodiaque védique (sidéral) est fixé sur les étoiles, le zodiaque occidental (tropical) sur l’équinoxe ; aujourd’hui, environ 24° les séparent, si bien qu’une même naissance a souvent un lagna et un signe ascendant différents. Cet endpoint renvoie les deux en un seul appel.

Ce que renvoie un appel

  • lagna : l’ascendant sidéral, avec le signe et la rashi, le degré, le maître du signe, le nakshatra, le pada, le maître du nakshatra et le signe navamsa. Lahiri par défaut ; passez ayanamsa pour en choisir un autre.
  • rising_sign : l’ascendant tropical utilisé en astrologie occidentale, avec son élément et sa modalité.
  • midheaven : le milieu du ciel (MC) dans les deux zodiaques.

L’ascendant ne dépend pas du système de maisons : il n’y en a donc aucun à choisir. Envoyez l’heure de naissance avec son décalage UTC, par exemple 1990-08-15T10:30:00+05:30, ou renseignez timezone_as_float ; une heure sans l’un ni l’autre est interprétée comme heure indienne (+05:30).

Exemple de requête

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);

Exemple de réponse

La réponse renvoyée pour cette requête.

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"
}

Questions

Pourquoi mon lagna védique et mon signe ascendant occidental diffèrent-ils ?
Ils sont mesurés dans deux zodiaques différents : sidéral pour le védique, tropical pour l’occidental. L’écart entre les deux, l’ayanamsa, est d’environ 24 degrés aujourd’hui, si bien qu’ils tombent souvent dans des signes différents. Chacun est juste dans son propre système.
Quelle précision faut-il pour l’heure de naissance ?
L’ascendant avance d’environ un degré toutes les quatre minutes : quelques minutes peuvent changer le degré et, près d’une limite de signe, le signe lui-même. La réponse donne le degré exact, pour que vous voyiez à quelle distance se trouve la limite.
Quel ayanamsa est utilisé pour le lagna ?
Lahiri (Chitrapaksha) par défaut, la référence en astrologie indienne. Krishnamurti, Raman, Fagan-Bradley et les autres ayanamsas courants peuvent être passés dans le champ ayanamsa.
Cela fonctionne-t-il partout sur Terre ?
Oui, jusqu’à 89,9 degrés de latitude nord ou sud, y compris aux hautes latitudes où certains systèmes de maisons échouent. Aux pôles mêmes, l’ascendant n’est pas défini.

Pour les ascendants spéciaux (Hora, Ghatika, Bhava et Sree lagna), consultez Lagnas spéciaux.

Suivant