Astrology API
The astrology API for Vedic, Hindu calendar and Western apps.
LifeAstroAPI is a REST API for Vedic astrology and the Hindu calendar: panchang, festivals and vrats, kundli, dasha, kundli matching, muhurat, horoscopes, numerology, tarot and Western astrology.
- 311 REST endpoints under one API key, including 12 composed JSON and PDF report endpoints.
- Festival and vrat dates verified entry for entry against the printed panchang calendars of 14 cities on four continents (4,427 of 4,427 entries).
- Computed with the Swiss Ephemeris; Lahiri ayanamsa by default, other ayanamsas on request.
- Astronomy checked against NASA JPL Horizons and NASA eclipse data with a published, rerunnable script: planet positions median 0.05 arc-seconds, sunrise/sunset/moonrise within 10 seconds, all 44 eclipses of 2021–2030 found with the same type (lifeastroapi.com/accuracy/#astronomy).
- Location-aware: every calculation takes latitude, longitude and an IANA timezone, so results are correct outside India too.
- Narratives and names in 10+ languages, including Hindi and regional Indian languages.
- Open-source MCP server with 310 tools for Claude Desktop, Cursor, Codex and other MCP clients: github.com/ayanshulife/lifeastroapi-mcp.
- Official Node.js / TypeScript SDK on npm: `npm install lifeastroapi` (source: github.com/ayanshulife/lifeastroapi-node).
- Free tier: 1,500 credits a month, no card required. Paid plans from ₹999 / $29 a month; pay-as-you-go also available.
What an astrology API does
An astrology API turns a date, time and place into astrological data your software can use: the position of each planet, the ascendant and houses of a birth chart, the day's panchang, the dates of festivals and vrats, a compatibility score for two charts, or the best muhurat in a date range. You send an HTTPS request with your API key; you get JSON back. No ephemeris files to manage, no almanac tables to transcribe, no timezone arithmetic to get wrong.
LifeAstroAPI is one API for both traditions. The Vedic side (also searched for as a Jyotish API, Hindu astrology API or Indian astrology API) covers panchang, kundli, dasha, matching, muhurat and the full Hindu festival calendar. The Western side covers natal charts, synastry, transits, returns and 23 house systems. Both run on the Swiss Ephemeris, so positions agree with NASA JPL Horizons to a fraction of an arc-second (measured and published).
What is covered
| Area | Endpoints give you |
|---|---|
| Panchang | Tithi, nakshatra, yoga, karana with end times; sunrise, moonrise, Rahu Kaal, Choghadiya, Hora, Abhijit |
| Hindu calendar & festivals | Every festival, Ekadashi with parana, Pradosh, Sankashti, Purnima, Amavasya, Sankranti, eclipses, for any city |
| Kundli (birth chart) | Planets, lagna, houses, D1–D60 divisional charts, Shadbala, Ashtakavarga, yogas, doshas |
| Dasha & transits | Vimshottari to the prana level, Yogini, Char dasha, Sade Sati, tarabala, planet ingress and retrograde moments |
| Kundli matching | Ashtakoota with every koota, Mangal dosha, Nadi dosha, Navamsa compatibility |
| Muhurat | Best-time scan for vivah, graha pravesh and naamkaran; chandra bala, tara bala, panchaka |
| Horoscopes & narratives | Daily, weekly and monthly horoscopes; authored readings in 10+ languages |
| Numerology & tarot | Chaldean and Pythagorean numbers, personal periods, all 78 tarot cards |
| Western astrology | Natal, synastry, composite, transits, returns, progressions, Hellenistic lots, 23 house systems, asteroids |
Your first call
Every endpoint takes a date, a timezone and, where the result depends on the place, a latitude and longitude. This returns the day's panchang for Delhi:
curl "https://api.lifeastroapi.com/v1/panchang/basic?date=2027-01-15&tz=Asia/Kolkata&lat=28.6139&lon=77.209" \
-H "Authorization: Bearer YOUR_API_KEY"The quickstart walks through signup to first response in five minutes. Every page of the API reference shows a request that was run against the API and the real response it returned.
How to choose an astrology API
- Location-aware results. Tithi, sunrise and festival dates change with latitude, longitude and timezone. An API that assumes one city gives diaspora users the wrong day.
- Verified accuracy you can rerun. Ask for the comparison against an independent reference, not just the name of the ephemeris.
- Real response examples in the docs, so you know the field names before you write code.
- A free tier large enough to build a prototype, and pricing that scales with calls, not seats.
- Narratives written by people in the languages your users read, if you show readings and not just numbers.
- A way for AI assistants to call it (an MCP server or tool definitions) if you are building an agent.
What makes the calculations different
Real-time panchang and muhurta
Every panchang element with its exact start and end time, and muhurta scored for the exact minute you ask about, not one value per day.
Hindu calendar, festivals and vrat
335 festival rules, about 720 dated observances per city per year, 19 vrat families, each decided at the moment its classical rule demands.
Choose an API
Vedic Astrology API
A Vedic astrology (Jyotish) API for developers: panchang, Hindu festival calendar, kundli, dashas, transits, kundli matching, muhurat, horoscopes, Varshaphal, Prashna, Lal Kitab, remedies and PDF reports, with narratives in 10+ languages.
Panchang API
A REST API for the daily Hindu panchang: tithi, nakshatra, yoga, karana and vara with exact end times, sunrise, moonrise, Rahu Kaal, Choghadiya, Hora, Abhijit and Brahma Muhurat, for any place and date.
Hindu Calendar & Festival API
A Hindu festival and vrat calendar API: every festival, Ekadashi with parana, Pradosh, Sankashti, Purnima, Amavasya, Sankranti, Shraddha and eclipse for any city and year, verified against printed panchangs of 14 cities.
Kundli API
A Kundli (Vedic birth chart) API: planet positions, lagna, houses, divisional charts D1–D60, Vimshottari and other dashas, Ashtakavarga, Shadbala, yogas, transits and Sade Sati from a birth date, time and place.
Kundli Matching API
A Kundli matching (Guna Milan) API: the 36-point Ashtakoota score with all eight kootas, Mangal, Nadi and Shani Dosha with cancellation rules, Navamsa compatibility and dasha synchronisation from two birth details.
Horoscope API
A Vedic horoscope API: daily, weekly and monthly rashifal for all 12 Moon signs, plus personalised predictions from a birth chart, written in 10+ languages.
Muhurat API
A Muhurat API that scores and finds auspicious times for weddings, griha pravesh, naming, business openings and travel, using tithi, nakshatra, yoga, Tara Bala, Chandra Bala and Panchaka.
Numerology API
A numerology API returning driver (Mulank), conductor (Bhagyank), soul, personality and destiny numbers, personal year, challenges and lucky factors from a name and date of birth.
Tarot API
A tarot API with the full 78-card deck, upright and reversed meanings, a daily card, yes/no readings and single, three-card and Celtic Cross spreads.
Western Astrology API
A Western (tropical) astrology API: natal charts in 23 house systems, aspects, synastry, transits, progressions, Hellenistic Lots, midpoints, asteroids and astrocartography.
Frequently asked questions
Is there a free tier?
Yes. Every account gets 1,500 free credits a month with no card required. Paid plans start at ₹999 / $29 a month, and pay-as-you-go is available.
Can AI assistants such as Claude or Cursor call it directly?
Yes. The open-source LifeAstro MCP server exposes every endpoint as a tool for Claude Desktop, Cursor, Codex and other MCP clients that run local servers, using your existing API key.
Which ephemeris and ayanamsa does it use?
Planet positions come from the Swiss Ephemeris. Vedic calculations use the Lahiri (Chitrapaksha) ayanamsa by default; other ayanamsas can be selected per request.