API de synastrie

Requête

Une requête réelle pour deux personnes fictives : les données de naissance de démonstration, à Kyiv, et une seconde naissance à New York.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

Réponse

Une partie de la réponse à cette requête : les champs principaux, avec chaque liste réduite à ses trois premiers éléments.

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

Ce que contient la réponse

• aspects : chaque aspect majeur entre un corps d’un thème et un corps de l’autre, avec son angle et son orbe.
• overlays : la maison où tombent les planètes de chaque personne dans le thème de l’autre, dans les deux sens. Un côté vaut null quand l’heure de naissance de l’autre personne est inconnue, car les maisons en dépendent.
• sphereScores : un score de 0 à 100 pour chaque sphère (identity, love, body, money, home, mind), établi à partir des aspects de synastrie (60 %) et des superpositions de maisons (40 %).
• scoring : la règle qui produit les scores, énoncée dans la réponse. Elle décrit la géométrie de deux thèmes, pas l’avenir d’une relation.

Limites

• Réservé à API Pro. Avec la clé gratuite, l’endpoint renvoie 403 avec un lien pour passer à la formule supérieure.
• Naissances de 1800 à 2399. Zodiaque tropical, maisons Placidus, les cinq aspects majeurs.
• Pas de géocodage : envoyez des coordonnées. Le fuseau horaire en est déduit, avec les règles d’heure d’été en vigueur à la date de naissance.
• Les données de naissance sont lues, utilisées puis oubliées : les corps de requête ne sont jamais conservés.

Dans un assistant IA

Le serveur MCP, à l’adresse https://www.natalchart.ai/mcp, propose le même calcul avec l’outil synastry : Claude, ChatGPT ou Cursor peuvent ainsi comparer deux thèmes avant de parler de compatibilité.

Le reste de l’API

La même clé donne accès à toute l’API d’astrologie : thèmes astraux, transits du jour, synastrie, transits sur une période, révolutions solaires, meilleurs jours et astrocartographie. Tous les endpoints, champs et erreurs figurent dans la documentation, et la page des tarifs précise ce qui compte comme une requête.

Questions