Muhurta - astrologia elettiva
Il muhurta è l’astrologia elettiva vedica: la scelta del momento favorevole per avviare un’impresa importante. A differenza dell’astrologia natale, qui la carta si costruisce per un momento futuro, e l’algoritmo scorre una finestra di date e ore cercando quando i fattori planetari del panchang (tithi, nakshatra, yoga, karana, vara, lagna) sono più favorevoli per l’evento specifico.
Cosa calcoliamo
Sezione intitolata “Cosa calcoliamo”Ogni endpoint verifica un proprio insieme di condizioni:
- marriage: il momento del Saptapadi: tithi favorevoli (2, 3, 5, 7, 10, 11, 12, 13), nakshatra (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), esclusione dei periodi incompatibili per Manglik.
- vehicle-purchase: Mercurio/Venere forti, esclusione di Astha (Venere combusta), karana Bhadra.
- business-start: lagna aspettato da Giove, 10ª casa libera da malefici, Chandra Bala.
- travel: Dishashool (la direzione del giorno), nakshatra di movimento, esclusione di Yamaganda.
- naming-ceremony (Namakaran): l’11° o il 12° giorno dopo la nascita; nakshatra favorevoli per il nome.
- surgery: esclusione di Sankranti, sabato, Chandrashtama; regole legate a Marte/Saturno.
- education-start (Vidyarambh): mercoledì/giovedì + Mercurio/Giove forti + nakshatra della conoscenza (Hasta, Pushya, Sravana, Revati).
- investment: 2ª e 11ª casa, sostegno di Giove e Venere.
- property-purchase: 4ª casa pulita, aspetto di Saturno, esclusione di Marte in 4ª.
- journey-long: più rigoroso di travel: il venerdì è escluso, come prescrive la Yatra-prakarana per i viaggi lontani.
- name-change: le regole del Namakaran applicate al cambio di nome di un adulto.
- general-auspicious: giorni favorevoli universali (Pushya, Hasta, shubha tithi) senza legame con un evento, per un sankalpa, una preghiera o come opzione di riserva.
Endpoint
Sezione intitolata “Endpoint”| Endpoint | Crediti | Evento |
|---|---|---|
/v1/vedic/muhurat/marriage | 50 | Matrimonio (momento del saptapadi) |
/v1/vedic/muhurat/naming-ceremony | 50 | Namakaran (nome del bambino) |
/v1/vedic/muhurat/name-change | 50 | Cambio di nome |
/v1/vedic/muhurat/property-purchase | 50 | Acquisto di un immobile |
/v1/vedic/muhurat/vehicle-purchase | 50 | Acquisto di un’auto |
/v1/vedic/muhurat/business-start | 50 | Avvio di un’attività |
/v1/vedic/muhurat/investment | 50 | Investimento |
/v1/vedic/muhurat/education-start | 50 | Vidyarambh: inizio degli studi |
/v1/vedic/muhurat/travel | 50 | Viaggio |
/v1/vedic/muhurat/journey-long | 50 | Viaggio lontano |
/v1/vedic/muhurat/surgery | 50 | Intervento chirurgico |
/v1/vedic/muhurat/general-auspicious | 50 | Giorni favorevoli universali |
Esempio
Sezione intitolata “Esempio”curl -X POST https://api.astroway.info/v1/vedic/muhurat/marriage \ -H "X-Api-Key: aw_live_your_key_here" \ -H "Content-Type: application/json" \ -d '{ "search_window_start": "2026-09-01", "search_window_end": "2026-12-31", "latitude": 28.6139, "longitude": 77.2090, "timezoneOffset": 5.5, "ayanamsa": "lahiri", "topN": 10 }'const r = await fetch('https://api.astroway.info/v1/vedic/muhurat/business-start', { method: 'POST', headers: { 'X-Api-Key': process.env.ASTROWAY_API_KEY!, 'Content-Type': 'application/json', }, body: JSON.stringify({ search_window_start: '2026-09-01', search_window_end: '2026-12-31', latitude: 50.4501, longitude: 30.5234, timezoneOffset: 3, ayanamsa: 'lahiri', topN: 5, }),});const { data } = await r.json();for (const day of data.auspiciousWindows) { console.log(`${day.date} (${day.weekdayName}): ${day.score}, ${day.rating}`); console.log(` Nakshatra ${day.panchang.nakshatraName}, tithi ${day.panchang.tithiName}`); console.log(` Abhijit: ${day.abhijitMuhurat.startTime}-${day.abhijitMuhurat.endTime}`);}import os, requests
r = requests.post( 'https://api.astroway.info/v1/vedic/muhurat/travel', headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']}, json={ 'search_window_start': '2026-09-01', 'search_window_end': '2026-09-30', 'latitude': 50.4501, 'longitude': 30.5234, 'timezoneOffset': 3, 'ayanamsa': 'lahiri', 'topN': 10, },)for day in r.json()['data']['auspiciousWindows']: print(f"{day['date']} ({day['weekdayName']}): {day['score']} {day['rating']}")Esempio di risposta (marriage, ridotta a un solo giorno):
{ "data": { "activity": "marriage", "search_window": { "start": "2026-09-01", "end": "2026-12-31", "daysScanned": 90 }, "location": { "latitude": 28.6139, "longitude": 77.209, "timezoneOffset": 5.5 }, "ayanamsa": 24.22961764440157, "auspiciousWindows": [ { "date": "2026-10-12", "weekday": 1, "weekdayName": "Somavara", "panchang": { "tithi": 2, "tithiName": "Dvitiya", "paksha": "shukla", "vara": 1, "varaName": "Somavara", "nakshatra": 15, "nakshatraName": "Swati", "yoga": 5, "yogaName": "Shobhana", "karana": "Balava", "karanaIndex": 3, "pada": 2 }, "abhijitMuhurat": { "startTime": "11:44:21", "endTime": "12:30:41", "midHour": 12.125246156007051 }, "score": 9, "rating": "excellent", "factors": [ { "field": "nakshatra", "delta": 3, "note": "Swati: auspicious for marriage" }, { "field": "vara", "delta": 2, "note": "Somavara: auspicious weekday" }, { "field": "tithi", "delta": 2, "note": "Tithi Dvitiya (shukla): favourable" }, { "field": "yoga", "delta": 1, "note": "Yoga Shobhana: acceptable" }, { "field": "karana", "delta": 1, "note": "Karana Balava: movable, supportive" } ] } ], "nextAuspiciousWindow": "2026-10-12" }}Precisione e fonti
Sezione intitolata “Precisione e fonti”- Testi canonici: Muhurta Chintamani (Ramadayalu Bhattacharya, ~1600) e Muhurta Martand (Narayana, XVII secolo). Compendi moderni: B.V. Raman Muhurta or Electional Astrology; K.K. Pathak Brihat Muhurta Bhusana.
- Fattori del panchang: calcolati dal nostro motore panchang indipendente (
/v1/vedic/panchang/*), la stessa fonte di verità. - Scansione della finestra: l’algoritmo percorre
[search_window_start, search_window_end]giorno per giorno, valuta ogni giorno in base al suo panchang (scala da circa -10 a +10:>= 7excellent,>= 4good,>= 0average,>= -3poor, sotto avoid) e restituisce itopNmigliori, ordinati perscore. All’interno del giorno viene restituita la finestra dell’Abhijit Muhurat; gli slot separati da 15 minuti non vengono calcolati. - Scelte algoritmiche: alcune regole (soprattutto per
surgery,court-case) provengono da scuole regionali ristrette. Nella documentazione scriviamo quale variante abbiamo scelto e perché. - Stato:
marriage,vehicle-purchase,griha-pravesh,travel,business-startsono GREEN (verificati in modo incrociato con Drik Panchang e ProKerala).surgery,court-case,naming-ceremony,investment,property-purchase,education-start,engagementsono per lo più YELLOW (scuole a fonte unica). Il dettaglio completo è indocs/AUDIT-TRAIL.md.
Correlati
Sezione intitolata “Correlati” Compatibilità Confronto delle carte prima del matrimonio + Manglik
Yoga Raja, Dhana, Mahapurusha: le combinazioni
Dosha Manglik, Kala Sarpa, Pitru: le afflizioni
Costi I crediti di ogni endpoint
Precisione Come verifichiamo i calcoli
Autenticazione X-Api-Key, chiavi di test
Utile?
Grazie per il feedback.