L’API de NatalChart.AI est le moteur de calcul de l’application NatalChart.AI, ouvert aux développeurs. Envoyez une date, une heure et des coordonnées de naissance, et recevez le thème : aucun fichier d’éphémérides à héberger, aucune table de fuseaux horaires à maintenir, aucune bibliothèque d’astrologie à tenir à jour.
Ce que vous pouvez créer
Pages de thème astral
Soleil, Lune et signe ascendant, chaque planète dans son signe et sa maison, les aspects avec leurs orbes et l’équilibre des éléments, pour toute naissance entre 1800 et 2399. /v1/chart/full, /v1/chart/short
Horoscopes du jour d’après le ciel réel
Les transits du jour sur le thème d’une personne, chacun avec son orbe et l’indication qu’il se renforce ou s’estompe, ainsi que la phase de la Lune et les événements célestes de la semaine. /v1/horoscope/daily, /v1/sky
Compatibilité pour les services de rencontre
Deux thèmes comparés : chaque aspect entre eux, les maisons de l’autre personne où tombent les planètes de chacune, et un score pour chaque sphère de vie. /v1/synastry
Prévisions et année à venir
Chaque transit exact sur une période de 92 jours au plus, et le thème de révolution solaire de n’importe quelle année, au lieu de naissance ou là où la personne se trouvera. /v1/transits, /v1/solar-return
Meilleurs jours
Chaque jour d’une période noté pour une activité (affaires, amour, voyages, santé et d’autres encore), avec les transits favorables et défavorables. /v1/timing
Astrocartographie et relocalisation
Une ville notée par rapport à un thème, ou les grandes villes du monde classées pour ce thème, par sphère de vie et par région. /v1/locations/score, /v1/locations/rank
Commencez en une minute
Créez une clé (gratuite, sans carte bancaire), puis envoyez des données de naissance :
curl https://api.natalchart.ai/v1/chart/short \
-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}}'Tous les endpoints, champs et erreurs figurent dans la documentation de l’API, et le document OpenAPI les décrit pour les générateurs de code.
Une précision vérifiable
Zodiaque tropical, maisons Placidus, les cinq aspects majeurs, Nœud vrai, positions à quatre décimales de degré. Le fuseau horaire est déduit des coordonnées avec les règles d’heure d’été en vigueur à la date de naissance, et si l’heure de naissance est inconnue, les maisons et les angles sont omis plutôt que devinés. Le rapport de précision compare le moteur avec NASA JPL Horizons, et le thème de démonstration publié vous permet de vérifier une réponse avant d’écrire la moindre ligne de code.
Pour les assistants IA : le serveur MCP
Les mêmes calculs sont disponibles sous forme de serveur MCP à l’adresse https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor et VS Code s’y connectent avec la même clé et appellent eux-mêmes les outils de thème, de transits et de compatibilité : l’assistant lit ainsi un thème calculé, et non deviné.
Tarifs
| Formule | Prix | Requêtes | Endpoints |
|---|---|---|---|
| Free | $0 | 10 par jour | Thèmes et leurs parties, horoscope du jour, ciel, utilisation |
| API Pro | $6.99 par mois | 1 000 par jour | Tout : transits, synastrie, révolutions solaires, meilleurs jours, lieux |
Le quota est par compte et se renouvelle à 00:00 UTC. Une requête rejetée comme invalide n’est pas comptée, et les données de naissance ne sont jamais conservées : le journal ne garde que l’endpoint, le statut et le temps de réponse.
Questions
Existe-t-il une API d’astrologie gratuite ?
Oui. Une clé NatalChart.AI est gratuite et donne droit à 10 requêtes par jour : thèmes astraux complets ou par parties, le ciel du jour avec les transits sur un thème, et les positions planétaires pour n’importe quelle date. Aucune carte bancaire n’est nécessaire. API Pro ($6.99 par mois) porte le quota à 1 000 par jour et donne accès aux transits sur une période, à la synastrie, aux révolutions solaires, aux meilleurs jours et à l’astrocartographie.
Quelle est la précision des calculs ?
Les positions viennent de Swiss Ephemeris, la référence des logiciels d’astrologie professionnels, avec ses fichiers de données et l’indicateur de vitesse activé. Le même moteur dessine chaque thème dans l’application NatalChart.AI, et le rapport de précision compare ses résultats avec NASA JPL Horizons.
Puis-je bâtir dessus une application d’horoscope ou de compatibilité ?
Oui, c’est sa raison d’être : pages de thème astral, horoscopes du jour fondés sur de vrais transits, scores de compatibilité pour les services de rencontre, sélecteurs de meilleurs jours et cartes de relocalisation. L’usage commercial est autorisé avec les deux formules ; gardez la clé sur votre serveur.
Renvoie-t-elle des interprétations rédigées ?
Non. L’API calcule et renvoie des chiffres : signes, degrés, maisons, aspects avec leurs orbes, scores par sphère de vie. Il n’y a aucun appel à l’IA, donc les mêmes données d’entrée donnent toujours le même résultat, et les mots restent les vôtres ou ceux de votre modèle.
Avec quels langages et frameworks fonctionne-t-elle ?
Avec tout ce qui peut envoyer une requête HTTPS avec un corps JSON : JavaScript, Python, PHP, Swift, Kotlin, outils no-code. La documentation contient des exemples à copier-coller, et un document OpenAPI décrit chaque endpoint pour les générateurs de code.
Les assistants IA peuvent-ils l’utiliser ?
Oui, via le serveur MCP : Claude, ChatGPT, Cursor et VS Code s’y connectent avec la même clé et appellent les calculs comme des outils.