Muhurta - astrologie electională

Muhurta este astrologia electională vedică: alegerea momentului favorabil pentru începerea unui lucru important. Spre deosebire de astrologia natală, aici harta se construiește pentru un moment viitor, iar algoritmul parcurge o fereastră de date/ore, căutând când factorii planetari din panchang (tithi, nakshatra, yoga, karana, vara, lagna) sunt cei mai favorabili pentru evenimentul respectiv.

Sfat

Cum funcționează endpoint-urile de muhurta. La intrare - fereastra de căutare (start/end date, locație, durata evenimentului). La ieșire - o listă ordonată de variante cu scor, ce elemente din panchang sunt favorabile/nefavorabile și o listă “de evitat” (Rahu Kaal, Yamaganda, Gulika Kaal).

Ce calculăm

Fiecare endpoint verifică un set unic de condiții:

• marriage: momentul Saptapadi: tithi favorabile (2, 3, 5, 7, 10, 11, 12, 13), nakshatra (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), evitarea perioadelor incompatibile Manglik.
• vehicle-purchase: Mercur/Venus puternici, evitarea Astha (Venus combust), karana Bhadra.
• business-start: lagna aspectată de Jupiter, casa a 10-a liberă de malefici, Chandra Bala.
• travel: Dishashool (direcția zilei), nakshatra de mobilitate, evitarea Yamaganda.
• naming-ceremony (Namakaran): în a 11-a sau a 12-a zi după naștere; nakshatra favorabile pentru nume.
• surgery: evitarea Sankranti, a zilei de sâmbătă, a Chandrashtama; reguli legate de Marte/Saturn.
• education-start (Vidyarambh): miercuri/joi + Mercur/Jupiter puternici + nakshatra ale cunoașterii (Hasta, Pushya, Sravana, Revati).
• investment: casele a 2-a și a 11-a, sprijinul lui Jupiter și Venus.
• property-purchase: casa a 4-a curată, aspectată de Saturn, evitarea lui Marte în casa a 4-a.
• journey-long: mai strict decât travel: vinerea este exclusă, așa cum cere Yatra-prakarana pentru călătoriile lungi.
• name-change: regulile Namakaran, transferate la schimbarea numelui unui adult.
• general-auspicious: zile universal favorabile (Pushya, Hasta, shubha-tithi) fără legătură cu un eveniment - pentru sankalpa, rugăciune sau ca variantă de rezervă.

Endpoint-uri

Endpoint	Credite	Eveniment
/v1/vedic/muhurat/marriage	50	Nuntă (momentul saptapadi)
/v1/vedic/muhurat/naming-ceremony	50	Namakaran (alegerea numelui copilului)
/v1/vedic/muhurat/name-change	50	Schimbarea numelui
/v1/vedic/muhurat/property-purchase	50	Cumpărarea unei proprietăți
/v1/vedic/muhurat/vehicle-purchase	50	Cumpărarea unei mașini
/v1/vedic/muhurat/business-start	50	Lansarea unei afaceri
/v1/vedic/muhurat/investment	50	Investiție
/v1/vedic/muhurat/education-start	50	Vidyarambh - începutul studiilor
/v1/vedic/muhurat/travel	50	Călătorie
/v1/vedic/muhurat/journey-long	50	Călătorie lungă
/v1/vedic/muhurat/surgery	50	Operație
/v1/vedic/muhurat/general-auspicious	50	Zile universal favorabile

Exemplu

cURL

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

Node.js

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}`);
}

Python

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']}")

Exemplu de răspuns (marriage, scurtat la o singură zi):

{
  "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"
  }
}

Precizie și surse

• Texte canonice: Muhurta Chintamani (Ramadayalu Bhattacharya, ~1600) și Muhurta Martand (Narayana, sec. XVII). Compendii moderne: B.V. Raman Muhurta or Electional Astrology; K.K. Pathak Brihat Muhurta Bhusana.
• Factorii din panchang: se calculează cu propriul nostru motor de panchang (/v1/vedic/panchang/*), aceeași sursă de adevăr.
• Scanarea ferestrei: algoritmul parcurge [search_window_start, search_window_end] zi cu zi, evaluează fiecare zi după panchang-ul ei (scală aproximativ de la -10 la +10: >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, sub acesta avoid) și returnează cele mai bune topN, sortate după score. În interiorul zilei se returnează fereastra Abhijit Muhurat; sloturile separate de 15 minute nu se calculează.
• Alegeri algoritmice: unele reguli (în special pentru surgery, court-case) provin din școli regionale restrânse. În docs scriem ce variantă am ales și de ce.
• Status: marriage, vehicle-purchase, griha-pravesh, travel, business-start - GREEN (verificate încrucișat cu Drik Panchang și ProKerala). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement - în principal YELLOW (școli cu o singură sursă). Defalcarea detaliată - docs/AUDIT-TRAIL.md.

Pagini conexe

Compatibilitate Compararea hărților înainte de nuntă + Manglik

Yoga Raja, Dhana, Mahapurusha - combinații

Dosha Manglik, Kaal Sarp, Pitru - afecțiuni

Cost Credite pentru fiecare endpoint

Precizie Cum verificăm calculele

Autentificare X-Api-Key, chei de test