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 — un backend de calcul pour les développeurs qui créent des applications d’astrologie, des produits de horoscope, des fonctions de compatibilité pour le dating et des agents IA qui ont besoin de raisonner sur les cartes de naissance.

Dans cet article — ce qui se trouve réellement à l’intérieur de l’API, quelles solutions inhabituelles nous avons adoptées, ce que nous avons sciemment laissé de côté et comment nous sommes arrivés là. Sans eau.

🕓 Note du 2026-04-22, mise à jour le 2026-05-09. Certains chiffres sont obsolètes. État actuel : 723 points de terminaison (et non 87 au moment du lancement), 818 tests d’instantanés CI (et non 183), le serveur MCP @astroway/mcp + le SDK TypeScript @astroway/sdk + le SDK Python astroway + le SDK PHP astroway/sdk sont maintenant tous hébergés sur des registres publics. Le statut actuel se trouve sur /faq et changelog.

API REST basée sur Swiss Ephemeris (LGPL), compilée en WASM et déployée comme service Node.js — maintenant également avec des interprétations IA (chaîne de secours GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) sur des calculs réels. Le même moteur que les astrologues professionnels utilisent depuis plus de 30 ans dans Solar Fire, Kepler, Astro Gold et Janus — une précision jusqu’à la fraction de seconde d’arc, vérifiée avec l’éphéméride NASA JPL et la référence swetest officielle d’Astrodienst (Astro.com).

Chiffres :

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

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

Il y a trois ans, nous avons commencé à construire des applications d’astrologie pour les consommateurs. La couche de calcul s’est avérée être la partie la plus complexe — beaucoup plus complexe que l’interface utilisateur ou le contenu. Les services existants soit :

1. Avaient une couverture superficielle (10-30 points de terminaison, principalement seulement natale)
2. Étaient coûteux à l’échelle ($0,02-$0,10 par demande sans réduction en volume)
3. Utilisaient des moteurs fermés, dont la précision ne peut pas être vérifiée
4. Se concentraient sur l’astrologie védique, tandis que l’astrologie occidentale était présentée comme secondaire

Nous avons donc internalisé Swiss Ephemeris nous-mêmes et écrit notre propre couche de calcul — d’abord pour notre produit consommateur app.astroway.info, puis pour notre site marketing astroway.info, qui fournit des horoscopes quotidiens à des centaines de milliers de visiteurs par mois.

Au cours des trois années de fonctionnement de ce code en production, nous sommes arrivés à deux conclusions :

1. Le même moteur de calcul doit être accessible à d’autres développeurs — non pas parce qu’ils ne peuvent pas l’écrire eux-mêmes, mais parce que le stack bibliothèque + WASM + mise en cache + CI sur la précision — c’est six mois de travail, que personne ne devrait répéter.
2. Notre couverture de Human Design (12 points de terminaison — carte, type, autorité, profil, portes, canaux, contours, activations planétaires, incarnation cross, définition) — est vraiment unique. Aucun concurrent ne propose un ensemble complet de HD via l’API.

Voilà le lancement.

Nous avons /nakshatras, /ashtakavarga et des points de terminaison pour les cartes divisionnelles, mais pas de Dasha, Panchang, Ashtakoota, KP. La raison : dans l’astrologie védique, il y a des désaccords non résolus entre les écoles (guerres d’ayanamsha, controverses sur les cusps KP, choix de l’école de dasha). Une partie védique faite à la hâte contre Prokerala et VedicAstroAPI serait simplement critiquée.

La décision est prise : le paquet védique est une phase 3, après les premières confirmations de la demande (voir ci-dessus)

Un appel /chart coûte environ 50 fois moins de calculs qu’un /forecast-calendar de 365 jours. Un prix plat par demande ou aurait découragé les utilisateurs légers, ou subventionné les utilisateurs lourds. Les crédits cartographient le coût au travail réel — voir le tableau par point de terminaison sur la page des tarifs.

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

{
  "data": { ... },
  "_footer": "Propulsé par astroway.api — obtenez votre propre clé sur api.astroway.info"
}

Cela ne nous coûte rien, et donne aux utilisateurs gratuits une petite incitation à passer à l’étape suivante. Sur le plan Hobby+, cela disparaît dans les paramètres de la clé. Le modèle a été emprunté à Zapier et RevenueCat.

/rectification (sélection de l’heure de naissance par événements de vie via une recherche de grille de probabilité) — est coûteux en termes de 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 avons fixé un grand prix de crédit, car les abus auraient mis en danger l’infrastructure partagée pour tous les autres.

Les points de terminaison /interpret/* sont routés via notre passerelle IA privée, qui utilise les meilleurs modèles du marché (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) avec un failover automatique. Nous ne vous verrouillons pas dans nos invites — chaque réponse avec interprétation contient les calculs d’origine, vous pouvez donc les réinterpréter avec votre propre LLM si notre voix ne vous convient pas. Les invites et les sorties complètes sont enregistrées dans une table d’audit pour la conformité B2B (stockage de 90 jours).

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

1. Lisez la documentation si vous voulez comprendre « pourquoi » : api.astroway.info/overview
2. Démarrage rapide en 5 minutes avec du code : Astrology API Quick Start
3. Tarifs, y compris le tableau des crédits par point de terminaison : api.astroway.info/pricing
4. Inscrivez-vous — gratuitement, sans carte : api.astroway.info/dashboard/sign-up

Si vous construisez quelque chose sur l’API — ou si vous rencontrez un bogue, ou si vous voulez un point de terminaison qui n’existe pas encore — écrivez-nous. Nous préférons entendre cent développeurs qui demandent quelque chose plutôt que de lancer des fonctionnalités qui ne seront pas utilisées.

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

La feuille de route est publique — PRODUCT-PLAN.md — ce qui est fait, ce qui suit, ce qui est reporté et pourquoi.

Bienvenue.