Skip to content

Panchanga

Panchanga is the standalone daily Hindu almanac API. Unlike chart-based endpoints, it does not require a chart_id; it is computed from a civil date or moment plus location.

The implementation is based on the Drik Panchanga / Swiss Ephemeris calculation layer and returns the five angas, sunrise/sunset, Moon rise/set where available, classical caution windows, Abhijit Muhurta, Durmuhurtam, and Chogadia windows.

GET /v1/vedic/panchanga

Full daily Panchanga by civil day, coordinates, and IANA timezone.

This endpoint returns a daily report. The core five angas are evaluated using the sunrise-based Hindu day for the supplied civil day, while the daily envelope also includes whole-day windows such as Rahu Kalam, Yamaganda, Gulika, Durmuhurtam, Abhijit Muhurta, and Chogadia. Use this endpoint for calendars, day pages, and daily planning screens.

Param Type Required Notes
day YYYY-MM-DD yes Civil day in timezone.
latitude float yes -90..90.
longitude float yes -180..180.
timezone IANA string yes Example: Asia/Kolkata. 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/panchanga\
?day=2026-05-31&latitude=28.6139&longitude=77.2090&timezone=Asia/Kolkata"

The response wraps the moment-level Panchanga in a daily envelope:

{
  "day": "2026-05-31",
  "timezone": "Asia/Kolkata",
  "method_version": "panchanga-daily-v1",
  "panchanga": {
    "moment": "2026-05-31T12:00:00+05:30",
    "sunrise": "2026-05-31T00:01:00Z",
    "sunset": "2026-05-31T13:13:00Z",
    "moonrise": null,
    "moonset": null,
    "day_duration_hours": 13.2,
    "tithi": {
      "number": 15,
      "name": "Purnima",
      "paksha": "shukla",
      "ends_at": "2026-05-31T18:00:00Z",
      "skipped_to": null
    },
    "nakshatra": {"number": 5, "name": "Mrigashira", "ends_at": "…", "skipped_to": null},
    "yoga": {"number": 1, "name": "Vishkambha", "ends_at": "…", "skipped_to": null},
    "karana": {"number": 29, "name": "Bava"},
    "vaara": {"number": 0, "name": "Ravivara", "ruler": "sun"},
    "masa": {"number": 2, "name": "Vaisakha", "is_adhika": false},
    "ritu": "vasanta",
    "raasi": 2,
    "lunar_phase_deg": 178.2,
    "samvatsara": 39,
    "rahu_kalam": {"start": "…", "end": "…"},
    "yamaganda_kalam": {"start": "…", "end": "…"},
    "gulika_kalam": {"start": "…", "end": "…"},
    "abhijit_muhurta": {"start": "…", "end": "…"},
    "chogadia": ["…16 ISO timestamps"],
    "ghati_since_sunrise": 30.0,
    "vighati_since_sunrise": 0.0
  },
  "durmuhurtam": [
    {
      "name": "Durmuhurtam 4",
      "kind": "durmuhurtam",
      "start": "…",
      "end": "…",
      "polarity": "caution",
      "score": -3,
      "evidence": ["Day muhurta number 4"]
    }
  ],
  "chogadia": [
    {
      "name": "Day Amrit",
      "kind": "chogadia",
      "start": "…",
      "end": "…",
      "polarity": "auspicious",
      "score": 2,
      "evidence": ["Amrit Chogadia during day"]
    }
  ],
  "features_used": [
    {"source": "swiss_ephemeris", "version": "panchanga-drik-v1", "fields": ["sunrise", "sunset", "sun_longitude", "moon_longitude"]},
    {"source": "panchanga", "version": "panchanga-daily-v1", "fields": ["tithi", "nakshatra", "yoga", "karana", "vara", "windows"]}
  ]
}

GET /v1/vedic/panchanga/current

Moment-level Panchanga factors for a timezone-aware instant and location. Use this endpoint when the UI needs the angas active right now or at one specific timestamp. Unlike the daily report, current evaluates tithi, nakshatra, yoga, karana, raasi, and lunar phase at the exact at moment. The weekday (vaara) and weekday-derived windows still follow the local sunrise day for the requested location.

Param Type Required
at ISO datetime yes
latitude float yes
longitude float yes 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/panchanga/current\
?at=2026-05-31T12:00:00%2B05:30&latitude=28.6139&longitude=77.2090"

Returns the inner panchanga object shown above.

GET /v1/vedic/panchanga/windows

Daily auspicious, neutral, and caution windows.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/panchanga/windows\
?day=2026-05-31&latitude=28.6139&longitude=77.2090&timezone=Asia/Kolkata"

{
  "day": "2026-05-31",
  "timezone": "Asia/Kolkata",
  "method_version": "panchanga-daily-v1",
  "auspicious_windows": [
    {"name": "Abhijit Muhurta", "kind": "abhijit_muhurta", "start": "…", "end": "…", "polarity": "auspicious", "score": 3, "evidence": ["Midday Abhijit window"]}
  ],
  "caution_windows": [
    {"name": "Rahu Kalam", "kind": "rahu_kalam", "start": "…", "end": "…", "polarity": "caution", "score": -3, "evidence": ["Traditional daily caution window"]}
  ],
  "neutral_windows": []
}