무후르타 - 택일 점성술

무후르타는 베다의 택일 점성술입니다: 중요한 일을 시작하기에 길한 순간을 고르는 것이죠. 출생 점성술과 달리 여기서는 차트를 _미래의 순간_에 대해 세우고, 알고리즘이 날짜/시간 창을 훑으며 planetary panchang 요소(티티, 낙샤트라, 요가, 카라나, vara, lagna)가 특정 행사에 가장 유리한 때를 찾습니다.

계산 항목

각 엔드포인트는 고유한 조건 세트를 확인합니다:

marriage: Saptapadi 시간: 길한 티티(2, 3, 5, 7, 10, 11, 12, 13), 낙샤트라(Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), Manglik 부조화 기간 회피.
vehicle-purchase: 수성/금성이 강함, Astha(금성 연소) 회피, Bhadra 카라나 회피.
business-start: 목성의 애스펙트를 받는 lagna, 흉성이 없는 10하우스, Chandra Bala.
travel: Dishashool(그날의 방향), 이동성 낙샤트라, Yamaganda 회피.
naming-ceremony (Namakaran): 출생 후 11일째 또는 12일째; 이름에 길한 낙샤트라.
surgery: Sankranti, 토요일, Chandrashtama 회피; 화성/토성 관련 규칙.
education-start (Vidyarambh): 수요일/목요일 + 수성/목성이 강함 + 지식의 낙샤트라(Hasta, Pushya, Sravana, Revati).
investment: 2하우스와 11하우스, 목성과 금성의 지원.
property-purchase: 깨끗한 4하우스, 토성의 애스펙트, 4하우스의 화성 회피.
journey-long: travel보다 엄격함: 먼 여행에 대한 Yatra 프라카라나의 규정에 따라 금요일 제외.
name-change: 나마카란 규칙을 성인의 개명에 적용.
general-auspicious: 특정 행사와 무관한 보편적 길일(Pushya, Hasta, shubha 티티) - 산칼파, 기도용 또는 대체 옵션.

엔드포인트

엔드포인트	크레딧	행사
`/v1/vedic/muhurat/marriage`	50	결혼 (saptapadi 시간)
`/v1/vedic/muhurat/naming-ceremony`	50	나마카란 (아기 작명)
`/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/*)으로 계산하며, 같은 source-of-truth를 사용합니다.
창 스캔: 알고리즘은 [search_window_start, search_window_end]를 하루씩 훑으며 각 날을 그날의 판창으로 평가하고(대략 -10에서 +10 척도: >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, 그 아래는 avoid), score 순으로 정렬한 상위 topN을 반환합니다. 하루 안에서는 Abhijit Muhurat 창을 반환하며, 15분 단위 슬롯은 따로 계산하지 않습니다.
알고리즘 선택: 일부 규칙(특히 surgery, court-case)은 좁은 지역 학파에서 유래합니다. 문서에 어떤 변형을 택했고 그 이유가 무엇인지 적어 둡니다.
상태: marriage, vehicle-purchase, griha-pravesh, travel, business-start - GREEN (Drik Panchang 및 ProKerala와 cross-verified). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement - 대부분 YELLOW (single-source 학파). 자세한 breakdown은 docs/AUDIT-TRAIL.md에 있습니다.

무후르타 - 택일 점성술

계산 항목

엔드포인트

예제

정확도와 출처

관련 문서