Swiss Ephemeris API

Swiss Ephemeris – de facto standard astronomických výpočtů v astrologii: stojí na něm Astrodienst (astro.com), Solar Fire, Kerykeion a většina seriózního softwaru. Čte efemeridy DE431 od NASA JPL a poskytuje subsekundovou přesnost. AstroWay API k němu poskytuje přímý HTTP přístup – bez kompilace C-knihovny, bez stahování souborů .se1, bez správy paměti. Jeden POST požadavek, JSON v odpovědi.

Proč Swiss Ephemeris přes API

Self-host Swiss Ephemeris znamená: sestavit C-knihovnu (nebo WASM-build), umístit několik stovek megabajtů souborů .se1, udržovat je aktuální a sám implementovat hroty domů, aspekty, fáze. Přes API je to všechno cizí starost:

• Nulová infrastruktura: žádné binární soubory, efemeridové soubory ani zpoždění cold-startu. Výpočet se provádí server-side na stejném enginu jako Astrodienst.
• Subsekundová přesnost: < 0.1″ proti referenčnímu swetest CGI od Astrodienst, ověřeno na 873 zmrazených snapshot-testech při každém deployi.
• Plný rozsah dat: DE431 pokrývá 13201 BCE – 17191 CE, takže historické a vzdálené budoucí mapy se počítají bez ztráty přesnosti.
• Nejen pozice: nad efemeridami jsou ihned dostupné hroty domů (15 systémů), aspekty, zatmění, tranzity, progrese – to, co bys při self-hostu musel psát sám.

Tip

Přesnost enginu je triangulována proti třem nezávislým zdrojům (swetest CGI, Kerykeion, Prokerala) + proti NASA 5-Millennium Eclipse Catalog. Detaily a čísla – na stránce Přesnost výpočtů.

Co se počítá na Swiss Ephemeris

Endpoint	Kredity	Co vrací
/v1/chart	20	Kompletní mapa: planety + domy + aspekty
/v1/planets	10	Geocentrické pozice planet (délka, šířka, rychlost, retrogradita)
/v1/houses	10	Hroty domů – 15 systémů (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Tranzity k natální mapě pro zadané datum
/v1/progressions	50	Sekundární progrese (den = rok)
/v1/eclipses	100	Sluneční a měsíční zatmění (verified vs NASA Catalog)
/v1/moon-phase	10	Fáze Měsíce, osvětlení, následující kvadranty
/v1/fixed-stars	20	Konjunkce planet s nehybnými hvězdami

To je část 760 endpointů platformy – kompletní seznam v API-referenci.

Příklad

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

Kdo používá

• Vývojáři astroaplikací: subsekundové pozice bez self-host C-knihovny
• AI-agenti: přesné efemeridy jako grounding pro LLM (přes MCP-server)
• Výzkumníci: hromadné výpočty v historickém rozsahu DE431
• Migrace ze self-hostu: nahrazení lokálního swisseph HTTP bez ztráty přesnosti

Cena

Pozice planet (/v1/planets) – 10 kreditů, kompletní mapa (/v1/chart) – 20. Na Free tarifu (760+ endpointů, 10 000 kreditů/měsíc) – přibližně 1000 dotazů na planety měsíčně zdarma, bez karty.

Přesnost výpočtů → Triangulace, NASA-validace, snapshot-testy

Rychlý start První požadavek za 5 minut

Tarify Od bezplatného po Enterprise