Muhurta - ελεκτική αστρολογία

Η muhurta είναι η βεδική ελεκτική αστρολογία: η επιλογή της ευνοϊκής στιγμής για να ξεκινήσει κάτι σημαντικό. Σε αντίθεση με τη γενέθλια αστρολογία, εδώ ο χάρτης στήνεται για μια μελλοντική στιγμή, και ο αλγόριθμος διατρέχει ένα παράθυρο ημερομηνιών/ωρών ψάχνοντας πότε οι παράγοντες του panchang (tithi, nakshatra, yoga, karana, vara, lagna) είναι οι πιο ευνοϊκοί για το συγκεκριμένο γεγονός.

Τι υπολογίζουμε

Κάθε endpoint ελέγχει ένα δικό του σύνολο συνθηκών:

marriage: χρόνος Saptapadi: ευνοϊκά tithi (2, 3, 5, 7, 10, 11, 12, 13), nakshatra (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), αποφυγή περιόδων ασύμβατων ως προς Manglik.
vehicle-purchase: Ερμής/Αφροδίτη δυνατοί, αποφυγή Astha (καύση της Αφροδίτης), Bhadra karana.
business-start: lagna με όψη του Δία, 10ος οίκος ελεύθερος από κακοποιούς, Chandra Bala.
travel: Dishashool (κατεύθυνση της ημέρας), nakshatra κινητικότητας, αποφυγή Yamaganda.
naming-ceremony (Namakaran): την 11η ή 12η ημέρα μετά τη γέννηση, ευνοϊκά nakshatra για το όνομα.
surgery: αποφυγή Sankranti, Σαββάτου, Chandrashtama, κανόνες σχετικοί με Άρη/Κρόνο.
education-start (Vidyarambh): Τετάρτη/Πέμπτη + Ερμής/Δίας δυνατοί + nakshatra της γνώσης (Hasta, Pushya, Sravana, Revati).
investment: 2ος και 11ος οίκος, υποστήριξη από Δία και Αφροδίτη.
property-purchase: 4ος οίκος καθαρός, όψη του Κρόνου, αποφυγή του Άρη στον 4ο.
journey-long: αυστηρότερο από το travel: η Παρασκευή αποκλείεται, όπως ορίζει η Yatra prakarana για μακρινά ταξίδια.
name-change: οι κανόνες του Namakaran μεταφερμένοι στην αλλαγή ονόματος ενηλίκου.
general-auspicious: γενικά ευνοϊκές ημέρες (Pushya, Hasta, shubha tithi) χωρίς σύνδεση με γεγονός, για sankalpa, προσευχή ή ως εφεδρική επιλογή.

Endpoints

Endpoint	Credits	Γεγονός
`/v1/vedic/muhurat/marriage`	50	Γάμος (χρόνος saptapadi)
`/v1/vedic/muhurat/naming-ceremony`	50	Namakaran (ονοματοδοσία παιδιού)
`/v1/vedic/muhurat/name-change`	50	Αλλαγή ονόματος
`/v1/vedic/muhurat/property-purchase`	50	Αγορά ακινήτου
`/v1/vedic/muhurat/vehicle-purchase`	50	Αγορά αυτοκινήτου
`/v1/vedic/muhurat/business-start`	50	Έναρξη επιχείρησης
`/v1/vedic/muhurat/investment`	50	Επένδυση
`/v1/vedic/muhurat/education-start`	50	Vidyarambh - έναρξη σπουδών
`/v1/vedic/muhurat/travel`	50	Ταξίδι
`/v1/vedic/muhurat/journey-long`	50	Μακρινό ταξίδι
`/v1/vedic/muhurat/surgery`	50	Χειρουργείο
`/v1/vedic/muhurat/general-auspicious`	50	Γενικά ευνοϊκές ημέρες

Παράδειγμα

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

Παράδειγμα απάντησης (marriage, συντομευμένο σε μία ημέρα):

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

Ακρίβεια και πηγές

Κανονικά κείμενα: Muhurta Chintamani (Ramadayalu Bhattacharya, ~1600) και Muhurta Martand (Narayana, 17ος αι.). Σύγχρονες επιτομές: B.V. Raman Muhurta or Electional Astrology, K.K. Pathak Brihat Muhurta Bhusana.
Παράγοντες panchang: υπολογίζονται από τη δική μας ανεξάρτητη μηχανή panchang (/v1/vedic/panchang/*), την ίδια πηγή αλήθειας.
Σάρωση παραθύρου: ο αλγόριθμος διατρέχει το [search_window_start, search_window_end] ανά ημέρα, βαθμολογεί κάθε ημέρα με βάση το panchang της (κλίμακα περίπου από -10 έως +10: >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, κάτω από αυτό avoid) και επιστρέφει τις topN καλύτερες, ταξινομημένες κατά score. Μέσα στην ημέρα επιστρέφεται το παράθυρο Abhijit Muhurat. Ξεχωριστά slots 15 λεπτών δεν υπολογίζονται.
Αλγοριθμικές επιλογές: ορισμένοι κανόνες (ιδίως για surgery, court-case) προέρχονται από στενές τοπικές σχολές. Στην τεκμηρίωση γράφουμε ποια παραλλαγή επιλέξαμε και γιατί.
Κατάσταση: marriage, vehicle-purchase, griha-pravesh, travel, business-start είναι GREEN (διασταυρωμένα με Drik Panchang και ProKerala). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement είναι κυρίως YELLOW (σχολές μίας πηγής). Αναλυτική κατανομή: docs/AUDIT-TRAIL.md.