Astrologia vedica via API: da Parashara al Lal Kitab in 354 endpoint

L’astrologia vedica è la più antica tradizione astrologica ininterrotta al mondo. Le sue metodologie formali (BPHS, Jaimini Sutra, Lal Kitab, KP) si usano ogni giorno in India: per i matchmaker matrimoniali, la scelta delle date, la diagnosi proattiva del destino. Ma arrivare a calcoli di qualità in modo programmatico fino a poco tempo fa era doloroso.

AstroWay v2.19 risolve il problema: oltre 354 endpoint vedici, verificati in modo incrociato con PyJHora (l’implementazione di riferimento in Python), con le divergenze documentate.

Anche se entrambi gli zodiaci si calcolano dalle stesse posizioni planetarie (tramite Swiss Ephemeris), concettualmente sono diversi:

Il vedico non è un‘“alternativa” all’occidentale: è un sistema a sé con una propria struttura logica interna. Chi integra app multi-tradizione (oroscopo mobile, matchmaker, daily horoscope) spesso vuole entrambi, e qui una sola API al posto di due fornitori esterni è un risparmio serio.

La maggior parte dei concorrenti offre solo Vimshottari (ciclo di 120 anni, il più popolare). AstroWay copre:

1. Vimshottari (120 anni): lo standard BPHS, trasversale
2. Yogini (36 anni): previsioni più rapide, 8 pianeti
3. Ashtottari (108 anni): tradizione Ardradi, raccomandazione per paksha
4. Kalachakra (signs-as-MD-lords): il sistema più complesso, il paramayu varia per carta
5. Chara (Jaimini movable): per previsioni basate sui segni
6. Tribhagi (54 = Vimshottari/2 + extras): Vimshottari accelerato
7. Shatabdika (100 anni): conteggi di fonte variabili
8. Shodashottari (116 anni): per carte con paksha misto
9. Sthira (rara dasha a periodo fisso)
10. Shoola (metodo cross-rasi)

Ognuno supporta 5 livelli: Maha → Antar → Pratyantar → Sookshma → Prana.

Le carte divisionali sono sguardi ricorsivi sulla stessa carta natale a scale diverse. La D9 (Navamsha) è la più importante per il matrimonio. La D10 (Dashamsha) per la carriera. La D60 (Shashtyamsha) è il livello più fine.

Una sola chiamata a /v1/vedic/vargas restituisce tutte le 16 divisioni in una volta: l’integratore non deve fare 16 richieste separate.

5 elementi + ausiliari:

• Tithi (giorno lunare, 30 divisioni del ciclo lunare)
• Karana (mezzo tithi, 11 tipi)
• Yoga (day-yoga, 27 tipi, basato sulla somma delle longitudini di Sole + Luna)
• Nakshatra (una delle 27 dimore lunari)
• Choghadia (giorno e notte divisi in 8 blocchi di auspiciosità ciascuno, di circa un’ora e mezza l’uno)
• Hora (ora planetaria)
• Rahu-kaal (finestra infausta di 1,5 ore ogni giorno)

Chiamando /v1/vedic/panchang/full ottieni tutti gli 8 elementi in un solo JSON per una data e una località specifiche.

Uno yoga nel vedico è una combinazione planetaria particolare che forma un life-pattern riconoscibile. Parashara (BPHS) ne descrive centinaia; AstroWay implementa i più citati:

• Raja: combinazioni di potere e riconoscimento
• Dhana: ricchezza
• Dharma-Karmadhipati: percorso professionale
• Pancha-Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 pianeti nelle case kendra nei propri segni)
• Gajakesari: Luna + Giove in kendra
• Adhi: Mercurio/Venere/Giove in 6/7/8 dalla Luna

In più quelli specifici di Jaimini: karaka-yoga (8 chara karaka in case significative), karakamsa (12-house projection con l’AK nella D9), shubha-graha (functional benefic secondo BPHS Adhyaya 34).

