Skip to main content

Panchanga

asterwise_get_panchanga

Panchanga for one date at a location: the limbs at sunrise plus every tithi, nakshatra, yoga and karana of the panchanga day (sunrise to next sunrise). Each comes with ISO start and end times and kshaya/vriddhi flags. Also returns sunrise, sunset, moonrise and moonset; Sun and Moon rashi; lunar month (amanta and purnimanta, with Adhik months); Vikram, Shaka and Gujarati samvat; ritu and ayana; and the day's timings (Rahu Kaal, Gulika, Yamaganda, Abhijit, Brahma Muhurta, Durmuhurta, Varjyam, Amrit Kaal, Bhadra with residence, Panchaka, Pradosh, Nishita).

Parameters​

ParameterTypeRequiredDescription
locationobjectyesFor tools that need location but not birth time. Required fields: date, lat, lon. Optional fields: timezone, response_format.

What it covers​

The top-level tithi, vara, nakshatra, yoga and karana are the limbs at sunrise. A tithi that starts after sunrise and ends before the next one (kshaya) appears in data.tithis flagged is_kshaya; a tithi that holds two sunrises is flagged is_vriddhi on both days. Times are ISO 8601 local time with offset. data.yoga is the Panchanga Yoga (Sun+Moon), unrelated to natal yogas.

Workflow​

BEFORE: asterwise_geocode — when you only have a place name.
AFTER: asterwise_get_muhurta — to find auspicious windows across a date range; asterwise_get_festival_calendar — for the festivals and vrats of the year.

Input​

location.date is YYYY-MM-DD; location.lat, location.lon and location.timezone (IANA) give the place. Dates 1800-2099.

Output contract​

data.tithi, data.vara, data.nakshatra, data.yoga, data.karana: limbs at sunrise (end_time in UTC).
data.date, data.sunrise, data.sunset, data.next_sunrise, data.moonrise (null if none), data.moonset (null if none): ISO local.
data.tithis[], data.nakshatras[] (with padas[]), data.yogas[], data.karanas[]: number/index, name, start, end, at_sunrise, is_kshaya, is_vriddhi.
data.sun_rashi[], data.moon_rashi[], data.sun_nakshatra[]: name, start, end.
data.paksha; data.masa.amanta / data.masa.purnimanta: name, display_name, is_adhik.
data.samvat: vikram, shaka, gujarati, samvatsara. data.ritu: vedic, drik. data.ayana: vedic, drik.
data.timings: brahma_muhurta, pratah_sandhya, abhijit (null on Wednesday), vijaya_muhurta, godhuli_muhurta, sayahna_sandhya, nishita_muhurta, madhyahna, pradosh, rahu_kaal, gulika_kaal, yamaganda_kaal, durmuhurta[], varjyam[], amrit_kaal[], bhadra[] (residence), panchaka[], day_parts.

Errors​

INVALID_PARAMS (local): bad date or coordinates. INTERNAL_ERROR: upstream failure, including polar dates without sunrise.

Do not confuse with​

asterwise_get_yogas — natal chart yogas, not the Panchanga Sun–Moon yoga.
asterwise_get_panchanga_calendar — one row per day for a whole month.
asterwise_get_tamil_panchanga — Tamil month and Rahu Kalam/Yamagandam/Kuligai only.

Connect​

Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.