Sudarshan Chakra Chart Image API

Sudarshan Chakra Chart Image

Generates a Sudarshan Chakra astrological chart as an image, based on a person's birth details and geographic coordinates.

What this API does

The Sudarshan Chakra is a unique Vedic astrology chart that presents all three primary divisional charts — the Lagna (Ascendant) chart, the Surya (Solar) chart, and the Chandra (Lunar) chart — simultaneously in a single concentric wheel diagram. This endpoint computes the planetary positions and house placements for the given birth data and renders the complete Sudarshan Chakra as a visual image.

What data it returns

The API returns a rendered image of the Sudarshan Chakra chart. The image visually encodes:

• The three concentric chart wheels (Lagna, Surya, and Chandra)
• Zodiac signs placed in their respective houses across all three wheels
• Planetary positions distributed across the houses
• An optional Swastik symbol at the center of the chart

The visual output is fully customizable in terms of colors, sizes, fonts, and symbolic representations.

Main use cases

• Vedic astrology applications that need to display a comprehensive single-view chart combining all three primary chart perspectives
• Horoscope generation platforms producing printable or shareable birth chart images
• Astrology dashboards embedding chart visuals alongside textual interpretations
• Comparative analysis tools where practitioners study the interplay between the Lagna, Surya, and Chandra charts side by side

Key functionality

• Birth data input: Accepts day, month, year, hour, minute, second, and timezone offset to precisely calculate planetary positions at the moment of birth.
• Geographic coordinates: Uses latitude and longitude to determine the local horizon and house cusps.
• Ayanamsha support: The X-Ayanamsha header allows selection of the ayanamsha system (e.g., Lahiri, Raman, KP) used for sidereal calculations, making the API compatible with different Vedic astrology traditions.
• Chart appearance customization: Full control over the chart's visual style, including background color, inner and outer border line colors and widths, zodiac sign colors, planet colors, chart size, and font sizes for signs and planets.
• Symbol vs. name display: Signs and planets can be rendered as traditional symbols or as text labels/numbers, catering to both traditional practitioners and learners.
• Swastik overlay: Optionally renders a Swastik symbol at the chart center with configurable fill color, stroke color, and stroke width — a traditional auspicious element in Vedic chart presentations.
• Multilingual support: The Accept-Language header enables localized output for sign and planet labels.