POST/api/astro/western/house-cusps/1 crédit

Cuspides des maisons occidentales

Cuspides des maisons tropicales, avec l’ascendant, le Milieu du Ciel et le vertex. Huit systèmes de maisons : placidus (le système occidental par défaut), koch, porphyry, regiomontanus, campanus, equal, whole_sign et topocentric. Passez `house_system` ; par défaut : placidus. L’ascendant EST la cuspide de la maison 1 et le Milieu du Ciel EST celle de la maison 10 ; cet endpoint les tire d’un seul et même calcul, si bien qu’ils ne peuvent pas diverger. Deux exceptions, qui sont correctes et non des bogues : avec whole_sign, la première cuspide est à 0 degré du signe QUI CONTIENT l’ascendant, et non sur l’ascendant lui-même ; avec equal et whole_sign, le Milieu du Ciel est indépendant de la cuspide de la maison 10, car ces systèmes divisent à partir de l’ascendant et non du méridien. TROPICAL, pas sidéral — voir /api/astro/western/planets/. Pour les maisons védiques, utilisez /api/astro/house/ ou /api/astro/bhava-cusps/, qui sont sidéraux. Les cuspides opposées sont séparées d’exactement 180 degrés et les douze se suivent dans l’ordre du zodiaque ; des tests vérifient ces deux propriétés.

https://api.occultapi.com/api/astro/western/house-cusps/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Champs de la requête

Champ	Type	Obligatoire	Remarques
date_time	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes.
latitude	number (double)	obligatoire	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9
longitude	number (double)	obligatoire	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180
timezone_as_float	number (double)	obligatoire	Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14
ayanamsa	string	facultatif	TROPICAL (par défaut) ou un nom d’ayanamsa tel que LAHIRI, KRISHNAMURTI, RAMAN ou FAGAN_BRADLEY, insensible à la casse. Avec un ayanamsa sidéral, sa valeur à l’instant considéré est soustraite de chaque longitude renvoyée.
house_system	string	facultatif	`campanusequalkochplacidusporphyryregiomontanustopocentricwhole_sign`
include_asteroid_lilith	boolean	facultatif	Ajouter l’astéroïde (1181) Lilith, à ne pas confondre avec la Lune noire (Lilith), sous le nom "asteroid_lilith", après les autres corps.
include_lilith	boolean	facultatif	Ajouter la Lune noire, ou Lilith (l’apogée lunaire moyen), comme corps nommé "lilith", après les autres corps.
keys	array	facultatif	Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/western/house-cusps/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","timezone_as_float":5.5,"latitude":19.2056,"longitude":25.2056,"house_system":"placidus"}'

Réponse

{
  "data": {
    "zodiac": "tropical",
    "house_system": "placidus",
    "houses": [
      {
        "house": 1,
        "degree": 198.47822,
        "sign": "Libra",
        "sign_index": 7,
        "degree_in_sign": 18.4782,
        "formatted": "18°28' Libra"
      },
      {
        "house": 2,
        "degree": 227.924979,
        "sign": "Scorpio",
        "sign_index": 8,
        "degree_in_sign": 17.925,
        "formatted": "17°55' Scorpio"
      },
      {
        "house": 3,
        "degree": 257.82276,
        "sign": "Sagittarius",
        "sign_index": 9,
        "degree_in_sign": 17.8228,
        "formatted": "17°49' Sagittarius"
      },
      {
        "house": 4,
        "degree": 288.075708,
        "sign": "Capricorn",
        "sign_index": 10,
        "degree_in_sign": 18.0757,
        "formatted": "18°04' Capricorn"
      },
      {
        "house": 5,
        "degree": 318.958731,
        "sign": "Aquarius",
        "sign_index": 11,
        "degree_in_sign": 18.9587,
        "formatted": "18°57' Aquarius"
      },
      {
        "house": 6,
        "degree": 349.697605,
        "sign": "Pisces",
        "sign_index": 12,
        "degree_in_sign": 19.6976,
        "formatted": "19°41' Pisces"
      },
      {
        "house": 7,
        "degree": 18.47822,
        "sign": "Aries",
        "sign_index": 1,
        "degree_in_sign": 18.4782,
        "formatted": "18°28' Aries"
      },
      {
        "house": 8,
        "degree": 47.924979,
        "sign": "Taurus",
        "sign_index": 2,
        "degree_in_sign": 17.925,
        "formatted": "17°55' Taurus"
      },
      {
        "house": 9,
        "degree": 77.82276,
        "sign": "Gemini",
        "sign_index": 3,
        "degree_in_sign": 17.8228,
        "formatted": "17°49' Gemini"
      },
      {
        "house": 10,
        "degree": 108.075708,
        "sign": "Cancer",
        "sign_index": 4,
        "degree_in_sign": 18.0757,
        "formatted": "18°04' Cancer"
      },
      {
        "house": 11,
        "degree": 138.958731,
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 18.9587,
        "formatted": "18°57' Leo"
      },
      {
        "house": 12,
        "degree": 169.697605,
        "sign": "Virgo",
        "sign_index": 6,
        "degree_in_sign": 19.6976,
        "formatted": "19°41' Virgo"
      }
    ],
    "ascendant": {
      "degree": 198.47822,
      "sign": "Libra",
      "sign_index": 7,
      "degree_in_sign": 18.4782,
      "formatted": "18°28' Libra"
    },
    "midheaven": {
      "degree": 108.075708,
      "sign": "Cancer",
      "sign_index": 4,
      "degree_in_sign": 18.0757,
      "formatted": "18°04' Cancer"
    },
    "vertex": {
      "degree": 309.637083,
      "sign": "Aquarius",
      "sign_index": 11,
      "degree_in_sign": 9.6371,
      "formatted": "9°38' Aquarius"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.