Extended Planetary Positions API

Extended Planetary Positions

This endpoint returns a comprehensive, extended set of astronomical and Vedic astrological data for all major planets at a specified date, time, and geographic location. Compared to a standard planetary positions endpoint, the "extended" variant enriches each planet's entry with deeper classical Vedic attributes — providing a richer dataset suitable for detailed chart analysis, interpretation engines, and full-featured Jyotish applications.

What This API Returns

For each planet — Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, and the Ascendant (Lagna) — the response provides the full set of standard positional data plus extended Vedic attributes, which typically include:

• Degree positions — absolute ecliptic degree (full_degree) and degree within the current zodiac sign (norm_degree), in both decimal and formatted (degrees:minutes:seconds) notation.

• Zodiac sign placement — the sign the planet occupies, with Western and Hindu/Vedic names, ruling lord, and associated element (Fire, Earth, Air, Water).

• House placement — the astrological house (1–12) the planet occupies, calculated relative to the Ascendant for the given moment and location.

• Nakshatra (lunar mansion) — the nakshatra the planet is placed in, along with its presiding deity, ruling planet (lord), and pada (quarter, 1–4).

• Planetary motion — current speed and retrograde status.

• Avastha (planetary state) — classical Vedic dignity indicators including Bal Avastha (age-based state: Bala, Kumar, Yuva, Vridha, Mrit) and Jagrat Avastha (consciousness state: Jagrat, Swapan, Supust).

• Extended attributes — additional classical Vedic data points beyond the standard response, which may include dignity/debility status, planetary relationships, shadbala components, or other expanded interpretive metadata depending on the API version.

Main Use Cases

• Full Vedic chart generation — producing a complete Jyotish birth chart or transit chart with all the extended attributes needed for in-depth interpretation, without requiring multiple API calls.

• Astrological interpretation engines — powering automated or AI-assisted chart reading systems that require rich per-planet metadata (dignities, states, relationships) to generate meaningful insights.

• Detailed Panchang and almanac tools — building daily or event-based almanacs that go beyond basic planetary positions to include classical Vedic qualitative assessments.

• Muhurta and electional astrology — evaluating the extended strength and condition of planets for selecting auspicious timings for important events.

• Research and data analysis — providing a structured, machine-readable extended dataset for statistical or algorithmic research into Vedic astrology patterns.

• Astrology dashboards and apps — serving as the primary data source for feature-rich Jyotish applications that display comprehensive planet cards with full classical attributes.

Key Functionality

• Extended Vedic metadata per planet — each planet entry goes beyond basic position data to include the full suite of classical Vedic attributes, making this endpoint the most data-rich planetary positions call in the API.

• Precise time and location input — positions are calculated for the exact date, time (hour, minute, second), and geographic coordinates (latitude, longitude) supplied in the request body, supporting any location worldwide.

• Ayanamsha support — the sidereal coordinate system is controlled via the X-Ayanamsha header, allowing selection of different ayanamsha systems (e.g., Lahiri, Raman, KP) to match the practitioner's tradition.

• Ascendant (Lagna) included — the rising sign is returned as part of the planet list, enabling immediate house-system construction from a single response.

• Retrograde detection — each planet entry explicitly flags retrograde status, a critical factor in Vedic interpretation.

• Timezone-aware calculation — the tzone parameter ensures positions are computed for the correct local moment anywhere in the world.

• Localization-ready — the Accept-Language header allows the API to return names and labels in the requested language, supporting multilingual Vedic astrology interfaces.