Skip to main content

Panchanga

asterwise_get_panchanga

Panchanga for one date at a location: the limbs at sunrise plus the whole panchanga day (sunrise to next sunrise) with every tithi, nakshatra, yoga and karana active in it, each with ISO start and end times and kshaya/vriddhi flags; 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. Fields: date, lat, lon*, 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.