Thèmes Natals

Calculez des thèmes natals complets avec les positions planétaires, les cuspides de maisons et les aspects.

Calcul de Base

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    }
  }'

Paramètres

Paramètre	Type	Requis	Description
dateTime	string	Oui	Date/heure au format YYYY-MM-DDTHH:mm
location.latitude	number	Oui	Latitude (-90 à 90)
location.longitude	number	Oui	Longitude (-180 à 180)
location.timezone	string	Oui	Identifiant de fuseau horaire IANA
houseSystem	string	Non	Système de maisons (défaut : "placidus")
points	array	Non	Points célestes à calculer (voir Points Disponibles ci-dessous)
orbs	object	Non	Valeurs d'orbe personnalisées par type d'aspect (ex. { "conjunction": 8, "opposition": 6 })
language	string	Non	Code de langue pour le contenu textuel (défaut : "en")
includeText	boolean	Non	Inclure le texte d'interprétation (défaut : false)
includeReadableEntities	boolean	Non	Inclure les titres lisibles des entités (défaut : false)

Systèmes de Maisons

• placidus - Placidus (défaut)
• koch - Koch
• equal - Maison Égale
• whole - Signe Entier
• campanus - Campanus
• regiomontanus - Regiomontanus
• porphyry - Porphyre

Réponse

{
  "data": {
    "dateTime": "1990-06-15T12:30:00.000Z",
    "points": {
      "sun": {
        "pointId": "sun",
        "longitude": 84.5,
        "sign": "gemini",
        "signTitle": "Gemini",
        "degreesInSign": 24.5,
        "degreesInSignDms": [24, 30, 0],
        "houseNumber": 10,
        "houseId": "house-10",
        "retrograde": false,
        "pointTitle": "Sun",
        "houseTitle": "10th House"
      },
      "moon": {
        "pointId": "moon",
        "longitude": 245.2,
        "sign": "sagittarius",
        "signTitle": "Sagittarius",
        "degreesInSign": 5.2,
        "degreesInSignDms": [5, 12, 0],
        "houseNumber": 4,
        "houseId": "house-4",
        "retrograde": false,
        "pointTitle": "Moon",
        "houseTitle": "4th House"
      }
    },
    "houses": {
      "cusps": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 210.3, "longitudeDms": { "degrees": 210, "minutes": 18, "seconds": 0 }, "sign": "scorpio" }
      ],
      "ascmc": [
        { "longitude": 180.5, "longitudeDms": { "degrees": 180, "minutes": 30, "seconds": 0 }, "sign": "libra" },
        { "longitude": 270.2, "longitudeDms": { "degrees": 270, "minutes": 12, "seconds": 0 }, "sign": "capricorn" }
      ]
    },
    "aspects": [
      {
        "pointA": "sun",
        "pointB": "moon",
        "aspect": "opposition",
        "angle": 160.7,
        "orb": 0.7,
        "applying": false,
        "pointATitle": "Sun",
        "pointBTitle": "Moon",
        "aspectTitle": "Opposition"
      }
    ],
    "chart": {
      "url": "https://api.astroapi.cloud/api/chart2/natal.svg?..."
    }
  }
}

Cuspides de Maisons

Chaque objet de cuspide inclut longitude (degrés écliptiques), longitudeDms (degrés/minutes/secondes) et sign (identifiant du signe du zodiaque). La première cuspide (cusps[0]) est l'Ascendant. Le tableau ascmc contient l'Ascendant, le MC, l'ARMC et le Vertex.

Points Disponibles

Utilisez le paramètre points pour sélectionner les points célestes à calculer. Si omis, l'ensemble par défaut est utilisé.

Points par Défaut

sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, meanNode, trueNode, meanApogee, osculatingApog

Tous les Points Disponibles

