Planet Ashtak API

Planet Ashtak

Computes the Bhinnashtakavarga (individual planet's Ashtakavarga) for a specified planet in a person's Vedic birth chart — returning the point scores contributed by each of the eight reference planets across all twelve houses.

What this API does

Ashtakavarga is a classical Vedic astrology system that quantifies planetary strength across the twelve houses of a birth chart using a point-based scoring method. Each of the seven classical planets (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn) plus the Ascendant contributes benefic points (bindus) to the houses based on its position relative to the other planets and the Ascendant. The resulting grid of scores — known as the Bhinnashtakavarga — reveals how strongly each planet is supported in each house of the chart.

This endpoint computes the Bhinnashtakavarga for a single, specified planet (identified via the ashtakPlanetKey path parameter). It calculates the birth chart from the provided date, time, and geographic coordinates, then applies the classical Ashtakavarga rules to determine how many benefic points each of the eight reference bodies (Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, and Ascendant) contributes to each of the twelve houses for the selected planet. The result is a house-by-house score table for that planet, along with the total bindu count.

Supported planets and reference points: sun, moon, mars, mercury, jupiter, venus, saturn, rahu, ascendant.

What data it returns

The API returns a structured JSON response including:

• Planet identity: The name and key of the planet for which the Bhinnashtakavarga has been computed
• House-wise bindu scores: For each of the twelve houses, the number of benefic points (bindus) contributed by each of the eight reference bodies, presented as a detailed breakdown
• Total bindus per house: The aggregate bindu score for each house, summing contributions from all eight reference bodies
• Total bindu count: The overall total of all bindus across all twelve houses for the selected planet
• Contextual interpretation: Textual descriptions of the significance of the scores, indicating which houses are strong or weak for the planet based on classical Ashtakavarga thresholds

Main use cases

• Detailed Ashtakavarga analysis in horoscope reports, providing clients with a house-by-house strength assessment for each planet in their birth chart
• Transit strength evaluation — Ashtakavarga scores are widely used to assess how favorably a transiting planet will perform as it moves through each house; this endpoint provides the per-planet data needed for such analysis
• Astrology consultation platforms where practitioners need precise Bhinnashtakavarga tables to discuss planetary strength, favorable periods, and house-level influences with clients
• Sarvashtakavarga computation — the individual planet Ashtakavarga scores from this endpoint can be aggregated across all planets to build the Sarvashtakavarga (combined Ashtakavarga) table
• Dasha and transit timing tools that use Ashtakavarga bindus to refine predictions about when a planet's transit through a particular house will be most or least beneficial
• Educational astrology platforms that teach the Ashtakavarga system by displaying the full Bhinnashtakavarga grid with contributor-level breakdowns for each planet

Key functionality

• Per-planet computation: Computes the Bhinnashtakavarga for a single specified planet per request, allowing targeted retrieval of the exact planet's data needed without processing the entire chart at once.
• Planet selection via path parameter: The ashtakPlanetKey path parameter accepts sun, moon, mars, mercury, jupiter, venus, saturn, rahu, or ascendant, giving precise control over which planet's Ashtakavarga is returned.
• Contributor-level breakdown: Returns the individual bindu contributions from each of the eight reference bodies for every house, not just the aggregate totals — enabling detailed analysis of which planets are supporting or weakening the selected planet in each house.
• 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 Ashtakavarga scores are computed according to the practitioner's preferred Vedic tradition.
• Classical rule application: Applies the traditional Ashtakavarga rules for each planet, faithfully reproducing the classical bindu assignment methodology used in Vedic astrology texts.
• Multilingual support: The Accept-Language header enables localized descriptions and interpretations, making the API suitable for a global, multilingual user base.