API de révolution solaire

Requête

Une requête réelle : la révolution solaire 2027 du thème de démonstration, au lieu de naissance.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"year":2027}'

Réponse

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

Ce que contient la réponse

• exactMomentUtc : le moment où le Soleil retrouve sa longitude natale, en UTC.
• location : le lieu pour lequel le thème est dressé ; le lieu de naissance, sauf si vous en envoyez un autre.
• natalSun : la longitude du Soleil natal à partir de laquelle la révolution est mesurée.
• chart : le thème complet pour cet instant et ce lieu, sous la même forme que pour l’endpoint du thème natal.

Limites

• Réservé à API Pro. Avec la clé gratuite, l’endpoint renvoie 403 avec un lien pour passer à la formule supérieure.
• Une heure de naissance est obligatoire.
• Zodiaque tropical et maisons Placidus, les mêmes paramètres que pour le thème natal.
• 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

Via le serveur MCP, à l’adresse https://www.natalchart.ai/mcp, les assistants appellent l’outil solar_return et lisent l’année à venir dans un thème calculé.

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