Adding Vedic Astrology Features to Your App: A Developer's Guide

Amrita Singh — Thu, 23 Apr 2026 11:17:42 +0000

If you're building anything for the Indian market, or for the Indian diaspora, there's a category of features users expect that most Western-focused dev tutorials skip entirely: Vedic astrology. Daily horoscopes, kundali generation, panchang for muhurat picking, kundali matching for matrimony products. None of this needs a custom calculation engine. We've packaged it all into REST endpoints under DivineAPI, and this post walks through how to wire the most-used ones into a Python app in a single sitting.
Here's what we'll build by the end:
A function that returns a full Vedic birth-chart summary (sun sign, moon sign, nakshatra, tithi, ascendant, varna, gana, nadi) from birth data
A function that returns daily Panchang (tithi, nakshatra, yoga, karana, sunrise, sunset) for any date and location
Pointers to where you go next for KP, Jaimini, Dasha, and Matching
What's actually available
DivineAPI ships 90+ Vedic endpoints organised into four buckets, all under one API key:
Kundli API (40 endpoints): birth-chart computation, divisional charts (D1 through D60), Vimshottari and other dashas, Ashtakvarga, doshas, yogas, KP and Jaimini systems, gemstone suggestions
Daily Panchang (28 endpoints): tithi, nakshatra, yoga, karana, choghadiya, auspicious and inauspicious timings, sunrise/sunset, planetary transits
Festival API (15 endpoints): Hindu calendar, festival lookups, date-specific events
Match Making (8 endpoints): Ashtakoot Milan (36-point Guna Milan), Dashakoot Milan, Manglik Dosha, Nav Pancham Yoga
It's part of a larger stack of 225 endpoints across 8 spiritual domains, but for this tutorial we're staying inside the Vedic side.
Prerequisites
pip install requests

You'll need two things from your DivineAPI dashboard:
API key (goes in the request body as api_key)
API access token (goes in the Authorization header as Bearer {token})
Both are mandatory. You can grab them from the Profile Details page after signing up. There's a 14-day free trial; you'll need a credit card to register.
Step 1: Get a Vedic birth chart summary
The fastest way to get a useful Vedic profile is the Basic Astro Details endpoint. One POST and you get sun sign, moon sign, ascendant data, nakshatra, tithi at birth, varna, vashya, yoni, gana, nadi, and more. This is what most matrimony, dating, and wellness apps use to seed a user profile.
import requests

URL = "https://astroapi-3.divineapi.com/indian-api/v3/basic-astro-details"
HEADERS = {"Authorization": "Bearer YOUR_AUTH_TOKEN"}

payload = {
"api_key": "YOUR_API_KEY",
"full_name": "Rahul Kumar",
"day": 24,
"month": 5,
"year": 1998,
"hour": 14, # 24-hour format
"min": 40,
"sec": 43,
"gender": "male",
"place": "New Delhi",
"lat": 28.7041,
"lon": 77.1025,
"tzone": 5.5, # IST. Float, not int, not string
"lan": "en" # optional. en/hi/bn/ma/tm/tl/ml/kn
}

response = requests.post(URL, headers=HEADERS, json=payload)
data = response.json()["data"]

print(f"{data['full_name']} is a {data['sunsign']} sun, {data['moonsign']} moon")
print(f"Born under {data['nakshatra']} nakshatra, in {data['tithi']} tithi, {data['paksha']} paksha")
print(f"Varna: {data['varna']}, Gana: {data['gana']}, Nadi: {data['nadi']}")

What comes back, trimmed for readability:
{
"success": 1,
"data": {
"full_name": "Rahul Kumar",
"place": "New Delhi",
"latitude": "28.7041",
"longitude": "77.1025",
"timezone": "5.5",
"sunrise": "1998-05-24 05:25:56",
"sunset": "1998-05-24 19:10:28",
"sunsign": "Taurus",
"moonsign": "Gemini",
"nakshatra": "Aradra",
"tithi": "Chaturdashi",
"paksha": "Krishna",
"vaar": "Sunday",
"yoga": "Harshana",
"karana": "Vishti",
"varna": "Shudra",
"vashya": "Biped",
"yoni": "Shwan",
"gana": "Manushya",
"nadi": "Adi",
"tatva": "Airy",
"rashi_akshar": "का, की, कू, घ, ङ, छ, के, को, ह",
"ayanamsha": "24.298085"
}
}

