API de transits

Requête

Une requête réelle pour le thème de démonstration, sur un mois :

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

Réponse

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

Ce que contient la réponse

• window : les dates que vous avez demandées.
• events : jusqu’à 60 aspects exacts formés par les corps en transit avec les corps natals, entrées dans les signes et stations, par ordre chronologique, chacun avec son moment en UTC, sa position et les maisons concernées. Quand une période en contient davantage, les plus importants sont retenus.
• activeOnFirstDay : les transits déjà dans l’orbe le premier jour, avec les orbes utilisés.
• Chaque événement est classé par importance (high, medium ou low) selon les corps concernés.

Limites

• Réservé à API Pro, avec 92 jours et 60 événements au plus par requête. Avec la clé gratuite, l’endpoint renvoie 403 avec un lien pour passer à la formule supérieure.
• Naissances de 1800 à 2399. Les maisons d’un transit exigent une heure de naissance ; sans elle, elles sont omises.
• Chaque moment exact est recherché avec Swiss Ephemeris et donné en UTC.
• 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 transits pour une période et daily_transits pour une seule journée, et lisent de vrais transits au lieu de les deviner.

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