Muhurta - astrologie élective

La muhurta est l’astrologie élective védique : le choix d’un moment favorable pour commencer une entreprise importante. Contrairement à l’astrologie natale, la carte est ici construite pour un moment futur, et l’algorithme parcourt une fenêtre de dates et d’heures en cherchant quand les facteurs planétaires du panchang (tithi, nakshatra, yoga, karana, vara, lagna) sont les plus favorables pour un événement donné.

Astuce

Comment fonctionnent les endpoints de muhurta. En entrée, une fenêtre de recherche (date de début et de fin, lieu, durée de l’événement). En sortie, une liste ordonnée d’options avec un score, les éléments du panchang favorables ou défavorables, et une liste “à éviter” (Rahu Kaal, Yamaganda, Gulika Kaal).

Ce que nous calculons

Chaque endpoint vérifie un ensemble unique de conditions :

• marriage : moment du Saptapadi : tithis favorables (2, 3, 5, 7, 10, 11, 12, 13), nakshatras (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), évitement des périodes incompatibles avec Manglik.
• vehicle-purchase : Mercure/Vénus forts, évitement d’Astha (Vénus combuste), karana Bhadra.
• business-start : lagna aspecté par Jupiter, 10e maison libre de maléfiques, Chandra Bala.
• travel : Dishashool (direction du jour), nakshatra de mobilité, évitement de Yamaganda.
• naming-ceremony (Namakaran) : le 11e ou 12e jour après la naissance ; nakshatras favorables pour le nom.
• surgery : évitement de Sankranti, du samedi, de Chandrashtama ; règles liées à Mars/Saturne.
• education-start (Vidyarambh) : mercredi/jeudi + Mercure/Jupiter forts + nakshatras du savoir (Hasta, Pushya, Sravana, Revati).
• investment : 2e et 11e maisons, soutien de Jupiter et de Vénus.
• property-purchase : 4e maison dégagée, aspect de Saturne, évitement de Mars en 4.
• journey-long : plus strict que travel : le vendredi est exclu, comme le veut le Yatra-prakarana pour les voyages lointains.
• name-change : règles du Namakaran transposées au changement de nom d’un adulte.
• general-auspicious : jours universellement favorables (Pushya, Hasta, tithis shubha) sans lien avec un événement, pour un sankalpa, une prière ou comme solution de repli.

Endpoints

Endpoint	Crédits	Événement
/v1/vedic/muhurat/marriage	50	Mariage (moment du saptapadi)
/v1/vedic/muhurat/naming-ceremony	50	Namakaran (attribution du nom d’un enfant)
/v1/vedic/muhurat/name-change	50	Changement de nom
/v1/vedic/muhurat/property-purchase	50	Achat immobilier
/v1/vedic/muhurat/vehicle-purchase	50	Achat d’une voiture
/v1/vedic/muhurat/business-start	50	Lancement d’une entreprise
/v1/vedic/muhurat/investment	50	Investissement
/v1/vedic/muhurat/education-start	50	Vidyarambh - début des études
/v1/vedic/muhurat/travel	50	Voyage
/v1/vedic/muhurat/journey-long	50	Voyage lointain
/v1/vedic/muhurat/surgery	50	Opération
/v1/vedic/muhurat/general-auspicious	50	Jours universellement favorables

Exemple

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

Exemple de réponse (marriage, abrégé à un seul jour) :

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

Précision et sources

• Textes canoniques : Muhurta Chintamani (Ramadayalu Bhattacharya, ~1600) et Muhurta Martand (Narayana, XVIIe siècle). Compendiums modernes : B.V. Raman Muhurta or Electional Astrology ; K.K. Pathak Brihat Muhurta Bhusana.
• Facteurs du panchang : calculés par notre propre moteur de panchang (/v1/vedic/panchang/*), la même source de vérité.
• Balayage de la fenêtre : l’algorithme parcourt [search_window_start, search_window_end] jour par jour, évalue chaque jour selon son panchang (échelle d’environ -10 à +10 : >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, en dessous avoid) et renvoie les topN meilleurs, triés par score. Pour chaque jour, la fenêtre Abhijit Muhurat est renvoyée ; les créneaux individuels de 15 minutes ne sont pas calculés.
• Choix algorithmiques : certaines règles (notamment pour surgery, court-case) proviennent d’écoles régionales étroites. Dans la documentation, nous indiquons quelle variante nous avons choisie et pourquoi.
• Statut : marriage, vehicle-purchase, griha-pravesh, travel, business-start - GREEN (cross-verified avec Drik Panchang et ProKerala). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement - majoritairement YELLOW (écoles à source unique). Détail complet : docs/AUDIT-TRAIL.md.

Voir aussi

Compatibilité Comparaison des cartes avant le mariage + Manglik

Yogas Raja, Dhana, Mahapurusha - combinaisons

Doshas Manglik, Kala-Sarp, Pitru - afflictions

Coût Crédits pour chaque endpoint

Précision Comment nous vérifions les calculs

Authentification X-Api-Key, clés de test