Vedische astrologie via een API: van Parashara tot Lal Kitab in 354 endpoints

Vedische astrologie is de oudste ononderbroken astrologische traditie ter wereld. Haar formele methoden (BPHS, de Jaimini-sutra’s, Lal Kitab, KP) worden in India dagelijks gebruikt: door huwelijksbemiddelaars, voor het kiezen van data, voor een proactieve diagnose van het levenspad. Maar programmatisch bij goede berekeningen komen was tot voor kort een pijnlijke klus.

AstroWay v2.19 lost dat op: 354+ Vedische endpoints, kruiselings gecontroleerd tegen PyJHora (de Python-referentie-implementatie), met gedocumenteerde afwijkingen.

Hoewel beide dierenriemen worden berekend vanuit dezelfde planeetposities (via Swiss Ephemeris), verschillen ze conceptueel:

Vedisch is geen “alternatief” voor westers, maar een apart systeem met een eigen logisch kader. Integrators die apps voor meerdere tradities bouwen (mobiele horoscoop, matchmaker, daily horoscope) willen vaak allebei, en dan scheelt één API in plaats van twee externe flink.

De meeste concurrenten hebben alleen Vimshottari (cyclus van 120 jaar, de populairste). AstroWay dekt af:

1. Vimshottari (120 jaar): de BPHS-standaard, overal gebruikt
2. Yogini (36 jaar): snellere voorspellingen, 8 planeten
3. Ashtottari (108 jaar): Ardradi-traditie, aanbevolen op basis van de paksha
4. Kalachakra (tekens als MD-heersers): het meest complexe systeem, de paramayu verschilt per horoscoop
5. Chara (Jaimini, beweeglijk): voor voorspellingen op basis van tekens
6. Tribhagi (54 = Vimshottari/2 + extra’s): versnelde Vimshottari
7. Shatabdika (100 jaar): bronnen tellen verschillend
8. Shodashottari (116 jaar): voor horoscopen met gemengde paksha
9. Sthira (zeldzame dasha met vaste periodes)
10. Shoola (methode over rasi’s heen)

Elk systeem ondersteunt 5 niveaus: Maha → Antar → Pratyantar → Sookshma → Prana.

Divisionele horoscopen zijn recursieve blikken op dezelfde geboortehoroscoop op verschillende schalen. D9 (Navamsha) is de belangrijkste voor het huwelijk. D10 (Dashamsha) gaat over carrière. D60 (Shashtyamsha) is het fijnste niveau.

Eén aanroep naar /v1/vedic/vargas geeft alle 16 indelingen tegelijk terug: de integrator hoeft geen 16 losse verzoeken te doen.

5 elementen + hulpelementen:

• Tithi (maandag in de maancyclus, 30 delen van de maancyclus)
• Karana (halve tithi, 11 typen)
• Yoga (dag-yoga, 27 typen, gebaseerd op de som van de lengtes van Zon + Maan)
• Nakshatra (een van de 27 maanhuizen)
• Choghadia (dag en nacht elk in 8 blokken van gunstigheid, ongeveer anderhalf uur per blok)
• Hora (planetair uur)
• Rahu Kaal (een ongunstig venster van 1,5 uur, elke dag)

Roep je /v1/vedic/panchang/full aan, dan krijg je alle 8 elementen in één JSON voor een bepaalde datum en locatie.

Een yoga is in het Vedische systeem een bijzondere planeetcombinatie die een herkenbaar levenspatroon vormt. Parashara (BPHS) beschrijft er honderden; AstroWay implementeert de meest geciteerde:

• Raja: combinaties van macht en erkenning
• Dhana: rijkdom
• Dharma-Karmadhipati: het beroepspad
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planeten in kendra-huizen in hun eigen teken)
• Gajakesari: Maan + Jupiter in een kendra
• Adhi: Mercurius/Venus/Jupiter in het 6e/7e/8e vanaf de Maan

Plus de Jaimini-specifieke: karaka-yoga (8 chara-karaka’s in betekenisvolle huizen), karakamsa (projectie op 12 huizen met de AK in D9), shubha-graha (functionele benefic volgens BPHS Adhyaya 34).

