Muhurta API - Auswahl günstiger Daten für vedische Elektrivität (Astronomie)

Last updated 7. Nov. 2026 Als Markdown öffnen Agenten-Setup

Muhurta ist die vedische elektive Astrologie: die Wahl eines günstigen Zeitpunkts für ein wichtiges Ereignis. Die API scannt jeden Tag in deinem Suchfenster, bewertet ihn anhand der Panchanga zum Sonnenaufgang (Tithi · Vara · Nakshatra · Yoga · Karana) für eine bestimmte Aktivität und gibt die Top-N der besten Tage mit Erläuterung zurück.

Wie es funktioniert

Wähle die Aktivität (eine von 12: Liste über /muhurta/types), das Suchfenster (bis zu 90 Tage) und den Standort (Sonnenaufgang ist an Koordinaten gebunden).
Die API berechnet die Panchanga zum Sonnenaufgang für jeden Tag und bewertet ihn nach den klassischen Aktivitätsregeln (Muhurta Chintamani + B.V. Raman).
Antwort: Top-N Tage, sortiert nach score, mit Panchanga, dem Unterfenster Abhijit Muhurat und Bewertungsfaktoren (why).

Endpunkte

Endpunkt	Methode	Kredite	Zweck
`/v1/muhurta/types`	GET	0	Katalog von 12 Aktivitäten (Schlüssel + Sanskrit + Beschreibung)
`/v1/vedic/muhurat/{activity}`	POST	Tier 3	Scan des Fensters für eine Aktivität → Top-N Tage (JSON)
`/v1/reports/muhurta`	POST	Tier 7	Fertiger Bericht über günstige Daten - PDF (Standard), HTML oder Markdown (`format`)

12 Aktivitäten

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.

Bericht

POST /v1/reports/muhurta gibt einen Standard-A4-Bericht auf die gleiche Weise zurück wie die anderen /v1/reports/* - ein synchrones Rendering in der Antwort: PDF als Standard, format: "html" liefert eigenständiges HTML, format: "markdown" dasselbe Dokument in Markdown, beides ohne Speicherung. Top-Empfehlung, eine Rangliste der Tage, die Panchanga jedes Tages, Abhijit Muhurat und Bewertungsfaktoren als Begründung. Unterstützt White-Label (Logo/Farben/Schriftart) für Schlüssel, die mit einem Konto verknüpft sind.

Beispiel

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