API Muhurta - Selección de fechas favorables (astrología electiva vedica)

Last updated 7 nov 2026 Ver como Markdown Configuración del agente

Muhurta es la astrología electiva védica: la elección del momento propicio para un evento importante. La API escanea cada día en tu ventana de búsqueda, lo evalúa según el Panchanga al amanecer (Tithi · Vara · Nakshatra · Yoga · Karana) para una actividad específica y devuelve los N mejores días con una explicación.

Cómo funciona

Elige la actividad (una de 12: lista a través de /muhurta/types), la ventana de búsqueda (hasta 90 días) y la ubicación (el amanecer está vinculado a las coordenadas)
La API calcula el Panchanga al amanecer para cada día y lo evalúa según las reglas clásicas de la actividad (Muhurta Chintamani + B.V. Raman)
Respuesta: los N mejores días, ordenados por puntuación, con el Panchanga, la subventana de Abhijit Muhurat y los factores de evaluación (why)

Endpoints

Endpoint	Método	Créditos	Propósito
`/v1/muhurta/types`	GET	0	Catálogo de 12 actividades (clave + sánscrito + descripción)
`/v1/vedic/muhurat/{activity}`	POST	Tier 3	Escaneo de ventana para una actividad → N mejores días (JSON)
`/v1/reports/muhurta`	POST	Tier 7	Informe listo de fechas propicias - PDF (por defecto), HTML o Markdown (`format`)

12 actividades

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.

Informe

POST /v1/reports/muhurta devuelve un informe A4 estándar de la misma manera que el resto de /v1/reports/* - renderizado síncrono en la respuesta: PDF por defecto, format: "html" devuelve un HTML autocontenido, format: "markdown" el mismo documento en Markdown, ambos sin almacenamiento. La recomendación principal, una lista clasificada de días, el Panchanga de cada día, Abhijit Muhurat y los factores de evaluación como justificación. Soporta marca blanca (logotipo/colores/fuente) para claves vinculadas a la cuenta.

Ejemplo

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