Swiss Ephemeris API

A Swiss Ephemeris a de facto szabvány az asztrológiai számításokhoz: erre épül az Astrodienst (astro.com), a Solar Fire, a Kerykeion és a legtöbb komoly szoftver. A NASA JPL DE431 efemeridákat olvassa, és szubszekundumos pontosságot biztosít. Az AstroWay API közvetlen HTTP-hozzáférést biztosít hozzá – C-könyvtár fordítása, .se1 fájlok letöltése és memóriakezelés nélkül. Egy POST kérés, JSON válasz.

Miért a Swiss Ephemeris API-n keresztül?

A Swiss Ephemeris self-hostolása azt jelenti: C-könyvtár (vagy WASM-build) fordítása, több száz megabájt .se1 fájl tárolása, naprakészen tartása, és a házcsúcsok, aspektusok, fázisok saját implementálása. Az API-n keresztül mindez más gondja:

• Nulla infrastruktúra: Nincsenek binárisok, efemerida fájlok vagy cold-start késleltetések. A számítás szerveroldalon történik, ugyanazon a motoron, mint az Astrodienst.
• Szubszekundumos pontosság: < 0.1″ az Astrodienst referencia swetest CGI-jéhez képest, 873 rögzített snapshot teszttel ellenőrizve minden telepítéskor.
• Teljes dátumtartomány: A DE431 i.e. 13201 – i.sz. 17191 közötti időszakot fedi le, így a történelmi és távoli jövőbeli térképek pontosságvesztés nélkül számíthatók.
• Nem csak pozíciók: Az efemeridák mellett azonnal elérhetők a házcsúcsok (15 rendszer), aspektusok, fogyatkozások, tranzitok, progressziók – mindaz, amit self-host esetén magadnak kellene megírnod.

Tipp

A motor pontosságát három független forrással (swetest CGI, Kerykeion, Prokerala) + a NASA 5-Millennium Eclipse Catalog-gal trianguláltuk. Részletek és számok a Számítási pontosság oldalon.

Mit számol a Swiss Ephemeris

Endpoint	Kreditek	Mit ad vissza
/v1/chart	20	Teljes térkép: bolygók + házak + aspektusok
/v1/planets	10	Geocentrikus bolygópozíciók (hosszúság, szélesség, sebesség, retrográd mozgás)
/v1/houses	10	Házcsúcsok - 15 rendszer (Placidus, Koch, Whole Sign, Equal…)
/v1/transits	50	Tranzitok a születési képlethez egy adott dátumra
/v1/progressions	50	Szekunder progressziók (nap = év)
/v1/eclipses	100	Nap- és holdfogyatkozások (ellenőrizve a NASA katalógussal)
/v1/moon-phase	10	Holdfázis, megvilágítás, következő negyedek
/v1/fixed-stars	20	Bolygókonjunkciók fix csillagokkal

Ez a platform 760 endpointjainak egy része – a teljes lista az API-referenciában található.

Példa

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

Kik használják

• Asztrológiai alkalmazásfejlesztők: szubszekundumos pozíciók self-host C-könyvtár nélkül
• AI-ügynökök: pontos efemeridák mint alap (grounding) az LLM-ek számára (MCP-szerveren keresztül)
• Kutatók: tömeges számítások a DE431 történelmi tartományában
• Migráció self-hostról: a lokális swisseph HTTP-re cserélése pontosságvesztés nélkül

Költségek

A bolygópozíciók (/v1/planets) – 10 kredit, a teljes térkép (/v1/chart) – 20. Az Ingyenes csomagban (760+ endpoint, 10 000 kredit/hó) – körülbelül 1000 bolygó lekérdezés havonta ingyenesen, kártya nélkül.

Számítási pontosság → Trianguláció, NASA-validáció, snapshot-tesztek

Gyorsindítás Első kérés 5 perc alatt

Árak Ingyenestől az Enterprise-ig