Vedische Astrologie per API: von Parashara bis Lal Kitab in 354 Endpunkten

Die vedische Astrologie ist die älteste ununterbrochene astrologische Tradition der Welt. Ihre formalen Methoden (BPHS, Jaimini-Sutras, Lal Kitab, KP) werden in Indien täglich eingesetzt: von Heiratsvermittlern, bei der Wahl von Terminen, zur vorausschauenden Deutung des Schicksals. Aber programmatisch an hochwertige Berechnungen zu kommen war bis vor Kurzem mühsam.

AstroWay v2.19 ändert das: 354+ vedische Endpunkte, gegengeprüft gegen PyJHora (die Referenzimplementierung in Python), mit dokumentierten Abweichungen.

Obwohl beide Tierkreise aus denselben Planetenpositionen berechnet werden (über Swiss Ephemeris), unterscheiden sie sich konzeptionell:

Vedic ist keine “Alternative” zur westlichen Astrologie, sondern ein eigenständiges System mit eigenem logischem Gerüst. Integratoren, die Apps für mehrere Traditionen bauen (mobiles Horoskop, Matchmaking, Tageshoroskop), wollen oft beides, und eine API statt zwei Drittanbietern ist eine echte Ersparnis.

Die meisten Wettbewerber haben nur Vimshottari (120-jähriger Zyklus, das populärste System). AstroWay deckt ab:

1. Vimshottari (120 Jahre): BPHS-Standard, durchgängig
2. Yogini (36 Jahre): schnellere Vorhersagen, 8 Planeten
3. Ashtottari (108 Jahre): Ardradi-Tradition, Paksha-Empfehlung
4. Kalachakra (Zeichen als MD-Herrscher): das komplexeste System, Paramayu variiert je Chart
5. Chara (Jaimini, beweglich): für zeichenbasierte Vorhersagen
6. Tribhagi (54 = Vimshottari/2 + Extras): beschleunigtes Vimshottari
7. Shatabdika (100 Jahre): unterschiedliche Zählweisen der Quellen
8. Shodashottari (116 Jahre): für Charts mit gemischtem Paksha
9. Sthira (seltene Dasha mit festen Perioden)
10. Shoola (Methode über die Rasis)

Jedes System unterstützt 5 Ebenen: Maha → Antar → Pratyantar → Sookshma → Prana.

Teilungscharts sind rekursive Blicke auf dasselbe Geburtshoroskop in unterschiedlichen Maßstäben. D9 (Navamsha) ist das wichtigste für die Ehe, D10 (Dashamsha) für den Beruf, D60 (Shashtyamsha) ist die feinste Ebene.

Ein einziger Aufruf von /v1/vedic/vargas liefert alle 16 Teilungen auf einmal - der Integrator muss keine 16 einzelnen Anfragen stellen.

5 Elemente plus Ergänzungen:

• Tithi (Mondtag, 30 Abschnitte des Mondzyklus)
• Karana (halbes Tithi, 11 Typen)
• Yoga (Tages-Yoga, 27 Typen, basiert auf der Summe der Längen von Sonne + Mond)
• Nakshatra (eine der 27 Mondstationen)
• Choghadia (Tag und Nacht in je 8 Blöcke unterschiedlicher Günstigkeit geteilt, jeweils etwa eineinhalb Stunden lang)
• Hora (Planetenstunde)
• Rahu-kaal (ein täglich ungünstiges Zeitfenster von 1,5 Stunden)

Mit einem Aufruf von /v1/vedic/panchang/full bekommst du alle 8 Elemente in einem JSON für ein bestimmtes Datum und einen bestimmten Ort.

Ein Yoga ist im Vedic eine besondere Planetenkombination, die ein auffälliges Lebensmuster bildet. Parashara (BPHS) beschreibt Hunderte davon, AstroWay implementiert die am häufigsten zitierten:

• Raja: Kombinationen für Macht und Anerkennung
• Dhana: Wohlstand
• Dharma-Karmadhipati: beruflicher Weg
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 Planeten in Kendra-Häusern in ihren eigenen Zeichen)
• Gajakesari: Mond + Jupiter im Kendra
• Adhi: Merkur/Venus/Jupiter im 6./7./8. vom Mond

Dazu Jaimini-spezifische: karaka-yoga (8 Chara-Karakas in bedeutenden Häusern), karakamsa (12-Häuser-Projektion mit dem AK im D9), shubha-graha (funktionale Wohltäter nach BPHS Adhyaya 34).

