Skip to content

Shadbala (planet strength)

GET /v1/vedic/charts/{id}/shadbala

Classical Shadbala — 6-fold strength in Virupa units (60 Virupa = 1 Rupa).

Currently four of the six bala types are implemented in full (the deterministic, table-based components):

  • Naisargika bala — natural ranking, Sun strongest (60) → Saturn weakest (≈8.57).
  • Dig bala — directional, max in a planet's preferred angular house (Sun/Mars 10th, Moon/Venus 4th, Jupiter/Mercury 1st, Saturn 7th).
  • Uchcha bala — distance from debilitation point on the ecliptic, scaled 0..60.
  • Drik bala — signed sum of incoming Parashara drishti (benefics +, malefics −).

Kala bala is exposed through two endpoints:

  • /shadbala/kala — five sub-balas computable from the chart alone (paksha + vara + abda
  • masa + yuddha).
  • /shadbala/kala-full — three additional ephemeris-time sub-balas (Nathonnatha, Tribhaga, Ayana) that need sunrise / sunset / declination data.

Combined, that's 8 of the 10 classical Kala sub-balas. The remaining two (full Chesta epicycle math + latitude-based proper Yuddha) need a deeper ephemeris-snapshot framework and remain a future port.

{
  "chart_id": "01HKD…",
  "entries": [
    {
      "planet": "sun",
      "naisargika": 60.0,
      "dig": 30.0,
      "uchcha": 60.0,
      "drik": 12.5,
      "kala": 0.0,
      "chesta": 0.0,
      "other_sthana": 0.0,
      "total": 162.5,
      "simplified": true
    },
    "…7 entries"
  ],
  "note": "Shadbala values in Virupa (60 Virupa = 1 Rupa). The Kala / Chesta / full Sthana sub-components require ephemeris-time math not yet ported; their fields are 0.0 and simplified=true."
}

GET /v1/vedic/charts/{id}/shadbala/kala

Partial Kala bala — five sub-balas that can be computed without sunrise / sunset ephemeris data. Per main planet in Virupa.

Sub-bala What it measures
paksha Lunar-phase weight (Shukla / Krishna paksha). Moon in Shukla is doubled.
vara 45 Virupa if the planet rules the birth weekday, else 0.
abda 15 Virupa if the planet is the year-lord (Abdadhipati).
masa 30 Virupa if the planet is the month-lord (Masadhipati).
yuddha ±30 Virupa for planetary war (two planets within 1°). 
{
  "chart_id": "01HKD…",
  "entries": [
    {"planet": "sun", "paksha": 50.0, "vara": 0.0, "abda": 0.0,
     "masa": 30.0, "yuddha": 0.0, "total": 80.0},
    "…6 more entries"
  ]
}

GET /v1/vedic/charts/{id}/shadbala/kala-full

Ephemeris-time Kala bala — three additional sub-balas that need sunrise / sunset and the planet's ecliptic longitude. The API fetches the sunrise/sunset automatically via the standard panchanga at the chart's birth coordinates.

Sub-bala What it measures
nathonnatha Day/night affinity: Mercury 60 always; Sun/Jupiter/Venus/Ketu use 2 × unnatha (ghatis to midnight); Moon/Mars/Saturn/Rahu use 2 × natha (ghatis from noon). Capped at 60.
tribhaga Which third of day/night a planet rules — Jupiter always 60; day-thirds give 60 to Mercury / Sun / Saturn; night-thirds to Moon / Venus / Mars.
ayana Solar-declination based: planets with northern-hemisphere affinity (Venus/Sun/Mars/Jupiter) score higher in summer; Saturn/Moon prefer winter; Mercury uses absolute declination. Sun's result is doubled. 
{
  "chart_id": "01HKD…",
  "sunrise": "1990-06-15T01:02:43+00:00",
  "sunset": "1990-06-15T14:21:09+00:00",
  "entries": [
    {"planet": "sun", "nathonnatha": 47.5, "tribhaga": 0.0,
     "ayana": 116.8, "total": 164.3},
    "…6 more entries"
  ]
}

GET /v1/vedic/charts/{id}/bhava-bala

Per-house Bhava bala — total strength for each of the 12 houses.

Component What it measures
bhavadhipati Composite strength of the house-lord, in Virupa.
bhava_dig Directional bala based on house category: kendra = 60, panaphara = 30, apoklima = 15.
bhava_drishti Sum of signed drishti landing on the house. 
{
  "chart_id": "01HKD…",
  "entries": [
    {"house_number": 1, "bhavadhipati": 54.0, "bhava_dig": 60.0,
     "bhava_drishti": 22.5, "total": 136.5},
    "…11 more entries"
  ]
}

GET /v1/vedic/charts/{id}/ishta-kashta

Ishta phala (beneficial result) and Kashta phala (harmful result) per planet, both in the 0..60 range. The classical formula ishta = sqrt(cheshta * uchcha) and kashta = sqrt((60-cheshta) * (60-uchcha)) is approximated using composite strength as a proxy for cheshta until full Chesta bala lands.

{
  "chart_id": "01HKD…",
  "entries": [
    {"planet": "jupiter", "ishta": 48.2, "kashta": 18.3},
    {"planet": "saturn", "ishta": 22.1, "kashta": 41.5},
    "…5 more entries"
  ]
}