POST /v1/muhurta · 10 credits
Auspicious windows (muhūrta) in a date range
Scans each day in the range and ranks windows for the subject. The pañcāṅga is computed for `eventPlace`, never defaulted to the birthplace.
Request (works as-is with a sandbox key):
curl -X POST https://www.astronest.ai/api/developer/v1/muhurta \
-H "Authorization: Bearer astro_sandbox_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"subject":{"date":"1990-05-12","time":"14:35","timezone":"Asia/Kolkata","latitude":28.6139,"longitude":77.209},"eventPlace":{"latitude":19.076,"longitude":72.8777,"timezone":"Asia/Kolkata","label":"Mumbai"},"freeText":"signing a lease","rangeStart":"2026-11-01","rangeEnd":"2026-11-15"}'Response (sandbox sample, long lists shortened):
{
"requestId": "sandbox",
"engineVersion": "astro-nest-v1-public",
"timestamp": "2026-10-06T17:05:00.693Z",
"domain": "muhurta",
"usage": {
"units_charged": 0,
"remaining_credits": 0
},
"disclaimer": "Symbolic interpretation only. Not medical, legal, financial, or psychological advice.",
"muhurta": {
"event": {
"id": "legal",
"label": "Legal signing",
"hint": "Contracts, filings, a court submission",
"matchedFromText": true,
"freeText": "signing a lease"
},
"eventPlaceLabel": "Mumbai",
"rangeStart": "2026-11-01",
"rangeEnd": "2026-11-15",
"daysEvaluated": 15,
"windows": {
"bestSuitability": "good",
"suitabilityDistribution": {
"excellent": 0,
"good": 2,
"neutral": 2,
"poor": 3,
"avoid": 8
},
"avoidDates": [
"2026-11-01",
"2026-11-02",
"2026-11-05",
"… 5 more"
],
"topWindows": [
{
"rank": 1,
"date": "2026-11-15",
"suitability": "good",
"strengthSummary": "Sun hora (neutral) · bird Ruling · Tara Kshema · Chandra Bala strong",
"keyPositives": [
"Birth bird Vulture in Ruling activity (score 5/5).",
"Tara Kshema — favorable.",
"Transit Moon Chandra Bala: strong."
],
"keyNegatives": [
"Weekday is unfavorable for this event type.",
"Sun dasha does not support legal."
],
"factors": [],
"avoidReasons": [],
"recommendations": [
"Adjusting the weekday may significantly improve the electional quality."
],
"hora": "{…}",
"tara": "{…}",
"chandraBala": "strong",
"panchapakshi": "{…}",
"combustWarning": false
},
{
"rank": 2,
"date": "2026-11-07",
"suitability": "good",
"strengthSummary": "Saturn hora (favorable) · bird Walking · Tara Sadhana · Chandra Bala strong",
"keyPositives": [
"Tara Sadhana — favorable.",
"Saturn hora is favorable for legal.",
"Transit Moon Chandra Bala: strong."
],
"keyNegatives": [
"Mercury retrograde strongly unfavorable for this event type.",
"Sun dasha does not support legal."
],
"factors": [],
"avoidReasons": [
"Mercury is retrograde — contracts, communications, and agreements are at high risk."
],
"recommendations": [
"If proceeding, finalize all contracts beforehand and build in review time."
],
"hora": "{…}",
"tara": "{…}",
"chandraBala": "strong",
"panchapakshi": "{…}",
"combustWarning": false
},
{
"rank": 3,
"date": "2026-11-04",
"suitability": "neutral",
"strengthSummary": "Mercury hora (neutral) · bird Ruling · Tara Vipat · Chandra Bala strong",
"keyPositives": [
"Weekday is auspicious for this event type.",
"Birth bird Vulture in Ruling activity (score 5/5).",
"Transit Moon Chandra Bala: strong."
],
"keyNegatives": [
"Mercury retrograde strongly unfavorable for this event type.",
"Tara Vipat — challenging.",
"Sun dasha does not support legal."
],
"factors": [],
"avoidReasons": [
"Mercury is retrograde — contracts, communications, and agreements are at high risk."
],
"recommendations": [
"If proceeding, finalize all contracts beforehand and build in review time."
],
"hora": "{…}",
"tara": "{…}",
"chandraBala": "strong",
"panchapakshi": "{…}",
"combustWarning": false
},
"… 2 more"
]
},
"classicalSources": [
"B.V. Raman — Muhurtha",
"Muhurta Chintamani",
"Muhurta Martanda",
"… 2 more"
],
"warnings": []
}
}Every field: /v1/muhurta in the reference.
Why AstroNest
Deterministic interpretation
Interpret, guidance, compatibility and guna milan call no language model: the same chart always gets the same reading. Only forecast and timing are voiced by a model, and they are marked as such.
Muhūrta at the event's place
The pañcāṅga for a muhūrta is computed where the event happens, never defaulted to the birthplace.
Pricing
Sandbox keys are free, with no time limit, and return the samples above. A live key starts with 100 free credits; after that you buy credit packs. Each endpoint's cost in credits is shown above. Pricing
Questions
- Where is the pañcāṅga computed?
- At the event's place, which you send separately from the birthplace.
- Do I need the person's birth data?
- Yes. Windows are ranked against the chart of the person the event is for.
Readings are symbolic interpretation, not medical, legal, financial or psychological advice.
More from the API