Muhurta - astrologia eletiva

A muhurta é a astrologia eletiva védica: a escolha de um momento favorável para começar algo importante. Ao contrário da astrologia natal, aqui o mapa é construído para um momento futuro, e o algoritmo percorre uma janela de datas e horas à procura de quando os fatores planetários do panchang (tithi, nakshatra, yoga, karana, vara, lagna) são mais favoráveis para o acontecimento em causa.

Dica

Como funcionam os endpoints de muhurta. À entrada, uma janela de pesquisa (start/end date, location, duração do acontecimento). À saída, uma lista ordenada de opções com pontuação, os elementos do panchang favoráveis/desfavoráveis e uma lista “a evitar” (Rahu Kaal, Yamaganda, Gulika Kaal).

O que calculamos

Cada endpoint verifica um conjunto próprio de condições:

• marriage: momento do Saptapadi: tithis favoráveis (2, 3, 5, 7, 10, 11, 12, 13), nakshatras (Rohini, Mrigashira, Uttara Phalguni, Hasta, Swati, Anuradha, Mula, Uttara Ashadha, Uttara Bhadrapada, Revati), evitar períodos incompatíveis com Manglik.
• vehicle-purchase: Mercúrio/Vénus fortes, evitar Astha (Vénus combusta) e o karana Bhadra.
• business-start: lagna aspetado por Júpiter, casa 10 livre de maléficos, Chandra Bala.
• travel: Dishashool (direção do dia), nakshatra de mobilidade, evitar Yamaganda.
• naming-ceremony (Namakaran): no 11.º ou 12.º dia após o nascimento; nakshatras favoráveis para o nome.
• surgery: evitar Sankranti, sábado, Chandrashtama; regras relacionadas com Marte/Saturno.
• education-start (Vidyarambh): quarta/quinta-feira + Mercúrio/Júpiter fortes + nakshatras do conhecimento (Hasta, Pushya, Sravana, Revati).
• investment: casas 2 e 11, apoio de Júpiter e Vénus.
• property-purchase: casa 4 limpa, aspeto de Saturno, evitar Marte na 4.
• journey-long: mais rigoroso do que travel: a sexta-feira fica excluída, como manda a Yatra-prakarana para viagens longas.
• name-change: as regras do Namakaran, transpostas para a mudança de nome de um adulto.
• general-auspicious: dias favoráveis universais (Pushya, Hasta, shubha tithis) sem ligação a um acontecimento: para sankalpa, oração ou como opção de reserva.

Endpoints

Endpoint	Créditos	Acontecimento
/v1/vedic/muhurat/marriage	50	Casamento (momento do saptapadi)
/v1/vedic/muhurat/naming-ceremony	50	Namakaran (atribuição do nome à criança)
/v1/vedic/muhurat/name-change	50	Mudança de nome
/v1/vedic/muhurat/property-purchase	50	Compra de imóvel
/v1/vedic/muhurat/vehicle-purchase	50	Compra de automóvel
/v1/vedic/muhurat/business-start	50	Início de negócio
/v1/vedic/muhurat/investment	50	Investimento
/v1/vedic/muhurat/education-start	50	Vidyarambh: início dos estudos
/v1/vedic/muhurat/travel	50	Viagem
/v1/vedic/muhurat/journey-long	50	Viagem longa
/v1/vedic/muhurat/surgery	50	Cirurgia
/v1/vedic/muhurat/general-auspicious	50	Dias favoráveis universais

Exemplo

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

Exemplo de resposta (marriage, encurtada a um só dia):

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

Precisão e fontes

• Textos canónicos: Muhurta Chintamani (Ramadayalu Bhattacharya, ~1600) e Muhurta Martand (Narayana, séc. XVII). Compêndios modernos: B.V. Raman, Muhurta or Electional Astrology; K.K. Pathak, Brihat Muhurta Bhusana.
• Fatores do panchang: calculados pelo nosso próprio motor de panchang (/v1/vedic/panchang/*), a mesma fonte de verdade.
• Varrimento da janela: o algoritmo percorre [search_window_start, search_window_end] dia a dia, avalia cada dia pelo seu panchang (escala de cerca de -10 a +10: >= 7 excellent, >= 4 good, >= 0 average, >= -3 poor, abaixo disso avoid) e devolve os topN melhores, ordenados por score. Dentro de cada dia é devolvida a janela do Abhijit Muhurat; slots individuais de 15 minutos não são calculados.
• Escolhas algorítmicas: algumas regras (sobretudo para surgery, court-case) vêm de escolas regionais restritas. Na documentação escrevemos que variante escolhemos e porquê.
• Estado: marriage, vehicle-purchase, griha-pravesh, travel, business-start são GREEN (verificados de forma cruzada com o Drik Panchang e o ProKerala). surgery, court-case, naming-ceremony, investment, property-purchase, education-start, engagement são sobretudo YELLOW (escolas de fonte única). Detalhe completo em docs/AUDIT-TRAIL.md.

Relacionado

Compatibilidade Comparação de mapas antes do casamento + Manglik

Yogas Raja, Dhana, Mahapurusha: combinações

Doshas Manglik, Kala Sarp, Pitru: aflições

Custo Créditos de cada endpoint

Precisão Como verificamos os cálculos

Autenticação X-Api-Key, chaves de teste