Swiss Ephemeris API

Swiss Ephemeris - de facto standaard voor astronomische berekeningen in de astrologie: erop vertrouwen Astrodienst (astro.com), Solar Fire, Kerykeion en de meeste serieuze software. Het leest de efemeriden DE431 van NASA JPL en levert subsecond nauwkeurigheid. AstroWay API biedt directe HTTP-toegang tot het - zonder C-bibliotheek te compileren, zonder .se1 bestanden te downloaden, zonder geheugenbeheer. Eén POST-verzoek, JSON als antwoord.

Waarom Swiss Ephemeris via API

Self-host Swiss Ephemeris betekent: een C-bibliotheek (of een WASM-build) samenstellen, enkele honderden megabytes aan .se1 bestanden hosten, ze up-to-date houden en zelf de huizencusp, aspecten, fasen implementeren. Via de API is dit allemaal - andermans gedoe:

• Nul infrastructuur: geen binaries, efemeridebestanden of cold-start vertragingen. De berekening wordt server-side uitgevoerd op dezelfde engine als Astrodienst.
• Subsecond nauwkeurigheid: < 0.1″ tegen de referentie swetest CGI van Astrodienst, geverifieerd op 873 bevroren snapshot-tests bij elke deployment.
• Volledig datumbereik: DE431 dekt 13201 BCE – 17191 CE, dus historische en verre toekomstige kaarten worden berekend zonder verlies van nauwkeurigheid.
• Niet alleen posities: bovenop de efemeriden direct beschikbaar huizencusp (15 systemen), aspecten, eclipsen, transits, progressies - wat je bij self-host zelf zou moeten schrijven.

Tip

De nauwkeurigheid van de engine is getrianguleerd tegen drie onafhankelijke bronnen (swetest CGI, Kerykeion, Prokerala) + tegen NASA 5-Millennium Eclipse Catalog. Details en cijfers - op de pagina Nauwkeurigheid van berekeningen.

Wat wordt berekend met Swiss Ephemeris

Endpoint	Credits	Wat retourneert
/v1/chart	20	Volledige kaart: planeten + huizen + aspecten
/v1/planets	10	Geocentrische posities van planeten (longitude, latitude, snelheid, retrograditeit)
/v1/houses	10	Huizencusps - 15 systemen (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Transits naar de geboortehoroscoop op een opgegeven datum
/v1/progressions	50	Secundaire progressies (dag = jaar)
/v1/eclipses	100	Zonne- en maaneclips (verified vs NASA Catalog)
/v1/moon-phase	10	Maanfase, belichting, komende kwartielen
/v1/fixed-stars	20	Conjuncties van planeten met vaste sterren

Dit is een deel van 760 endpoints van het platform - de volledige lijst vind je in de API-gids.

Voorbeeld

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

Wie gebruikt het

• Ontwikkelaars van astro‑applicaties: subsecond posities zonder self-host C‑bibliotheek
• AI‑agenten: nauwkeurige efemeriden als grounding voor LLM (via MCP‑server)
• Onderzoekers: massale berekeningen over het historische bereik DE431
• Migratie van self-host: vervanging van lokale swisseph door HTTP zonder verlies van nauwkeurigheid

Kosten

Planeetposities (/v1/planets) - 10 credits, volledige kaart (/v1/chart) - 20. Op het Free‑tarief (760+ endpoints, 10 000 credits/maand) - ongeveer 1000 planeetverzoeken per maand gratis, zonder kaart.

Nauwkeurigheid van berekeningen → Triangulatie, NASA‑validatie, snapshot‑tests

Snelle start Eerste verzoek binnen 5 minuten

Tarieven Van gratis tot Enterprise