API d’horoscope

Requête

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

curl -X POST https://api.natalchart.ai/v1/horoscope/daily \
  -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},"date":"2026-09-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.

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

Ce que contient la réponse

• positions : la position de chaque corps à midi UTC à cette date, en signe et en degré.
• moon : la phase, son taux d’illumination, le signe de la Lune, la prochaine Nouvelle Lune et la prochaine Pleine Lune.
• events : les événements célestes de la semaine à venir, comme les entrées dans les signes et les stations.
• transits : avec des données de naissance, chaque transit sur le thème natal, avec l’aspect, l’orbe, s’il est appliquant ou séparant, le moment exact et la maison natale où se trouve le corps en transit.
• focus : les trois contacts les mieux classés selon la vitesse de la planète et l’étroitesse de l’orbe, chacun avec un champ tone issu d’une règle fixe (supportive pour le trigone et le sextile, challenging pour le carré et l’opposition, intensifying pour la conjonction).

Limites

• Clé gratuite : 10 requêtes par jour ; API Pro : 1 000.
• Orbes de transit : 2° pour la Lune, le Soleil, Mercure, Vénus et Mars, 3° pour les corps plus lents.
• Ni textes par signe solaire ni texte généré : l’endpoint renvoie des chiffres pour un thème.
• 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 daily_transits et rédigent l’horoscope à partir des transits calculés au lieu de les inventer.

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