API Muhurta - Seleção de Datas Favoráveis (Astronomia Védica)

Last updated 7 de nov. de 2026 Ver como Markdown Configuração do agente

Muhurta é a astrologia eletiva védica: a escolha do momento auspicioso para um evento importante. A API analisa cada dia na sua janela de pesquisa, avalia-o com base no Panchanga para o nascer do sol (Tithi · Vara · Nakshatra · Yoga · Karana) para uma atividade específica e retorna os top-N melhores dias com explicação.

Como funciona

Escolha a atividade (uma das 12: lista através de /muhurta/types), a janela de pesquisa (até 90 dias) e a localização (o nascer do sol está vinculado às coordenadas)
A API calcula o Panchanga para o nascer do sol de cada dia e avalia-o de acordo com as regras clássicas da atividade (Muhurta Chintamani + B.V. Raman)
Resposta: top-N dias, ordenados por pontuação, com Panchanga, janela Abhijit Muhurat e fatores de avaliação (why)

Endpoints

Endpoint	Método	Créditos	Finalidade
`/v1/muhurta/types`	GET	0	Catálogo de 12 atividades (chave + sânscrito + descrição)
`/v1/vedic/muhurat/{activity}`	POST	Tier 3	Escaneamento da janela para uma atividade → top-N dias (JSON)
`/v1/reports/muhurta`	POST	Tier 7	Relatório pronto de datas auspiciosas - PDF (padrão), HTML ou Markdown (`format`)

12 atividades

marriage (Vivah) · vehicle-purchase (Vahana) · business-start (Vyapara) · travel (Yatra) · naming-ceremony (Namkaran) · surgery (Shastrakarma) · education-start (Vidyarambha) · investment (Dhana Sthapana) · property-purchase (Griha Pravesh) · journey-long · name-change · general-auspicious.

Relatório

POST /v1/reports/muhurta retorna um relatório padrão A4 da mesma forma que o resto dos /v1/reports/* - renderização síncrona na resposta: PDF por padrão, format: "html" retorna HTML autossuficiente, format: "markdown" retorna o mesmo documento em Markdown, ambos sem armazenamento. Recomendação principal, lista classificada de dias, Panchanga de cada dia, Abhijit Muhurat e fatores de avaliação como justificativa. Suporta white-label (logotipo/cores/fonte) para chaves vinculadas à conta.

Exemplo

curl -X POST https://api.astroway.info/v1/reports/muhurta \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "activity": "marriage", "search_window_start": "2026-07-01",
        "search_window_end": "2026-07-31", "latitude": 28.61,
        "longitude": 77.21, "timezoneOffset": 5.5, "topN": 5 }'
# → { "url": "https://api.astroway.info/reports/…-muhurta.pdf", "page_count": 3, "expires_at": "…" }
# (format "html" or "markdown" returns the document itself)

Dating & Compatibility