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.