Lancement de l'API AstroWay : pile complète de calculs astrologiques avec la précision de Swiss Ephemeris

Aujourd’hui nous annonçons AstroWay API - le backend de calcul pour les développeurs qui créent des applications astrologiques, des produits horoscopiques, des fonctionnalités de compatibilité pour les rencontres et des agents IA qui doivent raisonner sur les cartes natales.

Dans cet article - ce qui se trouve vraiment à l’intérieur de l’API, quelles solutions non conventionnelles nous avons adoptées, ce que nous avons délibérément laissé entre parenthèses et comment nous en sommes arrivés là. Sans fluff.

🕓 Entry from 2026-04-22, updated 2026-05-09. Certains chiffres sont dépassés. État actuel : 865 endpoints (pas 87 au lancement), 888 tests snapshot CI (pas 183), MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk maintenant tous en ligne sur les registres publics. Statut frais - à /faq et journal des modifications.

REST API basé sur Swiss Ephemeris - désormais aussi avec des interprétations IA au-dessus des véritables calculs. Le même moteur qu’utilisent les astrologues professionnels depuis 30+ ans dans Solar Fire, Kepler, Astro Gold et Janus - précision jusqu’à une fraction de seconde d’arc, vérifiée contre l’éphéméride NASA JPL et la référence officielle swetest d’Astrodienst (Astro.com).

Chiffres :

• 865 endpoint : astrologie natale occidentale, synastrie, transits, progressions, directions, retours, harmoniques, étoiles fixes, points arabes, astrocartographie plus l’ensemble complet Human Design
• 183 tests snapshot dans CI contre la sortie réelle swetest CGI et le catalogue d’éclipses NASA - exécutés à chaque PR
• p50 < 100 ms, p95 < 500 ms pour les endpoints de calcul typiques
• MCP server @astroway/mcp + trois SDK sur les registres publics : @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - le même API en trois langues
• MCP server : @astroway/mcp - expose l’API sous forme d’outils pour Claude, GPT, Cursor et autres agents LLM
• Forfaits basés sur les crédits : plan gratuit (10 000 crédits / mois, sans carte), payants - à partir de $5 / mois

Documentation complète : api.astroway.info/docs/api/. Statut en direct : api.astroway.info/status.

Il y a trois ans, nous avons commencé à construire des applications astrologiques grand public. La couche de calcul s’est révélée être la partie la plus complexe - nettement plus complexe que l’UI ou le contenu. Les services existants sont soit :

1. Aveva une couverture superficielle (10–30 endpoints, principalement uniquement natal)
2. Étaient coûteux à l’échelle ($0,02–$0,10 par requête sans remise en volume)
3. Utilisaient des moteurs fermés, dont la précision ne pouvait pas être vérifiée
4. Étaient orientés vers l’astrologie védique, tandis que l’astrologie occidentale était présentée comme secondaire

Donc nous avons vendored Swiss Ephemeris indépendamment et écrit notre propre couche de calcul - d’abord pour le produit grand public app.astroway.info, puis pour le site marketing astroway.info, qui publie des horoscopes quotidiens à des centaines de milliers de visiteurs par mois.

Après trois ans d’exécution de ce code en production, nous sommes parvenus à deux conclusions :

1. Ce même moteur de calcul doit être accessible aux autres développeurs : non pas parce qu’ils ne pourraient pas l’écrire eux-mêmes, mais parce que la pile bibliothèque + mise en cache + CI sur la précision représente six mois de travail que personne ne devrait répéter.
2. Notre couverture Human Design (12 endpoints : carte, type, autorité, profil, portes, canaux, contours, activations planétaires, incarnation cross, définition) - est vraiment unique. Aucun concurrent ne propose une pile HD complète via API.

Nous avons /nakshatras, /ashtakavarga et des endpoints pour les cartes divisionnelles, mais pas de Dasha, Panchang, Ashtakoota, KP. La raison : en astrologie védique, il existe des désaccords non résolus entre les écoles (guerres d’ayanamsha, débats sur les cuspides KP, choix de l’école de dasha). Une partie védique faite à la hâte contre Prokerala et VedicAstroAPI aurait simplement attiré des critiques.

La décision est fixée : le paquet védique - phase 3 séparée, après qu’il y ait une demande stable pour l’occidental et qu’il soit temps de le valider par rapport à Jagannatha Hora et Parashara’s Light. Mieux vaut ne pas lancer du tout que de lancer mal.

Un appel /chart coûte environ 50 fois moins de calculs qu’un /forecast-calendar de 365 jours. Un prix fixe par requête éliminerait soit les utilisateurs légers, soit subventionnerait les lourds. Les crédits mappent le coût au travail réel - voir le tableau par endpoint sur la page tarifaire.

Les réponses sur le plan gratuit contiennent le champ _footer :

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Ça ne nous coûte rien, et cela donne aux utilisateurs gratuits un petit incitatif à mettre à jour. Sur le plan Hobby+, cela disparaît dans les paramètres de la clé. Nous avons emprunté ce modèle à Zapier et RevenueCat.

/rectification (sélection de l’heure de naissance basée sur les événements de la vie via recherche likelihood-grid) - coûteux en calcul : un appel dure 10–60 secondes et effectue des dizaines de milliers de calculs intermédiaires Swiss Ephemeris. Nous l’avons limité au plan Pro ($59 / mois) et fixé un coût élevé en crédits, car un abus mettrait à mal l’infrastructure partagée pour tous les autres.

Les endpoints /interpret/* fonctionnent via notre passerelle AI privée avec basculement automatique entre plusieurs modèles. Nous ne te bloquons pas dans nos prompts - chaque réponse contenant une interprétation inclut les calculs de base, donc tu peux remplacer par ta propre LLM si notre voix ne te convient pas. Nous journalisons les prompts complets et les sorties dans une table d’audit pour la conformité B2B (rétention de 90 jours).

• Paquet védique : phase 3, après les premières confirmations de demande (voir ci-dessus)
• Webhooks de seuil atteints : implémentés, mais l’UI est brute ; nous les améliorons
• Widgets publics (<script src="api.astroway.info/widget/natal.js">) - phase 7
• Plugin pour le site marketing principal : projet séparé, prévu dans le cadre de l’écosystème astroway.info

1. Lis la documentation si tu veux comprendre le ” pourquoi ” : api.astroway.info/overview
2. Démarrage rapide en 5 minutes avec code : Guide de démarrage rapide de l’API d’astrologie
3. Tarifs, y compris le tableau des crédits par endpoint : api.astroway.info/pricing
4. Inscris-toi : gratuitement, sans carte : api.astroway.info/dashboard/sign-up

Si tu construis quelque chose avec l’API - ou si tu trouves un bug, ou si tu souhaites un endpoint que nous n’avons pas encore - écris-nous. Nous préférerions entendre cent développeurs qui demandent quelque chose plutôt que de lancer des fonctionnalités que personne n’utilise.

Questions, demandes, cas limites étranges : hello@astroway.info.

Roadmap public - PRODUCT-PLAN.md - ce qui a été fait, ce qui vient ensuite, ce qui a été reporté et pourquoi.

Bienvenue.