Start von AstroWay API: vollständiger Stack für astrologische Berechnungen mit der Genauigkeit von Swiss Ephemeris

Heute kündigen wir AstroWay API – das Berechnungs‑Backend für Entwickler an, die astrologische Anwendungen, Horoskop‑Produkte, Kompatibilitäts‑Funktionen für Dating und KI‑Agenten bauen, die über Geburtshoroskope nachdenken.

In diesem Artikel – was wirklich im API steckt, welche untypischen Entscheidungen wir getroffen haben, was wir bewusst außen vor gelassen haben und wie wir hierher gekommen sind. Ohne Umschweife.

🕓 Eintrag vom 2026-04-22, aktualisiert am 2026-05-09. Einige Zahlen sind veraltet. Aktueller Stand: 865 Endpunkte (und nicht 87 zum Launch), 888 CI‑Snapshot‑Tests (und nicht 183), MCP‑Server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk leben jetzt alle in öffentlichen Registries. Der aktuelle Status ist in /faq und changelog.

REST API basierend auf Swiss Ephemeris – jetzt auch mit KI‑Interpretationen über den echten Berechnungen. Derselbe Motor, den professionelle Astrologen seit über 30 Jahren in Solar Fire, Kepler, Astro Gold und Janus nutzen – Genauigkeit bis auf einen Bruchteil einer Bogensekunde, abgeglichen mit den NASA‑JPL‑Ephemeriden und dem offiziellen swetest‑Reference von Astrodienst (Astro.com).

Zahlen:

• 865 Endpunkt: westliche Geburtstafel‑Astrologie, Synastrie, Transite, Progressionen, Direktionen, Rückläufe, Harmoniken, feste Sterne, arabische Punkte, Astrokartografie plus das komplette Human‑Design‑Set
• 183 Snapshot‑Tests in CI gegen die reale Ausgabe von swetest CGI und dem NASA‑Ekliptik‑Katalog – laufen bei jedem PR
• p50 < 100 ms, p95 < 500 ms für typische Berechnungs‑Endpunkte
• MCP‑Server @astroway/mcp + drei SDKs in öffentlichen Registries: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) – dieselbe API in drei Sprachen
• MCP‑Server: @astroway/mcp – stellt das API als Werkzeuge für Claude, GPT, Cursor und andere LLM‑Agenten bereit
• Credit‑basierte Tarife: kostenloser Plan (10 000 Credits / Monat, ohne Karte), kostenpflichtig – ab $5 / Monat

Vollständige Dokumentation: api.astroway.info/docs/api/. Live‑Status: api.astroway.info/status.

Vor drei Jahren begannen wir, konsumorientierte astrologische Anwendungen zu bauen. Die Berechnungsschicht erwies sich als der schwierigste Teil – deutlich komplexer als UI oder Content. Existierende Dienste entweder:

1. Hatten eine oberflächliche Abdeckung (10–30 Endpunkte, meist nur Natal)
2. Waren im großen Maßstab teuer ($0.02–$0.10 pro Anfrage ohne Mengenrabatte)
3. Verwendeten geschlossene Motoren, deren Genauigkeit nicht überprüfbar ist
4. Fokussierten sich auf vedische Astrologie und stellten die westliche als nachrangig dar

Deshalb haben wir Swiss Ephemeris selbst gevendorisiert und eine eigene Berechnungsschicht geschrieben – zunächst für das Verbraucher‑Produkt app.astroway.info, dann für die Marketing‑Website astroway.info, die täglich Horoskope für hunderttausende Besucher pro Monat ausgibt.

Nach drei Jahren Betrieb dieses Codes in Produktion sind wir zu zwei Erkenntnissen gekommen:

1. Der gleiche Berechnungs‑Motor muss anderen Entwicklern zur Verfügung stehen: nicht weil sie ihn nicht selbst schreiben könnten, sondern weil der Stack Bibliothek + Caching + CI für Genauigkeit ein halbes Jahr Arbeit bedeutet, das niemand wiederholen sollte.
2. Unsere Human‑Design‑Abdeckung (12 Endpunkte: Karte, Typ, Autorität, Profil, Tore, Kanäle, Konturen, planetare Aktivierungen, Incarnation‑Cross, Definition) ist wirklich einzigartig. Kein Konkurrent bietet den kompletten HD‑Stack über ein API.

