Skip to content

Predictive engine (full)

The full astrology-derived prediction stack. Composes Phase 6-11 primitives (sambandhas, dignities, shadbala, transits) into one end-to-end probability calculation, with a structured "why this probability" explanation surface.

Pipeline

Theme (life area, e.g. "career", "marriage_for_man", "wealth")
    │
    ├─► get_essential_planets   ← which planets drive this theme
    ├─► get_period_modifiers    ← how the current dasha amplifies them
    ├─► get_transit_modifiers   ← how today's sky boosts/dampens them
    ├─► get_theme_probability   ← 7-source decomposition + decay
    ├─► get_complete_factor     ← structured explanation per theme
    └─► get_meta_factors        ← cross-theme driver planets

GET /v1/vedic/charts/{id}/essential-planets/{theme}

For a thematic significator look up the two key arudhas (from Lagna and from karaka), then rank every graha by its combined signed influence on those arudhas.

{theme} is one of 133 classical significators — career, marriage_for_man, wealth, mother, longevity, dharma, ...

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

{
  "chart_id": "01HKD…",
  "theme": "career",
  "house_number": 10,
  "karaka": "saturn",
  "from_lagna_arudha": "leo",
  "from_karaka_arudha": "capricorn",
  "ranked": [
    {"planet": "jupiter", "influence_on_lagna_arudha": 75.0,
     "influence_on_karaka_arudha": 60.0, "total_influence": 135.0},
    {"planet": "saturn", "influence_on_lagna_arudha": 60.0,
     "influence_on_karaka_arudha": 80.0, "total_influence": 140.0}
  ]
}

GET /v1/vedic/charts/{id}/period-modifiers?at=<iso>

Per-planet "quality multiplier" under the dasha chain at a moment. Each planet starts at 100; the active MD / AD / PD lord adds +100 / +50 / +25, then per-lord modifiers fold in (position relative to Lagna and Lagna-lord, natural nature × 10, functional nature, and mutual relationship between lords).

Returns a planet × score map with English explanation.

GET /v1/vedic/charts/{id}/transit-modifiers?at=<iso>

Per-planet transit quality from the natal Ashtakavarga. Score per graha = 100 + 5 × (SAV − 28) + 10 × (Bhinna − 4) using the transit sign of that graha read against the natal SAV / Bhinna totals. Nodes (Rahu, Ketu) are skipped per the classical convention.

GET /v1/vedic/charts/{id}/probability/{theme}?at=<iso>

The headline endpoint — full 7-source materialization probability for a theme, optionally folded with transits at at:

Source Importance Threshold
KARAKA activation 0.30 70%
HOUSE_FROM_LAGNA 0.40 50%
HOUSE_FROM_MOON 0.30 50%
HOUSE_FROM_SUN 0.20 50%
HOUSE_FROM_KARAKA 0.30 50%
ARUDHA_FROM_LAGNA 0.05 30%
ARUDHA_FROM_KARAKA 0.05 30%

Each source's contribution is the activation × importance, with a soft cap above 100% activation. Failed sources (activation below threshold) trigger a per-condition smooth-decrease coefficient (KARAKA = ×0.5, houses ×0.5, arudhas ×0.9).

{
  "chart_id": "01HKD…",
  "theme": "career",
  "moment": "2026-11-15T12:00:00+00:00",
  "raw_probability": 95.6,
  "final_probability": 0.74,
  "sources": [
    {"condition_type": "karaka", "sign": null, "activation": 110.0,
     "importance": 0.30, "contribution": 33.0, "threshold": 70.0,
     "is_satisfied": true},
    "…6 more sources"
  ],
  "failed_conditions": [
    {"condition_type": "arudha_from_lagna",
     "current_value": 22.0, "required_value": 30.0,
     "description": "arudha_from_lagna activation 22.0 below threshold 30.0"}
  ]
}

GET /v1/vedic/charts/{id}/complete-factor/{theme}

The structured explanation for one theme's probability — the significator's karaka + house, the top essential planets, the two arudhas with their activation, the seven activation sources + failed conditions, plus the final 0..1 probability.

Use this when you want to explain a prediction. Use /probability when you just want the number.

GET /v1/vedic/charts/{id}/meta-factors

Cross-theme analysis: scans the 10 default life themes (self, wealth, siblings, mother, children, spouse, career, dharma, longevity, gain) and identifies planets that drive ≥ 2 themes — either as a significator's karaka or in the top-2 essential ranking. Returns a planet → themes map sorted by weighted score.

{
  "chart_id": "01HKD…",
  "themes_analysed": ["self", "wealth", "siblings", "mother", "children",
                       "spouse", "career", "dharma", "longevity", "gain"],
  "meta_factors": [
    {"planet": "jupiter",
     "themes_as_karaka": ["wealth", "children", "dharma", "gain"],
     "themes_as_essential": ["mother", "spouse"],
     "total_appearances": 6,
     "weighted_score": 18.0},
    "…"
  ]
}

The top meta-factor is the "central driver" of the native's life — where its dasha lights up, multiple themes activate at once.

Available themes

The 133 classical significators include the obvious ones (self, wealth, siblings, mother, father, spouse, husband, wife, children, career, profession, business, position, authority, dharma, spirituality, moksha, longevity, property, vehicles, intelligence, education, knowledge, speech, marriage_for_man, marriage_for_woman, ...) plus more specific markers (maternal_grandfather, imprisonment, fraud, place_of_worship, breasts, pregnancy, ...). Full list lives in domain/astrology/vedic/significators.py — every theme maps to a (karaka, house) pair.