Graha Gunak
Computes the Graha Gunak (planet multiplier) values for a person's Vedic birth chart — a classical Ashtakavarga technique that derives a weighted strength index for each of the seven classical planets by multiplying the planet's fully reduced Bhinnashtakavarga score in its occupied house by the number of bindus contributed to that house, producing a planet-level composite index used for individual planetary strength assessment.
What this API does
Graha Gunak is the planet-centric counterpart to Rasi Gunak. While Rasi Gunak evaluates the composite strength of each sign by weighting house scores against planetary occupancy, Graha Gunak focuses on the individual planets themselves — assessing how strongly each planet is placed within the Ashtakavarga framework by combining its own reduced Bhinnashtakavarga score in its natal house with the aggregate strength of that house from the Sarvashtakavarga.
In classical Vedic Ashtakavarga methodology, the Graha Gunak for a planet is derived by multiplying the planet's own reduced bindu score in the house it occupies by the fully reduced Sarvashtakavarga score of that same house. This product yields a composite index that captures both the planet's intrinsic Ashtakavarga strength and the overall environmental strength of the house it inhabits. A planet with a high Graha Gunak is considered well-placed and powerfully supported by the Ashtakavarga framework; a planet with a low Graha Gunak is considered weakly positioned regardless of other chart factors.
This endpoint computes the full birth chart from the provided date, time, and geographic coordinates, applies the complete Ashtakavarga reduction pipeline (Trikon Shodhan followed by Ekadhipatya Shodhan), and then calculates the Graha Gunak for each of the seven classical planets. The result is a planet-wise composite strength index ready for use in planetary strength analysis, dasha evaluation, and predictive astrology.
What data it returns
The API returns a structured JSON response including:
- Graha Gunak values: The composite multiplier score for each of the seven classical planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn), derived from the product of the planet's own reduced Bhinnashtakavarga score in its occupied house and the fully reduced Sarvashtakavarga score of that house
- Per-planet reduced Bhinnashtakavarga scores: The individual fully reduced bindu scores for each planet in its natal house, forming one component of the Graha Gunak calculation
- Reduced Sarvashtakavarga scores for occupied houses: The fully reduced aggregate house scores for the houses occupied by each planet, forming the second component of the calculation
- Planet strength ranking: A ranked ordering of the seven planets by their Graha Gunak values, identifying the strongest and weakest planets in the chart from an Ashtakavarga perspective
- Contextual interpretation: Textual descriptions of the significance of each planet's Graha Gunak value, explaining the implications for the areas of life and chart functions governed by that planet
Main use cases
- Individual planetary strength assessment for astrology consultation platforms, where practitioners use Graha Gunak values to evaluate how strongly each planet is supported by the Ashtakavarga framework and advise clients on which planetary energies are most and least potent in their chart
- Dasha and antardasha quality evaluation where the Graha Gunak of the dasha lord is used as a key indicator of the overall strength and beneficence of a planetary period, refining predictions about the quality of life events during that period
- Transit analysis where the Graha Gunak of transiting planets is assessed to determine how powerfully each planet will express itself as it moves through the chart, supplementing sign-level Rasi Gunak analysis with planet-level detail
- Comprehensive horoscope report generation that includes the Graha Gunak table as an advanced Ashtakavarga component, providing clients with a planet-level strength profile derived from the fully reduced Ashtakavarga
- Yoga and combination analysis where Graha Gunak values are used to assess the actual Ashtakavarga-backed strength of planets involved in significant yogas or planetary combinations, helping practitioners determine whether a yoga will manifest strongly or weakly
- Predictive astrology platforms that use Graha Gunak values alongside Rasi Gunak to generate nuanced, multi-dimensional strength profiles for each planet and sign in the chart
- Research and educational astrology platforms that teach or study the advanced layers of the Ashtakavarga system, using this endpoint to demonstrate how the Graha Gunak integrates individual planetary scores with house-level aggregate strength
Key functionality
- Full Ashtakavarga pipeline in a single request: Computes the raw Bhinnashtakavarga, applies Trikon Shodhan, applies Ekadhipatya Shodhan, and then calculates the Graha Gunak — the entire classical reduction and multiplication pipeline — in one API call.
- Planet-level composite strength index: Combines each planet's own reduced Bhinnashtakavarga score in its natal house with the fully reduced Sarvashtakavarga score of that house, producing a two-dimensional strength index that captures both intrinsic planetary strength and environmental house support.
- Complementary to Rasi Gunak: Provides the planet-centric perspective that pairs naturally with the sign-centric Rasi Gunak, enabling a complete Ashtakavarga strength profile at both the sign and planet level.
- Planet strength ranking: Delivers a ranked ordering of all seven classical planets by Graha Gunak value, enabling quick identification of the most and least Ashtakavarga-supported planets in the chart.
- Per-planet score transparency: Returns both components of the Graha Gunak calculation (the planet's own reduced score and the house's aggregate reduced score) for each planet, providing full transparency into how each planet's index was derived.
- Precise birth data input: Accepts day, month, year, hour, minute, second, and timezone offset to compute the exact planetary positions at the moment of birth.
- Geographic coordinates: Uses latitude and longitude to accurately determine house cusps and planetary placements relative to the birth location.
- Ayanamsha support: The
X-Ayanamsha header allows selection of the sidereal calculation system (e.g., Lahiri, Raman, KP), ensuring the chart and all Ashtakavarga computations are performed according to the practitioner's preferred Vedic tradition.
- Multilingual support: The
Accept-Language header enables localized descriptions and interpretations, making the API suitable for a global, multilingual user base.
