Skip to content

Composite strength

Three layers of strength scoring sit on top of the per-component shadbala numbers. They aggregate the deterministic dignity/varga math into single numbers that are easy to compare across planets, signs, and houses.

GET /v1/vedic/charts/{id}/vimshopaka/{planet}

Vimshopaka bala is a 20-point score that asks "how dignified is this planet across all the divisional charts of one varga group?"

Query param group selects the varga grouping:

Group Varga members Total weight
shad_varga (default) D1 + D2 + D3 + D9 + D12 + D30 20
sapta_varga + D7 20
dasha_varga + D10 + D16 + D60 20
shodasha_varga + D4 + D20 + D24 + D27 + D40 + D45 20

For each varga the planet's relationship to its sign (Exaltation / Mooltrikona / Own / Friend / … / Debilitation) is mapped to a 0..20 score, scaled by the varga's weight in the group, then summed.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/vimshopaka/jupiter?group=shad_varga"

{
  "chart_id": "01HKD…",
  "planet": "jupiter",
  "varga_group": "shad_varga",
  "points": 15.45,
  "per_varga_points": {
    "D1": 5.1,
    "D2": 1.7,
    "D3": 3.4,
    "D9": 4.25,
    "D12": 0.7,
    "D30": 0.3
  }
}

Score bands:

Points Reading
0-5 Catastrophic
5-8 Poor
9-11 Average
12-15 Good
15-20 Best

GET /v1/vedic/charts/{id}/varga-dignity

Counts how many vargas (out of the 16-varga Shodasha group) each planet sits in its own sign, and assigns the classical combination name when the count is 2+.

Count Name
2 Parijatamsa
3 Parvathamsa
4 Simhasanamsa
5 Swargabalamsa
6 Indramsa
7 Rajapadmamsa
8 Gopuramsa
9 Brahmapadamsa
10 Vaishnavamsa
11 Saivamsa
12 Vaiseshikamsa 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/varga-dignity"

{
  "chart_id": "01HKD…",
  "entries": [
    {"planet": "jupiter", "own_sign_count": 4, "dignity_name": "Simhasanamsa",
     "own_sign_vargas": ["D1", "D3", "D9", "D12"]},
    {"planet": "sun", "own_sign_count": 2, "dignity_name": "Parijatamsa",
     "own_sign_vargas": ["D1", "D30"]},
    {"planet": "mars", "own_sign_count": 0, "dignity_name": null,
     "own_sign_vargas": []}
  ]
}

GET /v1/vedic/charts/{id}/strength/composite

Composite per-planet strength score (0..1) combining:

  • 0.40 × shadbala ratio (rupas / required rupas, capped at 1.5)
  • 0.35 × vimshopaka norm (shad-varga points / 20)
  • 0.25 × dignity score (Exaltation = 1.0, Debilitation = 0.0)

The category bucket is one of very_weak / weak / medium / strong / very_strong.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/strength/composite"

{
  "chart_id": "01HKD…",
  "entries": [
    {
      "planet": "jupiter",
      "score": 0.85,
      "category": "strong",
      "components": {
        "shadbala_ratio": 0.92,
        "vimshopaka_norm": 0.77,
        "dignity_norm": 0.9
      }
    },
    "…6 more entries"
  ]
}

GET /v1/vedic/charts/{id}/strength/signs

Composite strength score for each of the 12 zodiac signs. Combines the Sarvashtaka bindu count for the sign with the composite strength of the sign's primary lord, 50/50.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/strength/signs"

{
  "chart_id": "01HKD…",
  "by_sign": {
    "aries": 0.62,
    "taurus": 0.71,
    "gemini": 0.55,
    "…": "…"
  }
}

GET /v1/vedic/charts/{id}/strength/houses

Composite strength score for each of the 12 houses. Derived directly from the sign-strength of the sign sitting on the house cusp (whole-sign).

{
  "chart_id": "01HKD…",
  "by_house": {
    "1": 0.62,
    "2": 0.71,
    "3": 0.55,
    "…": "…"
  }
}

When Phase 8 shadbala fills in the simplified sub-balas, these composite numbers shift automatically — the aggregator does not need to be re-released.

GET /v1/vedic/charts/{id}/strength/planets

The per-planet strength profile — the single richest strength read. For each classical planet it folds the Shadbala decomposition, ishta/kashta phala, the graha avastha (state), functional nature, and a composite score into one entry.

{
  "chart_id": "01HKD…",
  "method_version": "v2",
  "entries": [
    {
      "planet": "jupiter",
      "sign": "pisces",
      "house": 4,
      "owned_houses": [3, 6],
      "functional_nature": "benefic",
      "is_yogakaraka": false,
      "composite_score": 0.85,
      "composite_category": "strong",
      "shadbala": {
        "naisargika": 0.6, "dig": 1.0, "uchcha": 0.9, "drik": 0.4,
        "kala": 0.0, "chesta": 0.0, "other_sthana": 0.0, "total": 2.9,
        "simplified": true
      },
      "ishta_kashta": { "ishta": 0.72, "kashta": 0.28 },
      "avastha": { "age": "kumara", "dignity": "exalted", "motion": "direct" }
    }
  ],
  "features_used": [ { "source": "strength", "version": "v2", "fields": ["shadbala"] } ]
}
Field (per entries[]) Type Notes
sign / house string / int The planet's natal placement.
owned_houses int[] Houses it rules.
functional_nature string | null benefic / malefic / neutral for this ascendant.
is_yogakaraka bool Rules both a kendra and a trikona.
composite_score / composite_category float / string The same 0..1 composite as /strength/composite.
shadbala object The six-bala decomposition (simplified: true while the unimplemented balas read 0.0).
ishta_kashta object | null Benefic vs. malefic potential, each 0..1.
avastha object {age, dignity, motion} — the graha's classical state.

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

The raw Shadbala decomposition on its own — identical to /shadbala (same ShadbalaResponse). Use whichever path fits your URL layout; both return the same numbers.

{
  "chart_id": "01HKD…",
  "entries": [
    { "planet": "jupiter", "naisargika": 0.6, "dig": 1.0, "uchcha": 0.9,
      "drik": 0.4, "kala": 0.0, "chesta": 0.0, "other_sthana": 0.0,
      "total": 2.9, "simplified": true }
  ],
  "note": "Simplified Shadbala — Kala/Chesta/Sthana sub-balas pending."
}