# Überblick

**AstroWay API** — ein professioneller Backend-Service für astrologische Berechnungen als Dienst.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} Endpunkte basierend auf Swiss Ephemeris (WASM) mit Abdeckung von Techniken, die kein Konkurrent bietet: Harmonische Karten, Drachenpunkte, CCG, Gauquelin-Sektoren, vollständiges Human Design und Rektifikation.

## Für wen ist das gedacht?

1. **Entwickler:innen astrologischer Anwendungen** (Web, Mobile), die präzise und vielfältige Berechnungen benötigen, ohne eigene Recheninfrastruktur.
2. **KI-Unternehmen**, die astrologische Funktionen integrieren — es gibt einen nativen MCP-Server für Claude, ChatGPT und andere Agenten.
3. **Professionelle Astrolog:innen**, die eigene Tools oder Skripte für Kund:innen erstellen.
4. **Forschende**, die programmatischen Zugriff auf Berechnungen für statistische Analysen benötigen.
5. **Content-Plattformen**, die astrologische Features zu bestehenden Produkten hinzufügen.

## Für wen ist das **nicht** gedacht?

- Horoskop-Widgets wie „Heute Krebs“ ohne Kontrolle — AI-Interpretationen und Horoskope sind vorhanden (`/interpret/*`, `/horoscope/*`), aber als API für Entwickler:innen konzipiert, nicht als fertige Widgets.
- Vedische Astrologie als Hauptspezialisierung — für Vedic-first-Projekte (Dasha-Systeme, Panchang, KP) sind Prokerala und VedicAstroAPI stärker. Für westliche Astrologie + Human Design + seltene Techniken (Rektifikation, Harmonische, CCG) ist AstroWay überlegen. Sieh dir /compare/ an.
- Tarot/Nummologie — nur Astrologie und Human Design. I Ging ist als Bonus-Endpunkt verfügbar.

## Was macht AstroWay einzigartig?

### 1. Seltene Techniken im API-Format

| Technik | Wofür? |
|---|---|
| **Harmonische Karten** (H2–H180) | Forschungsastrologie (Methode von John Addey) |
| **Drachenpunkt** | Karma-/Seelenastrologie |
| **CCG (Cyclo-Carto-Graphy)** | Progressierte Astrokartographie — Premium-Technik von Jim Lewis |
| **Gauquelin-Sektoren** | Statistische Astrologie, akademische Nutzung |
| **Tertiäre Progressions** | Dritte Progressionsart — Nischentechnik, aber hochgeschätzt |
| **Antizien / Kontra-Antizien** | Klassische hellenistische Technik — Wiederbelebung traditioneller Schulen |
| **Parallele Aspekte** | Aspekte nach Deklination — fortgeschrittene Praktiken |
| **Rektifikation über API** | Korrektur der Geburtszeit — extrem wertvoll |
| **Planetare Zyklen** (Konjunktionen) | Mundanastrologie — weltweite Ereignisse |
| **Zyklischer Index nach Barbault** | Mundanastrologie |
| **Algol-Minimum** | Zeiten fixer Sterne — Electional-Astrologie |
| **Lokale Raumlinien** | Feng-Shui-ähnliche Richtungsastrologie |
| **Dispositions-Ketten** | Steuerungsgraphen — klassische Technik |
| **Almuten Figuris** | Mittelalterliche Technik — Wiederbelebung der Tradition |

### 2. Präzision von Swiss Ephemeris — dieselbe Engine wie in Solar Fire ($495), Kepler ($995), Astro Gold

Dieselbe Swiss Ephemeris (LGPL), die professionelle Astrolog:innen seit über 30 Jahren in Solar Fire, Kepler, Astro Gold und Janus nutzen — nur als WASM-Build und REST-API, ohne Zwischenhändler-Aufschlag. Genauigkeit:

- Planetare Positionen: ±1 Bogensekunde vs. NASA JPL Ephemeris
- Häuserspitzen: ±1 Bogenminute
- Validierung gegen Zet 9, Solar Fire (proprietäre Ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — Abweichungen innerhalb der Methodenfehlergrenze (≤0,1″).

### 3. {siteMeta.endpoints} Endpunkte — tiefe Abdeckung westlicher Techniken

{siteMeta.westernCount} Berechnungs-Endpunkte für westliche Astrologie (4 Schulen: Hellenistisch, moderne psychologische, evolutionäre, Kosmobiologie) + AI-Interpretationen + vollständiges Human Design. Tiefe statt Streuung über Dutzende Richtungen.

## Architektur

```
Deine Anwendung
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Berechnung und Rückgabe von JSON
```

- Berechnungen werden **serverseitig** durchgeführt — keine WASM-Blobs im Frontend deiner Anwendung, keine Lizenzfragen zu Swiss Ephemeris.
- Serverseitiger Zustand wird nicht gespeichert — jede Anfrage ist in sich abgeschlossen. Keine Datenlecks zu Kund:innen.
- API-Schlüssel sind an Tarife, Rate-Limits und tägliche Guthaben gebunden. Monitoring über das Dashboard.

## Weiterführend

- [Schnellstart](/getting-started/) — erste Anfrage in 5 Minuten
- [Authentifizierung](/authentication/) — wie du einen Schlüssel erhältst und speicherst
- [Guthaben & Limits](/rate-limits-credits/) — wie das Billing funktioniert
- [API-Dokumentation](/docs/api/) — alle Endpunkte mit interaktivem Playground