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

Heute stellen wir die AstroWay API vor — einen berechnenden Backend-Service für Entwickler, die astrologische Anwendungen, Horoskop-Produkte, Kompatibilitätsfunktionen für Dating und KI-Agenten erstellen, die über Geburtskarten nachdenken.

In diesem Artikel erfahren Sie, was sich wirklich innerhalb der API befindet, welche ungewöhnlichen Entscheidungen wir getroffen haben, was wir bewusst ausgelassen haben und wie wir hierher gekommen sind. Ohne Umschweife.

🕓 Eintrag vom 2026-04-22, aktualisiert am 2026-05-09. Einige Zahlen sind veraltet. Der aktuelle Stand: 723 Endpunkte (und nicht 87 zum Zeitpunkt des Launchs), 818 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 finden Sie unter /faq und changelog.

Eine REST-API auf Basis von Swiss Ephemeris (LGPL), die in WASM kompiliert und als Node.js-Service bereitgestellt wird — jetzt auch mit KI-Interpretationen (Failover-Kette GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) über echten Berechnungen. Der gleiche Motor, den professionelle Astrologen seit 30+ Jahren in Solar Fire, Kepler, Astro Gold und Janus verwenden — Genauigkeit bis zur Bruchteil einer Winkelsekunde, abgestimmt mit der NASA-JPL-Ephemeride und dem offiziellen swetest-Referenz von Astrodienst (Astro.com).

Zahlen:

• 723 Endpunkte — westliche Geburtsastrologie, Synastrie, Transite, Progressionen, Direktionen, Rückkehr, Harmoniken, Fixsterne, arabische Punkte, Astro-Kartografie plus ein vollständiger Satz von Human Design
• 183 Snapshot-Tests in CI gegen den echten Ausgang von swetest CGI und dem NASA-Katalog der Finsternisse — laufen bei jedem PR
• p50 < 100 ms, p95 < 500 ms für typische berechnende 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 — liefert die API als Tools für Claude, GPT, Cursor und andere LLM-Agenten
• Credit-basierte Tarife: kostenloses Plan (10 000 Credits / Monat, ohne Karte), kostenpflichtige — ab 5 $ / Monat

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

Vor drei Jahren begannen wir, Verbraucher-Astrologie-Anwendungen zu bauen. Die berechnende Schicht erwies sich als der schwierigste Teil — viel schwieriger als die Benutzeroberfläche oder den Inhalt. Bestehende Dienste hatten entweder:

1. Eine oberflächliche Abdeckung (10–30 Endpunkte, meist nur Geburts-)
2. Waren teuer im Maßstab ($0,02–$0,10 pro Anfrage ohne Rabatte)
3. Verwendeten geschlossene Motoren, deren Genauigkeit nicht überprüft werden kann
4. Konzentrierten sich auf vedische Astrologie und boten westliche als zweitrangig an

Wir haben also die Swiss Ephemeris selbst vertrieben und unsere eigene berechnende Schicht geschrieben — zunächst für das Verbraucherprodukt app.astroway.info, dann für den Marketing-Website astroway.info, der täglich Horoskope für hunderttausende Besucher im Monat bereitstellt.

Nach drei Jahren Arbeit an diesem Code in der Produktion kamen wir zu zwei Schlussfolgerungen:

1. Der gleiche berechnende Motor sollte anderen Entwicklern zur Verfügung stehen — nicht weil sie ihn nicht selbst schreiben könnten, sondern weil der Stapel Bibliothek + WASM + Caching + CI auf Genauigkeit — das ist ein halbes Jahr Arbeit, die niemand wiederholen sollte.
2. Unsere Abdeckung von Human Design (12 Endpunkte — Karte, Typ, Autorität, Profil, Tore, Kanäle, Konturen, planetarische Aktivierungen, Inkarnationskreuz, Definition) — ist wirklich einzigartig. Kein Wettbewerber bietet einen vollständigen HD-Stapel über die API an.

Das ist der Launch.

