Skip to content

Shadbala (planet strength)

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

Classical Shadbala — the six-fold strength, in Virupa units (60 Virupa = 1 Rupa). All six are counted.

Bala What it measures
Sthana Positional. Uchcha (distance from the debilitation point, 0…60) plus saptavargaja, ojayugma, kendradi and drekkana. Reported as two fields: uchcha and other_sthana.
Dig Directional — maximal in the planet's preferred angle (Sun/Mars 10th, Moon/Venus 4th, Jupiter/Mercury 1st, Saturn 7th).
Kala Temporal — paksha, vara, abda, masa and yuddha, plus nathonnatha, tribhaga and ayana read off the shape of the birth day.
Chesta Motional — the eight classical states of motion, read from true speed against the planet's mean rate. The Sun and the Moon take their BPHS substitutes (ayana and paksha bala).
Naisargika Natural ranking — Sun strongest (60) → Saturn weakest (≈ 8.57).
Drik Aspectual — signed sum of incoming Parashara drishti. Can be negative. 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/shadbala"

{
  "chart_id": "019febf3-2900-7542-9982-f00048b6da70",
  "entries": [
    {
      "planet": "sun",
      "naisargika": 60.0,
      "dig": 30.0,
      "uchcha": 43.23,
      "drik": -96.77,
      "kala": 197.19,
      "chesta": 110.54,
      "other_sthana": 240.0,
      "total": 584.19,
      "simplified": false
    },
    "…6 more entries"
  ],
  "note": "Shadbala values in Virupa (60 Virupa = 1 Rupa). All six balas are counted; simplified=true would mean one could not be, and /theo/planets names which."
}

simplified is true only if some bala could not be counted; in that case /theo/planets names it in strength.missing. Both endpoints read the same composition, so a total here can never disagree with the ratio there.

A raw total answers nothing on its own

Six rupas is a strong Sun and a weak Mercury — BPHS sets a different minimum per planet. For a number a reader can act on, use /theo/planets, which divides the total by that requirement: 1.0 means "classically able", and the figure is comparable between planets and between charts.

The two Kala endpoints below expose that bala's own breakdown. They are unchanged and remain useful when you want the sub-balas separately rather than the composed total above.

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"
  ]
}