A few things worth knowing:
Timezone is a Float, not a string. 5.5 for IST. Sending "5.5" or "Asia/Kolkata" will silently produce wrong dates. Cast at the boundary if you're reading from a form.
Birth time fields are separate integers. day, month, year, hour, min, sec. Not a single ISO string. The API doesn't parse ISO; you have to break it apart.
rashi_akshar returns the Hindi syllables traditionally used to start a name based on moonsign nakshatra. Useful for any Indian-baby-name or matrimony profile feature.
lan parameter switches the response language. Supported: en (English), hi (Hindi), bn (Bengali), ma (Marathi), tm (Tamil), tl (Telugu), ml (Malayalam), kn (Kannada). Default is English.
That's a complete Vedic birth-chart starter in one call.
Step 2: Get daily Panchang (Tithi, Nakshatra, Yoga, Karana)
Panchang is the Hindu calendar at the day-and-place level. It's what muhurat-picking apps, daily astrology widgets, and festival-aware products consume. The Find Panchang endpoint returns all five panchanga elements (tithi, nakshatra, yoga, karana, vaar) plus sunrise, sunset, and related calendar data in one call.
import requests

URL = "https://astroapi-1.divineapi.com/indian-api/v2/find-panchang"
HEADERS = {"Authorization": "Bearer YOUR_AUTH_TOKEN"}

payload = {
"api_key": "YOUR_API_KEY",
"day": 24,
"month": 5,
"year": 2026,
"place": "New Delhi",
"lat": 28.6139,
"lon": 77.2090,
"tzone": 5.5,
"lan": "en"
}

response = requests.post(URL, headers=HEADERS, json=payload)
panchang = response.json()["data"]

print(f"Tithi: {panchang['tithis'][0]['tithi']} ({panchang['tithis'][0]['paksha']})")
print(f"Nakshatra: {panchang['nakshatras']['nakshatra_pada'][0]['nak_name']}")
print(f"Yoga: {panchang['yogas'][0]['yoga_name']}")
print(f"Karana: {panchang['karnas'][0]['karana_name']}")
print(f"Sunrise: {panchang['sunrise']}, Sunset: {panchang['sunset']}")

Each element returns as an array because tithi, nakshatra, yoga, and karana can change during a single day. The response gives you the active windows with start and end times so you can render "current" or "upcoming" views correctly.
If you only need one element (just tithi for a calendar widget, just nakshatra for an astrology card), there are dedicated single-purpose endpoints too:
POST /indian-api/v1/find-tithi
POST /indian-api/v2/find-nakshatra
POST /indian-api/v2/find-yoga
POST /indian-api/v1/find-karana
Same auth, same date+location params. Skinnier responses, slightly faster.
Going deeper: KP and Jaimini
If your product targets users who care about specific Vedic systems beyond standard parashari astrology, both KP (Krishnamurti Paddhati) and Jaimini are first-class:
KP astrology endpoints (5):
KP Planetary Positions (/indian-api/v2/kp/planetary-positions)
KP Cuspal (/indian-api/v2/kp/cuspal)
KP Planetary Sub
KP Cuspal Sub
KP Planetary and Cuspal Significator Table
Jaimini astrology endpoints (4):
Jaimini Planetary Positions (/indian-api/v2/jaimini-astrology/planetary-positions)
Jaimini Chara Dasha
Jaimini Karakamsha Lagna
Jaimini Padas
Same authentication pattern. Same day/month/year/hour/min/sec/lat/lon/tzone request body. KP and Jaimini are not afterthoughts in this API; they're built in alongside parashari from the start.
Going further
Three other endpoint families worth knowing about for a serious Vedic feature build:
Vimshottari Dasha endpoints under Kundli API for the major and minor planetary periods (Maha, Antar, Pratyantar, plus prana-dasha and deha-dasha for sub-sub periods)
Match Making endpoints (Ashtakoot Milan, Dashakoot Milan, Manglik Dosha) if you're building anything matrimony-adjacent
Festival API for date-specific Hindu calendar events, useful for content sites and notification triggers
All run on Swiss Ephemeris under the hood, which is the same NASA JPL-derived calculation engine most serious astrology software is built on. The math is precise to sub-milliarcsecond accuracy, so you don't have to defend your output against a family astrologer's hand calculations.
Wrapping up
Two endpoints. Maybe 30 lines of Python. That's the foundation for a working Vedic astrology feature in a web app: birth-chart summaries on user profile creation, daily Panchang on a dashboard or calendar widget. From here you can stack matching, dasha analysis, KP, Jaimini, or panchang-based muhurat suggestions without changing API providers.
Full docs at developers.divineapi.com, with the live "Run In Postman" button on every endpoint page so you can poke at the request and response before writing any code. 14-day free trial at divineapi.com.
If you ship something with this, drop a comment, always curious to see what people end up building.

Forem: Amrita Singh

Adding Vedic Astrology Features to Your App: A Developer's Guide