SEARCH ASTRO INSIGHT API DOCS

What This API Does

The Ayanamsha API calculates the Ayanamsha value for a given calendar date. Ayanamsha is a foundational concept in Vedic (sidereal) astrology — it represents the angular difference between the tropical zodiac (used in Western astrology) and the sidereal zodiac (used in Vedic astrology). This difference arises due to the precession of the equinoxes, a slow westward shift of the equinoctial points along the ecliptic over time.

By providing a specific date, this API returns the precise Ayanamsha value applicable to that moment, enabling accurate conversion of tropical planetary positions into sidereal ones.

What Data It Returns

The API returns the Ayanamsha value (in degrees) corresponding to the supplied date. The response is delivered as a 200 OK with a status of "OK", containing the computed angular offset between the tropical and sidereal zodiacs for the given day, month, and year.

Main Use Cases

• Vedic Horoscope Calculation — Compute the correct sidereal positions of planets for a birth chart (Janma Kundali) by applying the Ayanamsha offset to tropical coordinates.
• Tropical-to-Sidereal Conversion — Convert planetary longitudes obtained from astronomical ephemerides (which are tropical) into sidereal positions used in Vedic astrology.
• Multi-System Ayanamsha Support — Serve astrologers from different schools of Vedic astrology by supporting multiple Ayanamsha systems (e.g., Lahiri, Raman, Krishnamurti) via the X-Ayanamsha header.
• Astrology Application Development — Power backend calculations for astrology apps, platforms, and tools that require date-specific Ayanamsha values.

Key Functionality

• Date-Based Calculation — Accepts a specific date (day, month, year) to compute the historically accurate Ayanamsha value for that point in time.
• Multiple Ayanamsha Systems — The X-Ayanamsha request header allows selection of the desired Ayanamsha system (e.g., Lahiri, Raman, Krishnamurti), making the API flexible for practitioners across different Vedic astrology traditions.
• Sidereal Zodiac Alignment — Bridges the gap between modern astronomical data (tropical) and traditional Vedic astrological frameworks (sidereal), ensuring planetary positions are correctly aligned with the fixed-star backdrop used in Jyotish.
• Lightweight Input — Requires only three date fields (day, month, year), making integration straightforward for any application performing astrological computations.