API de l'Ephéméride Suisse

Suisse Ephéméride - le standard de facto des calculs astronomiques en astrologie : c’est sur elle que sont basés Astrodienst (astro.com), Solar Fire, Kerykeion et la plupart du logiciel sérieux. Elle lit les éphémérides DE431 de la NASA JPL et fournit une précision sous-seconde. L’API AstroWay donne un accès direct HTTP à cela - sans compilation de bibliothèque C, sans téléchargement de fichiers .se1, sans gestion de la mémoire. Un seul appel POST, JSON en réponse.

Pourquoi la Suisse Ephéméride via l’API

Héberger la Suisse Ephéméride signifie : rassembler la bibliothèque C (ou la version WASM), placer plusieurs centaines de mégaoctets de fichiers .se1, les tenir à jour et réaliser les calculs de maison, les aspects, les phases. Via l’API, tout cela est un embarras :

• Aucune infrastructure : pas de fichiers binaires, de fichiers éphémérides ou de retards de démarrage froids. Le calcul est effectué côté serveur sur le même moteur que Astrodienst.
• Précision sous-seconde : < 0.1″ contre l’échantillon établi swetest CGI d’Astrodienst, vérifié sur 873 snapshot-tests congelés à chaque déploiement.
• Tout le domaine temporel : DE431 couvre 13201 BCE – 17191 CE, donc les cartes historiques et futures lointaines sont prises en compte sans perte de précision.
• Pas seulement les positions : en plus des éphémérides, les calculs de maison (15 systèmes), les aspects, les éclipses, les transits, les progressions sont immédiatement disponibles.

Astuce

La précision du moteur est tridimensionnelle contre trois sources indépendantes (swetest CGI, Kerykeion, Prokerala) + contre le Catalogue d’éclipses de la NASA 5-Millennium. Les détails et les chiffres - sur la page Précision des calculs.

Qu’est-ce que la Suisse Ephéméride calcule

Fin de l’API	Crédits	Ce qu’elle retourne
/v1/chart	20	Carte complète : planètes + maisons + aspects
/v1/planets	10	Positions géocentriques des planètes (longitude, latitude, vitesse, rétrogradation)
/v1/houses	10	Calculs de maison - 15 systèmes (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Transits sur la carte natale pour une date donnée
/v1/progressions	50	Progressions secondaires (jour = année)
/v1/eclipses	100	Éclipses solaires et lunaires (vérifiées contre le Catalogue de la NASA)
/v1/moon-phase	10	Phase de la Lune, éclairage, prochaines quartiles
/v1/fixed-stars	20	Conjonctions des planètes avec les étoiles fixes

C’est une partie des 760 fin de l’API de la plateforme - le liste complète dans le Guide de l’API.

Exemple

cURL

curl -X POST https://api.astroway.info/v1/planets \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/planets', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});
const { data } = await r.json();
const sun = data.planets.find((p) => p.name === 'Sun');
console.log(`Sun: ${sun.longitude.toFixed(4)}° retrograde: ${sun.isRetrograde}`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/planets',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
data = r.json()['data']
sun = next(p for p in data['planets'] if p['name'] == 'Sun')
print(f"Sun: {sun['longitude']:.4f}° retrograde: {sun['isRetrograde']}")

Qui utilise

• Développeurs d’astro-applications : positions sous-seconde sans bibliothèque C self-host
• Agents LLM : éphémérides précises comme fondement pour les LLM (via le serveur MCP)
• Rechercheurs : calculs massifs sur le domaine temporel historique DE431
• Migration vers self-host : remplacement de l’hébergement local swisseph par HTTP sans perte de précision

Coût

Positions des planètes (/v1/planets) - 10 crédits, carte complète (/v1/chart) - 20. Sur le tarif gratuit (760+ fin de l’API, 10 000 crédits/mois) - environ 1000 appels planètes par mois sans frais, sans carte.

Précision des calculs → Tridimensionnelle, NASA-vérification, snapshot-tests

Début rapide Premier appel en 5 minutes

Tarifs De gratuit à Enterprise