Identifiant du Point	Description
sun	Soleil
moon	Lune
mercury	Mercure
venus	Vénus
mars	Mars
jupiter	Jupiter
saturn	Saturne
uranus	Uranus
neptune	Neptune
pluto	Pluton
meanNode	Noeud Nord Moyen
trueNode	Noeud Nord Vrai
meanApogee	Lilith Moyenne (Lune Noire)
osculatingApog	Lilith Vraie (Lune Noire)
chiron	Chiron
pholus	Pholus
ceres	Cérès
pallas	Pallas
juno	Junon
vesta	Vesta
interpolatedLunarApogee	Apogée Lunaire Interpolée
interpolatedLunarPerigee	Périgée Lunaire Interpolée (Priape)
earth	Terre

Exemple : Calculer Uniquement le Soleil et Mars

curl -X POST "https://api.astroapi.cloud/api/calc/natal" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": "Europe/London"
    },
    "points": ["sun", "mars"]
  }'

La réponse contiendra sun et mars dans l'objet points, ainsi que les quatre angles dans l'objet angles :

{
  "data": {
    "points": {
      "sun": { "pointId": "sun", "longitude": 84.5, "sign": "gemini", ... },
      "mars": { "pointId": "mars", "longitude": 12.3, "sign": "aries", ... }
    },
    "angles": {
      "ascendant": {
        "pointId": "ascendant",
        "longitude": 180.5,
        "degreesInSign": 0.5,
        "degreesInSignDms": [0, 30, 0],
        "sign": "libra"
      },
      "descendant": { "pointId": "descendant", "longitude": 0.5, "sign": "aries", ... },
      "midheaven": { "pointId": "midheaven", "longitude": 270.2, "sign": "capricorn", ... },
      "imumCoeli": { "pointId": "imumCoeli", "longitude": 90.2, "sign": "cancer", ... }
    },
    "houses": { ... },
    "aspects": [ ... ]
  }
}

Angles

Les quatre angles (ascendant, descendant, midheaven, imumCoeli) sont toujours inclus dans l'objet angles, indépendamment du paramètre points. Les angles sont dérivés des calculs de maisons, pas de l'éphéméride, et ont donc une structure plus simple (pas de données de vitesse ou de rétrogradation). Le tableau ascmc dans la réponse houses contient également toujours les longitudes brutes des angles.

Lune & Soleil

Calculez la phase lunaire, l'illumination, les heures de lever/coucher et les données de position du soleil.

POST /api/calc/moon-sun

curl -X POST "https://api.astroapi.cloud/api/calc/moon-sun" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "2024-06-15T12:00",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

Paramètres

Paramètre	Type	Requis	Description
dateTime	string	Oui	Date/heure au format YYYY-MM-DDTHH:mm
location.latitude	number	Oui	Latitude (-90 à 90)
location.longitude	number	Oui	Longitude (-180 à 180)
location.timezone	string	Oui	Identifiant de fuseau horaire IANA

Module Requis

Cet endpoint nécessite le module module:moon.

Réponse

{
  "data": {
    "moon": {
      "phaseName": "Waxing Gibbous",
      "phase": 0.62,
      "illumination": 0.78,
      "age": 9.2,
      "distance": 384400,
      "diameterDegrees": 0.52,
      "rise": "2024-06-15T14:23:00Z",
      "set": "2024-06-16T02:15:00Z"
    },
    "sun": {
      "rise": "2024-06-15T05:18:00Z",
      "set": "2024-06-15T22:03:00Z",
      "transit": "2024-06-15T13:40:00Z",
      "distance": 151820000,
      "diameterDegrees": 0.524,
      "twilight": {
        "civil": {
          "begin": "2024-06-15T04:38:00Z",
          "end": "2024-06-15T22:43:00Z"
        },
        "nautical": {
          "begin": "2024-06-15T03:32:00Z",
          "end": "2024-06-15T23:49:00Z"
        },
        "astronomical": {
          "begin": null,
          "end": null
        }
      }
    }
  }
}

Précision des Calculs

AstroAPI lit directement l'éphéméride JPL DE442 de la NASA pour des positions planétaires avec une précision sub-milliarcseconde. Consultez la page Précision des Calculs pour tous les détails sur nos sources de données et corrections.