Skip to content

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

Theo-system influence network. Computes a directed graph of signed influences:

  • Per-planet summary — every incoming aspect / conjunction edge scored with the source planet's polarity (+ for benefic, − for malefic) × drishti strength.
  • Per-house influence — sum of occupant polarities + aspecting planet polarities × drishti strengths.
{
  "chart_id": "01HKD…",
  "planet_summaries": [
    {
      "planet": "jupiter",
      "incoming": [
        {"source": "saturn", "target": "jupiter", "via": "conjunction", "strength": -60.0},
        {"source": "venus", "target": "jupiter", "via": "aspect", "strength": 22.5}
      ],
      "net_strength": -37.5
    },
    "…9 planets"
  ],
  "house_influences": [
    {
      "house_number": 1,
      "house_sign": "taurus",
      "occupants": ["jupiter"],
      "aspects": [
        {"source": "saturn", "target": "ascendant", "via": "aspect", "strength": -30.0}
      ],
      "net_strength": 30.0
    },
    "…12 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).