Progressions, influence & predictive engine¶

`GET /v1/vedic/charts/{id}/progression?event_date=<iso>`¶

Age-based planetary progression — for the person's age at event_date, finds the ruling planet from a classical 9-planet age-window table (covers ages 1-105) and progresses the planet's natal longitude forward at 360° / (period_years × 365.2564) degrees per day since the start of the current age-window.

Retrograde planets progress backwards.

{
  "planet": "venus",
  "is_retrograde": false,
  "progressed_longitude": 64.7,
  "progression_start_date": "2015-06-15T00:00:00+00:00",
  "progression_years": 3,
  "final_longitude": 312.4,
  "event_date": "2018-09-21T00:00:00+00:00",
  "age": 28,
  "natal_longitude": 247.7,
  "daily_movement": 0.328,
  "days_since_period_start": 1194.0
}

`GET /v1/vedic/charts/{id}/influence-network`¶

Every tie in the chart, as a directed graph. Connection, not judgement: each edge is a positive magnitude saying how strongly one body reaches another. Whether that reach helps is a separate question, answered by disposition on /theo/planets.

The ten ways one body reaches another, with their base strengths in the same units:

`via`	Strength	What it is
`sign_exchange`	100	Each planet sits in the other's sign (parivartana). Replaces the plain dispositorship it contains.
`conjunction`	60–80	Same sign, scaled by orb — tighter is stronger.
`combustion`	70	The Sun burning a planet within its orb.
`being_combust`	50	The same closeness read from the burnt planet's side.
`aspect`	by drishti	Parashara graded drishti, full or partial.
`dispositorship`	40	The planet occupies a sign this one rules.
`sign_aspect`	10–30	An aspect on the sign, when there is no direct aspect on the body.
`navamsa`	30	Both share a navamsa (D9) sign.
`nakshatra_lord`	10	Both share a nakshatra lord — the faintest tie.

Two more appear on houses only: occupation (100) and lordship (60).

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

{
  "chart_id": "019febf3-2900-7542-9982-f00048b6da70",
  "planet_summaries": [
    {
      "planet": "sun",
      "incoming": [
        {"source": "jupiter", "target": "sun", "via": "conjunction", "strength": 65.44},
        {"source": "mercury", "target": "sun", "via": "dispositorship", "strength": 40.0},
        {"source": "saturn", "target": "sun", "via": "aspect", "strength": 60.0}
      ],
      "influence_received": 302.11,
      "influence_given": 182.0
    },
    "…8 more bodies"
  ],
  "house_influences": [
    {
      "house_number": 1,
      "house_sign": "gemini",
      "occupants": ["sun", "jupiter"],
      "edges": [
        {"source": "sun", "target": "mercury", "via": "occupation", "strength": 100.0},
        {"source": "mercury", "target": "mercury", "via": "lordship", "strength": 60.0}
      ],
      "connection": 462.9,
      "support": 0.011
    },
    "…11 more houses"
  ]
}

Field	Meaning
`incoming`	Every tie reaching this body, typed and unsigned.
`influence_received` / `influence_given`	The totals in each direction.
`connection` (house)	The total strength reaching the house, unsigned.
`support` (house)	−1 … +1 — the share of that connection this lagna calls benefic.

net_strength was removed

Both planet_summaries[].net_strength and the houses' signed totals are gone. They summed a static polarity table over every other planet, which made the four natural benefics score worst in 82% of charts for arithmetic reasons. See the migration table.

A house's power — connection weighted by the strength of the planets that reach it — is published separately by /theo/houses.

`GET /v1/vedic/charts/{id}/house-quality`¶

Per-house auspiciousness label combining sign-influence (benefic minus malefic), bhava bala, and house composite strength.

Buckets:

Score range	Label
≤ -1.0	`very_difficult`
-1.0 < s ≤ -0.2	`difficult`
-0.2 < s ≤ 0.2	`neutral`
0.2 < s ≤ 1.0	`good`
> 1.0	`very_good`

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

{
  "chart_id": "01HKD…",
  "by_house": [
    {
      "house_number": 1,
      "sign": "aries",
      "score": 0.62,
      "label": "good",
      "components": {
        "sign_net_norm": 0.45,
        "bhava_norm": 0.62,
        "house_strength": 0.81
      }
    },
    "…11 more entries"
  ]
}

`GET /v1/vedic/charts/{id}/predict/materialization/{area}`¶

Natal "base potential" for one thematic life area on a 0..1 scale. The signature feature — once the transit overlay is wired through, the same function returns a date-bound probability for any future moment.

Combination:

0.5 × averaged quality of the area's houses (mapped from [-2, 2] to [0, 1]).
0.3 × averaged composite strength of the area's karakas.
0.2 × composite strength of the primary lord of the area's first house.

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

{
  "chart_id": "01HKD…",
  "area": "career",
  "base_potential": 0.71,
  "house_qualities": {"10": 0.62},
  "karaka_strengths": {
    "sun": 0.85,
    "mercury": 0.72,
    "saturn": 0.51
  },
  "lord_strength": 0.81
}

How to read `base_potential`¶

Value	Reading
> 0.75	Strong natural potential — the chart is built for this area.
0.55-0.75	Solid baseline — manifestation likely with effort.
0.35-0.55	Mixed — depends heavily on activations / transits.
< 0.35	Weak natural baseline — the area is harder to manifest.

`GET /v1/vedic/charts/{id}/predict/materialization/{area}/at`¶

Date-bound materialization probability — composes the natal base_potential with a transit modifier derived from transit contacts landing on the area's karakas and first-house lord. Returns final_probability ∈ [0, 1] for the moment in question.

Param	Type	Notes
`at`	ISO-8601 datetime	Moment to evaluate. Must be timezone-aware.

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/predict/materialization/career/at?at=2026-11-15T12:00:00Z"

{
  "chart_id": "01HKD…",
  "area": "career",
  "moment": "2026-11-15T12:00:00+00:00",
  "base_potential": 0.71,
  "transit_multiplier": 1.18,
  "final_probability": 0.838,
  "contributing_contacts": [
    {
      "transit_planet": "jupiter",
      "natal_planet": "sun",
      "kind": "aspect",
      "strength": 60.0,
      "contribution": 1.0
    },
    {
      "transit_planet": "saturn",
      "natal_planet": "mercury",
      "kind": "conjunction",
      "strength": 60.0,
      "contribution": -1.0
    }
  ]
}

Mechanics:

Multiplier is clamped to [0.8, 1.5] so a completely barren transit window leaves the natal at 80 % strength, and a saturated benefic window can lift it by ~50 %.
Benefic transits (Jupiter, Venus, Mercury, Moon) contribute positively; everything else contributes negatively.
Only contacts to the area's karakas and the lord of the area's first house enter the multiplier — generic transits elsewhere are ignored (they show up via transit contacts but don't dilute this score).

Progressions, influence & predictive engine¶

GET /v1/vedic/charts/{id}/progression?event_date=<iso>¶

GET /v1/vedic/charts/{id}/influence-network¶

GET /v1/vedic/charts/{id}/house-quality¶

GET /v1/vedic/charts/{id}/predict/materialization/{area}¶

How to read base_potential¶

GET /v1/vedic/charts/{id}/predict/materialization/{area}/at¶