Muhurta, chiêm tinh chọn ngày

Muhurta là chiêm tinh chọn ngày của Vedic: chọn thời điểm cát tường để bắt đầu một việc quan trọng. Khác với chiêm tinh bản mệnh, ở đây lá số được dựng cho một thời điểm trong tương lai, và thuật toán duyệt qua một khoảng ngày/giờ để tìm lúc các yếu tố panchang của hành tinh (tithi, nakshatra, yoga, karana, vara, lagna) thuận lợi nhất cho sự kiện cụ thể.

Mẹo

Cách các endpoint muhurta hoạt động. Đầu vào là khoảng tìm kiếm (start/end date, location, thời lượng sự kiện). Đầu ra là danh sách phương án đã xếp hạng kèm điểm, các yếu tố panchang nào thuận lợi/bất lợi, và danh sách “cần tránh” (Rahu Kaal, Yamaganda, Gulika Kaal).

Chúng tôi tính những gì

Mỗi endpoint kiểm tra một bộ điều kiện riêng:

• marriage: thời điểm Saptapadi: tithi cát tường (2, 3, 5, 7, 10, 11, 12, 13), nakshatra (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), tránh các giai đoạn không tương hợp về Manglik.
• vehicle-purchase: Thủy tinh/Kim tinh mạnh, tránh Astha (Kim tinh bị đốt), karana Bhadra.
• business-start: lagna được Mộc tinh chiếu, nhà 10 không có hung tinh, Chandra Bala.
• travel: Dishashool (hướng của ngày), nakshatra di động, tránh Yamaganda.
• naming-ceremony (Namakaran): vào ngày thứ 11 hoặc 12 sau khi sinh; nakshatra thuận lợi cho việc đặt tên.
• surgery: tránh Sankranti, thứ Bảy, Chandrashtama; các quy tắc liên quan đến Hỏa tinh/Thổ tinh.
• education-start (Vidyarambh): thứ Tư/thứ Năm + Thủy tinh/Mộc tinh mạnh + nakshatra của tri thức (Hasta, Pushya, Sravana, Revati).
• investment: nhà 2 và nhà 11, được Mộc tinh và Kim tinh hỗ trợ.
• property-purchase: nhà 4 sạch, được Thổ tinh chiếu, tránh Hỏa tinh ở nhà 4.
• journey-long: nghiêm ngặt hơn travel: loại thứ Sáu, theo Yatra-prakarana cho các chuyến đi xa.
• name-change: quy tắc Namakaran áp dụng cho việc đổi tên của người lớn.
• general-auspicious: các ngày cát tường chung (Pushya, Hasta, shubha tithi) không gắn với sự kiện nào: cho sankalpa, cầu nguyện hoặc làm phương án dự phòng.

Endpoint

Endpoint	Credit	Sự kiện
/v1/vedic/muhurat/marriage	50	Đám cưới (thời điểm saptapadi)
/v1/vedic/muhurat/naming-ceremony	50	Namakaran (đặt tên cho trẻ)
/v1/vedic/muhurat/name-change	50	Đổi tên
/v1/vedic/muhurat/property-purchase	50	Mua bất động sản
/v1/vedic/muhurat/vehicle-purchase	50	Mua xe
/v1/vedic/muhurat/business-start	50	Khai trương kinh doanh
/v1/vedic/muhurat/investment	50	Đầu tư
/v1/vedic/muhurat/education-start	50	Vidyarambh: bắt đầu học
/v1/vedic/muhurat/travel	50	Chuyến đi
/v1/vedic/muhurat/journey-long	50	Chuyến đi xa
/v1/vedic/muhurat/surgery	50	Phẫu thuật
/v1/vedic/muhurat/general-auspicious	50	Các ngày cát tường chung

Ví dụ

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

Ví dụ phản hồi (marriage, rút gọn còn một ngày):

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

Độ chính xác và nguồn

• Văn bản kinh điển: Muhurta Chintamani (Ramadayalu Bhattacharya, khoảng năm 1600) và Muhurta Martand (Narayana, thế kỷ 17). Tổng hợp hiện đại: B.V. Raman Muhurta or Electional Astrology; K.K. Pathak Brihat Muhurta Bhusana.
• Các yếu tố panchang: được tính bằng engine panchang riêng của chúng tôi (/v1/vedic/panchang/*), cùng một nguồn sự thật.
• Quét khoảng thời gian: thuật toán đi qua [search_window_start, search_window_end] theo từng ngày, chấm điểm mỗi ngày theo panchang của nó (thang khoảng từ -10 đến +10: >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, thấp hơn là avoid) và trả về topN ngày tốt nhất, sắp xếp theo score. Trong mỗi ngày, trả về khung Abhijit Muhurat; không tính các slot 15 phút riêng lẻ.
• Lựa chọn thuật toán: một số quy tắc (đặc biệt cho surgery, court-case) đến từ các trường phái khu vực hẹp. Trong tài liệu, chúng tôi ghi rõ đã chọn phương án nào và vì sao.
• Trạng thái: marriage, vehicle-purchase, griha-pravesh, travel, business-start là GREEN (đã kiểm tra chéo với Drik Panchang và ProKerala). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement phần lớn là YELLOW (trường phái một nguồn). Phân tích chi tiết: docs/AUDIT-TRAIL.md.

Liên quan

Tương hợp So lá số trước đám cưới + Manglik

Yoga Raja, Dhana, Mahapurusha: các tổ hợp

Dosha Manglik, Kala Sarp, Pitru: các tổn hại

Chi phí Credit cho từng endpoint

Độ chính xác Cách chúng tôi kiểm chứng phép tính

Xác thực X-Api-Key, key thử nghiệm