Skip to content

Sambandhas (planetary relationships)

A sambandha is any classical two-planet connection that classical Vedic astrology recognises. The platform detects five canonical types plus the self-relation sentinel.

Type Strength (Virupa) Detected when…
exchange (parivartana) 60 Each planet sits in the other's sign of rulership.
conjunction 50 Both planets occupy the same sign.
mutual_nakshatra 40 Each planet is in a nakshatra owned by the other.
aspect_from_dispositor_to_planet 35 A planet's sign-lord aspects it.
aspect_from_planet_to_dispositor 30 The planet aspects its own sign-lord.
self 100 Sentinel returned when both query planets are identical.

Aspect detection reuses the Vedic drishti matrix, so the strengths compose cleanly with the rest of the engine.

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

Returns every sambandha between two specific planets. Query parameters:

Param Type Notes
p1 string First planet (e.g. sun, moon, rahu).
p2 string Second planet.
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/sambandhas?p1=mars&p2=venus"
{
  "chart_id": "01HKD…",
  "planet1": "mars",
  "planet2": "venus",
  "relationships": [
    {
      "planet1": "mars",
      "planet2": "venus",
      "sambandha_type": "exchange",
      "strength": 60.0,
      "explanation": "mars in taurus, venus in aries — mutual exchange"
    }
  ]
}

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

Returns every sambandha that affects one planet, summed into a total strength score.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/sambandhas/sun"
{
  "chart_id": "01HKD…",
  "planet": "sun",
  "total_strength": 140.0,
  "relationships": [
    {"planet1": "sun", "planet2": "mars", "sambandha_type": "conjunction",
     "strength": 50.0, "explanation": "sun and mars conjunct in aries"},
    {"planet1": "sun", "planet2": "jupiter", "sambandha_type": "aspect_from_dispositor_to_planet",
     "strength": 35.0, "explanation": "jupiter (lord of leo) aspects sun sitting in its sign"}
  ]
}

Reading the strengths

The 0..60 Virupa range matches the drishti / drik-bala scale used elsewhere, so sambandha numbers can be combined with the rest of the strength chain (shadbala, vimshopaka, composite). A planet with a total above ~150 is considered tightly connected to the rest of the chart; below ~50 it sits largely isolated.