Un dosha è un’afflizione planetaria che complica un ambito specifico della vita. AstroWay copre tre scuole:

• Parashara: Mangal Dosha (Marte), Kaal Sarp (pianeti tra Rahu e Ketu), Pitru (karma ancestrale), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (interpretazione specifica del Lal Kitab), più altri dosha unici di questa scuola
• KP (Krishnamurti Paddhati): diagnostica basata sui sub-lord

Se il tuo matchmaker serve clienti di regioni diverse dell’India (il Punjab usa spesso LK, il Tamil Nadu il KP, tutti Parashara), hai una sola API invece di tre.

Il classico processo di match indiano:

1. Ashtakoot (Guna Milan): scala a 8 componenti, 36 punti al massimo. Meno di 18 = bassa compatibilità. Il più diffuso nell’India del Nord e del Centro.
2. Dashakoota: a 10 componenti, variante del Sud dell’India.
3. Manglik check: critico per le carte natali con Marte afflitto.
4. Mangal match: compensa Marte-Marte.
5. Bhrigu match: overlay predittivo dalla Bhrigu Samhita.

Tutto tramite /v1/vedic/compatibility/full: una chiamata, un report di compatibilità completo.

Il “muhurta” è un momento propizio per avviare un evento. Gli eventi classici:

• Marriage muhurta (matrimonio)
• Vehicle purchase (auto)
• Business start (apertura di un’attività)
• Travel (viaggi)
• Naming ceremony (Namakaran: attribuzione del nome al neonato)
• Surgery, education start, investment, property purchase, griha-pravesh (ingresso nella nuova casa), engagement, court cases

/v1/vedic/muhurat/{event} restituisce le 3 date più propizie nell’intervallo indicato.

Lahiri è il default (Chitra Paksha, lo standard ufficiale del governo indiano). Con il parametro ayanamsa puoi cambiarlo:

• raman: tradizione di B.V. Raman (popolare nel KP)
• krishnamurti: specifico del KP
• yukteshwar: Sri Yukteshwar (distanza da Spica)
• fagan-bradley: Fagan/Bradley (siderale occidentale)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Ognuna ha un offset diverso (di solito 23,5–24,0°). Per lo stesso cliente le posizioni dei pianeti nei segni possono cambiare: è importante saperlo già in fase di architettura della tua app.

Ogni endpoint ha:

• Uno Status (GREEN/YELLOW) in docs/AUDIT-TRAIL.md
• Un’intestazione AUDIT inline nel codice sorgente con le fonti (BPHS Adhyaya N, Jaimini Sutras X.Y, funzione di riferimento di PyJHora)
• Una fixture di snapshot test contro le regressioni

Le divergenze da PyJHora (dove ci sono, soprattutto per metodologie di un solo autore come il Lal Kitab) sono documentate in AUDIT-TRAIL: l’integratore vede il delta esatto prima di integrare.

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

Restituisce il signore della Maha dasha attuale, la data di fine della MD e la sequenza delle dasha successive. Passando da /maha → /antar → /pratyantar → … puoi scendere fino al 5° livello.

I report vedici (PDF) sono disponibili in 20 lingue, tra cui hi, ko, ja, id, tr, vi: mercati con una domanda reale di contenuti vedici. Passa lang=<code> a qualsiasi endpoint /v1/reports/*. Dettagli in /languages/.

Gli endpoint vedici costano 10, 20 o 50 crediti a seconda di cosa calcolano: Lal Kitab e KP 10, varga ed elementi del panchang 20, dosha di Parashara, dasha, shadbala e muhurta 50. Sul piano gratuito (10 000 crediti) sono da 200 a 1000 chiamate vediche al mese. I report PDF Vedic Kundli / Lal Kitab costano 5000.

• Categorie di endpoint vedici: navigazione tra 8 gruppi
• Vedic API marketing: panoramica completa con esempi di codice in 4 linguaggi
• Guida rapida: la prima richiesta in 5 minuti
• Prezzi: dal piano gratuito a Enterprise