AstroWay/api v2.325.2 · de
alle Systeme in Ordnung

Katalogkarte: So sind die 700+ Endpoints von AstroWay aufgebaut

Die API ist auf über 700 Endpoints in 57 Gruppen gewachsen, vom Geburtshoroskop über BaZi und Geomantie bis zum Rendern von SVG-Horoskopen. Wir zeigen, wie der Katalog in Domänen gegliedert ist, nach welchem einheitlichen Muster alle Aufrufe funktionieren und wie man schnell den passenden Endpoint findet.

Der Katalog von AstroWay umfasst inzwischen 865 Endpoints in 57 Gruppen. In dieser Größenordnung lautet die Hauptfrage eines Integrators nicht “reicht die Abdeckung”, sondern “wie verliere ich nicht den Überblick”. Dieser Artikel ist eine Karte: wie der Katalog in Domänen gegliedert ist und wie du in einer Minute findest, was du brauchst.

Unabhängig von der Domäne hat jeder Rechen-Endpoint dieselbe Form:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Der Body ist JSON mit Geburtsdaten (Datum, Uhrzeit, Koordinaten) oder technikspezifischen Parametern. Die Response ist immer { "ok": true, "data": {...} } oder { "ok": false, "error": {...} }. Kein GraphQL, keine eigenen Auth-Flows pro Domäne: ein Schlüssel im Header X-Api-Key, ein Response-Format.

Das heißt: Der Wrapper, den du für das Geburtshoroskop schreibst, passt auch für BaZi und für Runen. Es ändern sich nur der Pfad und das Body-Schema.

Der Katalog gliedert sich in große Domänen. Hier ist die Karte mit echten Zählern (die Zahlen stammen bei jedem Build aus dem Manifest und sind hier daher immer aktuell):

DomäneEndpointsWas drin ist
Westliche Astrologie186Geburtshoroskop, Aspekte, Würden, Prognostik (Transite, Progressionen, Direktionen), Horary, 4 hellenistische Schulen, moderne psychologische, evolutionäre Astrologie, Kosmobiologie
Vedisch230Die größte Domäne: Nakshatras, Dashas, Teilungshoroskope (Varga), Yogas, Dosha, Jaimini, KP, Ashtakavarga, Shadbala
Human Design12Bodygraph, Kanäle, Tore, Typ/Profil/Autorität, Inkarnationskreuz
Tarot71Drei Decks: Rider-Waite-Smith, Marseille, Lenormand, mit Legesystemen, Bedeutungen, Kombinationen
Numerologie555 Systeme mit je 10 Berechnungen (pythagoreisch, chaldäisch, zwei kabbalistische, vedisch)
Chinesisch + Maya55BaZi (vier Säulen), Zi Wei Dou Shu, chinesischer Tierkreis und Feng Shui, Maya-Kalender
Divination40Geomantie (Agrippa), Runen des Älteren Futhark, Handlesekunst (Cheiro), I Ching
Angewandte Nischen53Wellness, Tierastrologie, Business, Finanzen, Familie
Berichte29Fertige Deutungen (natal, synastry) in HTML/PDF, mit White-Label-Branding
Rendering14SVG/PNG-Horoskopräder, Bodygraph, Transitringe, ohne eigenes Frontend
Dev-Tools47Webhooks, Echtzeit-Streaming, einbettbare Widgets, White-Label

Der Rest sind KI-Deutungen, Horoskope, Referenz-Endpoints (Zeichen, Planeten, Aspekte) und System-Endpoints (health, usage, openapi).

230 vedische Endpoints sind mehr als der gesamte westliche Teil. Der Grund ist einfach: Die vedische Tradition ist stärker formalisiert. Wo die westliche Astrologie einen Satz Häuser hat, hat die vedische 16 Teilungshoroskope (Varga), mehrere Dasha-Systeme und Dutzende Yogas mit klaren Regeln. Jedes davon ist ein eigener Endpoint mit deterministischem Ergebnis.

Wenn du für den indischen Markt baust, ist das der Kern des Produkts und keine Zugabe.

Egal wie exotisch die Technik ist: Die Planetenpositionen berechnet ein einziger Kern auf Basis von Swiss Ephemeris. Derselbe Kern läuft in unserer App und in der API, eine Codebasis, keinerlei Abweichung. Die Rechen-Endpoints sind durch 888 Snapshot-Tests abgedeckt, die bei jedem PR mit Referenzquellen abgeglichen werden. Mehr dazu in einem eigenen Artikel über die CI-Genauigkeit.

Drei Wege, vom schnellsten an:

  1. OpenAPI-Referenz: /docs/api/ wird direkt aus der Produktionsspezifikation openapi.json generiert. Die Gruppen in der Seitenleiste = die Domänen oben. Jeder Endpoint hat ein Body-Schema, ein Beispiel und einen “Ausprobieren”-Button.
  2. MCP-Katalog: Wenn du in Claude oder Cursor arbeitest, ist der ganze Katalog als Tool-Set über mcp.astroway.info verfügbar. Der Agent findet den passenden Endpoint selbst anhand der Beschreibung.
  3. Suche in der Spezifikation: curl https://api.astroway.info/v1/openapi.json liefert den vollständigen maschinenlesbaren Vertrag. Praktisch für die Codegenerierung eines eigenen Clients.

Ein Schlüssel über dashboard/sign-up bringt 10 000 Credits pro Monat, genug, um Dutzende Domänen durchzugehen und herauszufinden, was davon zu dir passt. Den Katalog musst du nicht komplett durcharbeiten: Nimm deine Domäne, der Rest wartet, bis du ihn brauchst.

MakSeong · AstroWay

Ich entwickle das AstroWay API: packe Astrologie-Mathematik auf die Bogensekunde in reines REST und schreibe über langweilige Details, die eigentlich wichtig sind.

// darauf aufbauen

Positionen auf die Bogensekunde in 4 Zeilen Code.

Kostenloser Schlüssel ohne Kreditkarte. 5.000 Aufrufe pro Monat vor der ersten Zahlung.

Mehr aus dem Blog alle Beiträge →

Engineering 2026-07-15

Drei offizielle SDKs: TypeScript, Python, PHP statt rohem curl

Rohes HTTP funktioniert, aber ein typisierter Client spart Stunden: Autovervollständigung der Pfade, Request- und Response-Typen, eingebauter Retry bei 408/409/429/5xx und eine Fehlerhierarchie im Stainless-Stil. Wir gehen die drei offiziellen SDKs durch, @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist), und zeigen, wie sie aus einem einzigen OpenAPI-Vertrag generiert werden.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.

Engineering 2026-06-05

Horoscope API Tutorial: Build a Daily Horoscope Feature

Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.