Ein Dosha ist eine planetare Belastung, die einen bestimmten Lebensbereich erschwert. AstroWay deckt drei Schulen ab:

• Parashara: Mangal Dosha (Mars), Kaal Sarp (Planeten zwischen Rahu und Ketu), Pitru (Karma der Ahnen), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (die Lal-Kitab-spezifische Deutung) sowie weitere Doshas, die es nur in dieser Schule gibt
• KP (Krishnamurti Paddhati): Diagnostik auf Sub-Lord-Basis

Wenn dein Matchmaking-Dienst Kunden aus verschiedenen Regionen Indiens bedient (im Punjab nutzt man oft LK, in Tamil Nadu KP, überall Parashara), brauchst du eine API statt drei.

Der klassische indische Matching-Prozess:

1. Ashtakoot (Guna Milan): achtfache Skala, maximal 36 Punkte. Unter 18 gilt als wenig kompatibel. Am beliebtesten in Nord- und Zentralindien.
2. Dashakoota: zehnfach, die südindische Variante.
3. Manglik check: entscheidend für Geburtshoroskope mit belastetem Mars.
4. Mangal match: gleicht Mars-Mars aus.
5. Bhrigu match: prädiktives Overlay aus der Bhrigu Samhita.

Alles über /v1/vedic/compatibility/full - ein Aufruf, ein vollständiger Kompatibilitätsbericht.

“Muhurta” ist ein günstiger Zeitpunkt, um ein Vorhaben zu beginnen. Klassische Anlässe:

• Marriage muhurta (Hochzeit)
• Vehicle purchase (Autokauf)
• Business start (Geschäftseröffnung)
• Travel (Reisen)
• Naming ceremony (Namakaran: Namensgebung für ein Neugeborenes)
• Surgery, education start, investment, property purchase, griha-pravesh (Einzug ins neue Haus), engagement, court cases

/v1/vedic/muhurat/{event} liefert die Top-3 der günstigen Termine in einem angegebenen Zeitraum.

Lahiri ist der Standard (Chitra Paksha, der offizielle Standard der indischen Regierung). Über den Parameter ayanamsa lässt sich umschalten:

• raman: Tradition nach B.V. Raman (beliebt im KP)
• krishnamurti: KP-spezifisch
• yukteshwar: Sri Yukteshwar (Abstand von Spica)
• fagan-bradley: Fagan/Bradley (westlich siderisch)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Jede davon ist ein anderer Offset (meist 23,5–24,0°). Für ein und denselben Kunden können die Planetenpositionen in den Zeichen abweichen - das solltest du schon in der Architekturphase deiner App wissen.

Jeder Endpunkt hat:

• einen Status (GREEN/YELLOW) in docs/AUDIT-TRAIL.md
• einen Inline-AUDIT-Header im Quellcode mit den Quellen (BPHS Adhyaya N, Jaimini Sutras X.Y, PyJHora-Referenzfunktion)
• eine Snapshot-Test-Fixture gegen Regressionen

Abweichungen von PyJHora (wo es sie gibt, meist bei Methoden eines einzelnen Autors wie Lal Kitab) sind im AUDIT-TRAIL dokumentiert - der Integrator sieht das genaue Delta, bevor er integriert.

# Natal Vedic chart
curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Liefert den aktuellen Maha-Dasha-Herrscher, das Enddatum der MD und die Abfolge der nächsten Dashas. Über /maha → /antar → /pratyantar → … kannst du bis zur 5. Ebene in die Tiefe gehen.

Vedische Reports (PDF) sind in 20 Sprachen verfügbar, darunter hi, ko, ja, id, tr, vi - Märkte mit echter Nachfrage nach vedischen Inhalten. Übergib lang=<code> an einen beliebigen /v1/reports/*-Endpunkt. Details unter /languages/.

Vedische Endpunkte kosten 10, 20 oder 50 Credits, je nachdem, was sie berechnen: Lal Kitab und KP 10, Vargas und Panchang-Elemente 20, Parashara-Doshas, Dashas, Shadbala und Muhurta 50. Im kostenlosen Tarif (10 000 Credits) sind das 200 bis 1000 vedische Aufrufe pro Monat. PDF-Reports Vedic Kundli / Lal Kitab kosten 5000.

• Kategorien der vedischen Endpunkte: Navigation durch 8 Gruppen
• Vedic API im Überblick: vollständige Übersicht mit Codebeispielen in 4 Sprachen
• Schnellstart: die erste Anfrage in 5 Minuten
• Tarife: von kostenlos bis Enterprise