Een dosha is een planetaire afflictie die een bepaald levensgebied bemoeilijkt. AstroWay dekt drie scholen af:

• Parashara: Mangal Dosha (Mars), Kaal Sarp (planeten tussen Rahu en Ketu), Pitru (voorouderlijk karma), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (de Lal Kitab-specifieke interpretatie), plus andere unieke dosha’s van deze school
• KP (Krishnamurti Paddhati): diagnostiek op basis van sub-lords

Bedient je matchmaker klanten uit verschillende regio’s van India (Punjab gebruikt vaak LK, Tamil Nadu KP, en iedereen Parashara), dan heb je één API in plaats van drie.

Het klassieke Indiase matchingproces:

1. Ashtakoot (Guna Milan): een achtvoudige schaal, maximaal 36 punten. Minder dan 18 = weinig compatibel. Het populairst in Noord- en Centraal-India.
2. Dashakoota: tienvoudig, de Zuid-Indiase variant.
3. Manglik check: cruciaal voor geboortehoroscopen met een Mars-afflictie.
4. Mangal match: compenseert Mars-Mars.
5. Bhrigu match: een voorspellende laag uit de Bhrigu Samhita.

Alles via /v1/vedic/compatibility/full: één aanroep, een volledig compatibiliteitsrapport.

“Muhurta” is een gunstig moment om iets te beginnen. Klassieke gebeurtenissen:

• Marriage muhurta (bruiloft)
• Vehicle purchase (auto)
• Business start (een bedrijf openen)
• Travel (reizen)
• Naming ceremony (Namakaran: de naamgeving van een baby)
• Surgery, education start, investment, property purchase, griha-pravesh (intrek in een nieuw huis), engagement, court cases

/v1/vedic/muhurat/{event} geeft de top-3 gunstige data binnen een opgegeven range terug.

Lahiri is de default (Chitra Paksha, de officiële standaard van de Indiase overheid). Met de parameter ayanamsa kun je overschakelen:

• raman: B.V. Raman-traditie (populair in KP)
• krishnamurti: KP-specifiek
• yukteshwar: Sri Yukteshwar (afstand tot Spica)
• fagan-bradley: Fagan/Bradley (westers siderisch)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Elk heeft een andere offset (meestal 23.5–24.0°). Voor dezelfde klant kunnen de posities van planeten in de tekens dus verschillen: dat wil je al in de architectuurfase van je app weten.

Elk endpoint heeft:

• Een status (GREEN/YELLOW) in docs/AUDIT-TRAIL.md
• Een inline AUDIT-header in de broncode met bronnen (BPHS Adhyaya N, Jaimini Sutras X.Y, PyJHora-referentiefunctie)
• Een snapshot-test-fixture tegen regressies

Afwijkingen van PyJHora (waar die er zijn, meestal bij methoden van één auteur zoals Lal Kitab) zijn gedocumenteerd in AUDIT-TRAIL: de integrator ziet de exacte delta voordat hij gaat integreren.

# 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
  }'

Geeft de huidige Maha-dasha-heerser terug, de einddatum van de MD en de volgorde van de volgende dasha’s. Via /maha → /antar → /pratyantar → … kun je tot het 5e niveau afdalen.

Vedische rapporten (PDF) zijn beschikbaar in 20 talen, waaronder hi, ko, ja, id, tr en vi: markten met echte vraag naar Vedische content. Geef lang=<code> mee aan elk /v1/reports/*-endpoint. Details: /languages/.

Vedische endpoints kosten 10, 20 of 50 credits, afhankelijk van wat ze berekenen: Lal Kitab en KP 10, varga’s en panchang-elementen 20, Parashara-dosha’s, dasha’s, shadbala en muhurta 50. Op het gratis plan (10.000 credits) is dat tussen 200 en 1000 Vedische aanroepen per maand. PDF-rapporten Vedic Kundli / Lal Kitab kosten 5000.

• Categorieën Vedische endpoints: navigatie door 8 groepen
• Vedic API-overzicht: een volledig overzicht met codevoorbeelden in 4 talen
• Snelstart: je eerste verzoek in 5 minuten
• Prijzen: van gratis tot Enterprise