Swiss Ephemeris API

Swiss Ephemeris - il de-facto standard per i calcoli astronomici nell’astrologia: su di esso si basano Astrodienst (astro.com), Solar Fire, Kerykeion e la maggior parte del software serio. Legge gli ephemeridi DE431 di NASA JPL e fornisce una precisione di un secondo. L’API AstroWay fornisce un accesso diretto ad esso - senza compilazione della libreria C, senza caricamento dei file .se1, senza gestione della memoria. Un solo richiesta POST, risposta in JSON.

Perché Swiss Ephemeris attraverso l’API

Self-host Swiss Ephemeris significa: raccogliere la libreria C (o la build WASM), posizionare i file .se1 di alcune centinaia di megabyte, mantenere i file aggiornati e implementare i calcoli dei kušpidi dei palazzi, degli aspetti, delle fasi. Attraverso l’API tutto ciò è un problema estraneo:

• Zero infrastruttura: nessun binario, file ephemeridi o ritardi di avvio freddo. Il calcolo viene eseguito server-side sullo stesso motore che Astrodienst.
• Precisione di un secondo: < 0.1″ contro l’etalon swetest CGI di Astrodienst, verificato su 873 snapshot-test su ogni deploy.
• Intero intervallo di date: DE431 copre 13201 BCE – 17191 CE, quindi le carte storiche e future sono calcolate senza perdita di precisione.
• Non solo posizioni: in più, gli ephemeridi offrono immediatamente kušpidi dei palazzi (15 sistemi), aspetti, eclissi, transiti, progressioni - ciò che a self-host si sarebbe dovuto scrivere da sé.

Consiglio

La precisione del motore è triangolata contro tre fonti indipendenti (swetest CGI, Kerykeion, Prokerala) + contro il NASA 5-Millennium Eclipse Catalog. Dettagli e cifre - sulla pagina Precisione dei calcoli.

Cosa viene calcolato su Swiss Ephemeris

Endpoint	Crediti	Cosa restituisce
/v1/chart	20	Carta completa: pianeti + palazzi + aspetti
/v1/planets	10	Posizioni geocentriche dei pianeti (lunghezza, latitudine, velocità, retrogrado)
/v1/houses	10	Kušpidi dei palazzi - 15 sistemi (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Trasiti sulla carta attuale per una data specifica
/v1/progressions	50	Progressioni secondarie (giorno = anno)
/v1/eclipses	100	Eclissi solari e lunari (verificato contro il catalogo di NASA)
/v1/moon-phase	10	Fase della luna, illuminazione, prossimi quarti
/v1/fixed-stars	20	Congiunzioni dei pianeti con stelle fisse

È una parte dei 760 endpoint della piattaforma - il catalogo completo in API Guide.

Esempio

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']}")

Chi utilizza

• Sviluppatori di applicazioni astrologiche: posizioni con precisione di un secondo senza self-host della libreria C
• Agenti AI: ephemeridi precise come grounding per LLM (attraverso il server MCP)
• Ricercatori: calcoli di massa su un intervallo storico di DE431
• Migrazione da self-host: sostituzione del self-host swisseph con un accesso HTTP senza perdita di precisione

Costo

Posizioni dei pianeti (/v1/planets) - 10 crediti, carta completa (/v1/chart) - 20. Sul piano tariffario (760+ endpoint, 10 000 crediti/mese) - circa 1000 richieste dei pianeti al mese gratuitamente, senza carta.

Precisione dei calcoli → Triangolazione, validazione di NASA, snapshot-test

Avvio rapido Primo richiesta in 5 minuti

Tariffe Da gratuito a Enterprise