Skip to content

Theo system

The author-original "Theo system" provides three perspectives on influence in the chart:

  • Who plays a role relative to a target house.
  • What net signed influence each zodiac sign receives.
  • Which thematic life-area is the strongest indicator.

GET /v1/vedic/charts/{id}/theo/house-roles/{house_number}

For one target house (path-validated 1..12), classifies every other planet by its position relative to the target. The role labels and their strength multipliers follow the classical kendra / trikona / dusthana hierarchy:

Relative house Role Multiplier
1 KENDRA_1 1.0
4 KENDRA_4 1.2
7 KENDRA_7 1.4
10 KENDRA_10 1.6
5 TRIKONA_5 1.3
9 TRIKONA_9 1.6
6 DUSTHANA_6 1.0
8 DUSTHANA_8 1.3
12 DUSTHANA_12 1.6

A planet in a relative house not listed (2, 3, 11) carries no formal role.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/theo/house-roles/10"

{
  "chart_id": "01HKD…",
  "house_number": 10,
  "kendras": [
    {"planet": "saturn", "role": "KENDRA_1", "multiplier": 1.0,
     "explanation": "saturn sits in house 10 — the KENDRA_1 (mult x1.0) of house 10"}
  ],
  "trikonas": [
    {"planet": "sun", "role": "TRIKONA_9", "multiplier": 1.6,
     "explanation": "sun sits in house 6 — the TRIKONA_9 (mult x1.6) of house 10"}
  ],
  "dusthanas": [
    {"planet": "mercury", "role": "DUSTHANA_12", "multiplier": 1.6,
     "explanation": "mercury sits in house 9 — the DUSTHANA_12 (mult x1.6) of house 10"}
  ]
}

GET /v1/vedic/charts/{id}/theo/sign-influences

For each of the 12 signs, sums net signed influence (benefic minus malefic Virupa). Inputs:

  • Occupants — each occupying graha contributes ±60 by its corrected nature.
  • Aspectors — incoming drishti edges contribute their full Virupa strength, signed by the source's nature.
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/theo/sign-influences"

{
  "chart_id": "01HKD…",
  "by_sign": [
    {
      "sign": "aries",
      "occupants": ["sun"],
      "aspectors": ["mars", "jupiter"],
      "net_strength": 30.0,
      "benefic_strength": 90.0,
      "malefic_strength": 60.0
    },
    "…11 more signs"
  ]
}

GET /v1/vedic/charts/{id}/theo/thematic/{area}

Returns the houses + karakas + activated planets for one life area. Path-validated to one of:

Area Houses Karakas
self 1 Sun
wealth 2, 11 Jupiter, Venus
siblings 3 Mars
home 4 Moon, Mars
children 5 Jupiter
health 6 Mars, Saturn
partnerships 7 Venus
longevity 8 Saturn
dharma 9 Jupiter, Sun
career 10 Sun, Mercury, Saturn
losses 12 Saturn, Ketu 
curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/theo/thematic/career"

{
  "chart_id": "01HKD…",
  "area": "career",
  "houses": [10],
  "karakas": ["sun", "mercury", "saturn"],
  "house_planets": ["saturn"],
  "karaka_houses": [6, 9, 10]
}

house_planets lists every planet sitting in any of the area's houses; karaka_houses lists which house each karaka occupies.