Back to Docs

Panchang (Daily Almanac)

POST/api/v1/vedic/panchang

Get the complete Hindu daily almanac (Panchang) for any date and location. Includes Tithi, Nakshatra, Yoga, Karana, Rahu Kalam, sunrise/sunset times, and auspicious muhurtas.

Full URL

https://astro-api-1qnc.onrender.com/api/v1/vedic/panchang

The Five Elements of Panchang

Tithi

Lunar day (30 per month)

Nakshatra

Lunar mansion (27 stars)

Yoga

Lunisolar combination (27 types)

Karana

Half-tithi (11 types)

Vara

Weekday and its planetary lord

Request Parameters

ParameterTypeRequiredDescription
yearintegerYesYear (e.g., 2024)
monthintegerYesMonth (1-12)
dayintegerYesDay (1-31)
hourintegerNoHour (0-23). Default: 12 (noon)
minuteintegerNoMinute (0-59). Default: 0
latfloatYesLatitude of location (-90 to 90)
lngfloatYesLongitude of location (-180 to 180)
citystringNoCity name (for display purposes)
tz_strstringNoTimezone string. Use 'AUTO' for automatic detection.

Inauspicious Periods (Included)

Rahu Kalam:

Ruled by Rahu. Avoid new beginnings.

Yamagandam:

Ruled by Saturn. Avoid journeys.

Gulika Kalam:

Avoid important activities.

Sample Code

import requests
import json

url = "https://astro-api-1qnc.onrender.com/api/v1/vedic/panchang"

payload = {
    "year": 2024,
    "month": 1,
    "day": 15,
    "hour": 6,
    "minute": 0,
    "city": "Mumbai",
    "lat": 19.0760,
    "lng": 72.8777,
    "tz_str": "Asia/Kolkata"
}

headers = {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Response Data

{
  "tithi": {
    "number": 5,
    "name": "Shukla Panchami",
    "paksha": "Shukla",
    "lord": "Saturn",
    "percent_remaining": 45.2,
    "end_time": "14:32"
  },
  "nakshatra": {
    "id": 22,
    "name": "Shravana",
    "lord": "Moon",
    "pada": 2,
    "percent_remaining": 67.8,
    "end_time": "18:45"
  },
  "yoga": {
    "number": 12,
    "name": "Dhruva",
    "description": "Fixed, stable yoga - good for long-term endeavors",
    "percent_remaining": 23.1
  },
  "karana": {
    "number": 9,
    "name": "Balava",
    "type": "Movable",
    "percent_remaining": 89.5
  },
  "weekday": {
    "name": "Monday",
    "lord": "Moon",
    "sanskrit": "Somavar"
  },
  "rahu_kalam": {
    "start": "08:15",
    "end": "09:45"
  },
  "gulika_kalam": {
    "start": "13:30",
    "end": "15:00"
  },
  "yamagandam": {
    "start": "11:00",
    "end": "12:30"
  },
  "abhijit_muhurta": {
    "start": "11:45",
    "end": "12:30",
    "available": true
  },
  "sunrise": "07:12",
  "sunset": "18:05",
  "moonrise": "10:23",
  "moonset": "22:47",
  "sun_sign": {
    "name": "Capricorn",
    "degree": 0.5
  },
  "moon_sign": {
    "name": "Capricorn",
    "degree": 14.2
  },
  "metadata": {
    "timezone": "Asia/Kolkata",
    "location": "Mumbai"
  }
}

Related Endpoints