Wir haben /nakshatras, /ashtakavarga und Endpunkte für divisionale Karten, aber keine Dasha, Panchang, Ashtakoota, KP. Der Grund: In der vedischen Astrologie gibt es ungelöste Meinungsverschiedenheiten zwischen den Schulen (Kriege der Ayanamsha, Streitigkeiten über die KP-Kuspiden, Auswahl der Dasha-Schule). Eine hastig gemachte vedische Komponente gegen Prokerala und VedicAstroAPI würde einfach Kritik erhalten.

Die Lösung ist festgelegt: Der vedische Paket ist eine separate Phase 3, nachdem der erste Nachweis des Bedarfs an westlicher und Zeit zur Validierung gegen Jagannatha Hora und Parashara’s Light besteht. Es ist besser, nicht zu starten, als schlecht zu starten.

Ein Aufruf von /chart kostet etwa 50-mal weniger Berechnungen als ein 365-Tage-/forecast-calendar. Ein flacher Preis pro Anfrage oder würde leichte Benutzer abschneiden oder schwere Benutzer subventionieren. Credits kartieren die Kosten auf die tatsächliche Arbeit — siehe Tabelle nach Endpunkten auf Preisseite.

Antworten auf dem kostenlosen Plan enthalten ein Feld _footer:

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

Das kostet uns nichts, aber gibt kostenlosen Benutzern einen kleinen Anreiz, sich zu aktualisieren. Auf dem Plan Hobby+ kann es in den Einstellungen des Schlüssels entfernt werden. Das Muster haben wir von Zapier und RevenueCat ausgeliehen.

/rectification (Auswahl der Geburtszeit nach Lebensereignissen durch likelihood-grid-Suche) — ist rechenintensiv: Ein Aufruf dauert 10–60 Sekunden und führt Tausende von Zwischenberechnungen der Swiss Ephemeris durch. Wir haben es auf den Plan Pro ($59 / Monat) beschränkt und einen hohen Credit-Preis festgelegt, weil Missbrauch die gemeinsame Infrastruktur für alle anderen beeinträchtigen würde.

Endpunkte /interpret/* werden über unser privates KI-Gateway geroutet, das auf Best-of-Breed-Modellen des Marktes (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) mit automatischem Failover basiert. Wir sperren dich nicht in unsere eigenen Prompts ein — jede Antwort mit Interpretation enthält die ursprünglichen Berechnungen, damit du sie mit deiner eigenen LLM neu fragen kannst, wenn unsere Stimme dir nicht gefällt. Vollständige Prompts und Ausgaben loggen wir in die Audit-Tabelle für B2B-Compliance (90-Tage-Aufbewahrung).

• Vedischer Paket — Phase 3, nachdem der erste Nachweis des Bedarfs an westlicher und Zeit zur Validierung gegen Jagannatha Hora und Parashara’s Light besteht (siehe oben)
• Webhook für Schwellenwerte — implementiert, aber die Benutzeroberfläche ist roh; wird nachgebessert
• Öffentliche Widgets (<script src="api.astroway.info/widget/natal.js">) — Phase 7
• Plugin für die Haupt-Marketing-Website — separates Projekt, geplant im Rahmen der AstroWay.info-Ökosystem

1. Lese die Dokumentation, wenn du verstehen möchtest, «warum»: api.astroway.info/overview
2. Schnellstart in 5 Minuten mit Code: Astrology API Quick Start
3. Tarife, einschließlich Tabelle mit Credits pro Endpunkt: api.astroway.info/pricing
4. Registriere dich — kostenlos, ohne Karte: api.astroway.info/dashboard/sign-up

Wenn du etwas auf der API baust — oder einen Bug findest oder einen Endpunkt vermisst, den wir noch nicht haben — schreibe uns. Es ist uns lieber, hundert Entwickler zu hören, die etwas verlangen, als Funktionen zu starten, die niemand verwendet.

Fragen, Anfragen, seltsame Edge-Fälle: hello@astroway.info.

Der Roadmap ist öffentlich — PRODUCT-PLAN.md — was gemacht wurde, was als nächstes kommt, was verschoben wurde und warum.

Willkommen.