Theo: signs, house roles & themes

The author-original "Theo system" reads a chart through several lenses. This page covers three of them:

• what reaches each zodiac sign, and whether it helps;
• who plays a formal role relative to a target house;
• which houses, karakas and planets carry one life area.

The other two live on their own pages, because they are the ones a product usually leads with:

• Planet strength & disposition — /theo/planets and /theo/houses: Shadbala against the classical requirement, how benefic each planet is for this ascendant, and how the chart's power is shared out between the houses.
• Influence network — every tie in the chart, typed and unsigned.

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: how much of the chart reaches it, and whether this ascendant reads that as help. Two separate numbers, because a sign can be crowded and difficult at once.

• Occupants — every graha sitting in the sign.
• Aspectors — every graha throwing drishti at it, counted once each however many rays land.

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

{
  "chart_id": "019febf3-2900-7542-9982-f00048b6da70",
  "by_sign": [
    {
      "sign": "aries",
      "occupants": ["venus"],
      "aspectors": ["moon", "jupiter", "saturn", "rahu", "ketu"],
      "connection": 243.6,
      "support": 0.971
    },
    "…11 more signs"
  ]
}

Field	Meaning
connection	Total strength reaching the sign. Unsigned — a magnitude, not a verdict.
support	−1 … +1 — the share of that connection coming from planets this lagna calls benefic.

net_strength, benefic_strength and malefic_strength were removed

They signed each tie by a static benefic/malefic table, which is a fact about the table rather than about the chart. See the migration table.

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.