Das ist der Launch.

Wir haben /nakshatras, /ashtakavarga und Endpunkte für divisional‑Karten, aber keine Dasha, Panchang, Ashtakoota, KP. Grund: In der vedischen Astrologie gibt es ungelöste Differenzen zwischen den Schulen (Kriege um Ayana‑Msh, Streitigkeiten über KP‑Kuspide, Wahl der Dasha‑Schule). Ein hastig gemachter vedischer Teil gegenüber Prokerala und VedicAstroAPI würde einfach Kritik erhalten.

Die Entscheidung ist fest: Das vedische Paket ist Phase 3, nachdem stabile Nachfrage nach dem westlichen Teil besteht und Zeit bleibt, es gegen Jagannatha Hora und Parashara’s Light zu validieren. Besser gar nicht starten, als schlecht zu starten.

Ein Aufruf von /chart kostet etwa 50 mal weniger Rechenleistung als das 365‑tägige /forecast-calendar. Ein fixer Preis pro Anfrage würde entweder leichte Nutzer abschrecken oder schwere subventionieren. Credits bilden die Kosten nach realer Arbeit ab – siehe die Tabelle der Endpunkte auf der Preisseite.

Antworten im kostenlosen Plan enthalten das Feld _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Das kostet uns nichts und gibt kostenlosen Nutzern einen kleinen Anreiz, upzugraden. Im Hobby+‑Plan wird es in den Schlüsseleinstellungen entfernt. Das Muster haben wir von Zapier und RevenueCat übernommen.

/rectification (Bestimmung des Geburtszeitpunkts anhand von Lebensereignissen mittels Likelihood‑Grid‑Suche) – rechenintensiv: ein Aufruf dauert 10–60 Sekunden und führt zehntausende Zwischenschritte mit Swiss Ephemeris aus. Wir haben ihn auf den Pro‑Plan ($59 / Monat) beschränkt und einen hohen Kreditpreis festgelegt, da Missbrauch die gemeinsame Infrastruktur für alle anderen belasten würde.

Die Endpunkte /interpret/* laufen über unser privates AI‑Gateway mit automatischem Failover zwischen mehreren Modellen. Wir sperren dich nicht in unseren Prompts ein – jede Antwort mit Interpretation enthält die zugrundeliegenden Berechnungen, sodass du sie mit deiner eigenen LLM überschreiben kannst, wenn unsere Stimme nicht passt. Vollständige Prompts und Ausgaben protokollieren wir in einer Audit‑Tabelle für B2B‑Compliance (Aufbewahrung 90 Tage).

• Vedisches Paket: Phase 3, nach den ersten Nachfragen (siehe oben)
• Webhooks bei Erreichen von Schwellen: implementiert, aber UI roh; wir arbeiten daran
• Öffentliche Widgets (<script src="api.astroway.info/widget/natal.js">) – Phase 7
• Plugin für die Haupt‑Marketing‑Website: separates Projekt, geplant im Rahmen des astroway.info‑Ökosystems

1. Lies die Dokumentation, wenn du verstehen willst, “warum”: api.astroway.info/overview
2. Schnellstart in 5 Minuten mit Code: Astrology API Quick Start
3. Tarife, inklusive der Credit‑Tabelle pro Endpunkt: api.astroway.info/pricing
4. Melde dich an: kostenlos, ohne Karte: api.astroway.info/dashboard/sign-up

Wenn du etwas auf dem API baust – sei es ein Bug, den du findest, oder ein Endpunkt, den wir noch nicht haben – schreib uns. Wir hören lieber hundert Entwickler, die etwas anfordern, als Features zu starten, die niemand nutzt.

Fragen, Anfragen, seltsame Edge‑Cases: hello@astroway.info.

Die Roadmap ist öffentlich – PRODUCT-PLAN.md – was erledigt ist, was als Nächstes kommt, was zurückgestellt wurde und warum.

Willkommen.