Vedic engine — overview¶

Free · all plans

Scopes:

charts:read — GET /v1/vedic/charts/{chart_id}/arudha, GET /v1/vedic/charts/{chart_id}/ashtakavarga, GET /v1/vedic/charts/{chart_id}/ashtakavarga/bhinna, GET /v1/vedic/charts/{chart_id}/ashtakavarga/corrected, GET /v1/vedic/charts/{chart_id}/ashtakavarga/sarva, GET /v1/vedic/charts/{chart_id}/ashtakavarga/transit-score, GET /v1/vedic/charts/{chart_id}/aspects, GET /v1/vedic/charts/{chart_id}/aspects/with-orb, GET /v1/vedic/charts/{chart_id}/badhaka, GET /v1/vedic/charts/{chart_id}/bhava-bala, GET /v1/vedic/charts/{chart_id}/bhava-chakra, GET /v1/vedic/charts/{chart_id}/complete-factor/{theme}, GET /v1/vedic/charts/{chart_id}/corrected-nature, GET /v1/vedic/charts/{chart_id}/daily-weather, GET /v1/vedic/charts/{chart_id}/dasha/chara, GET /v1/vedic/charts/{chart_id}/dasha/current, GET /v1/vedic/charts/{chart_id}/dasha/vimshottari, GET /v1/vedic/charts/{chart_id}/dasha/yogini, GET /v1/vedic/charts/{chart_id}/dashamsa, GET /v1/vedic/charts/{chart_id}/dashas/chara, GET /v1/vedic/charts/{chart_id}/dashas/vimshottari, GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/cards, GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/current, GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/next-change, GET /v1/vedic/charts/{chart_id}/dignity, GET /v1/vedic/charts/{chart_id}/divisional/{varga}, GET /v1/vedic/charts/{chart_id}/essential-planets/{theme}, GET /v1/vedic/charts/{chart_id}/extended-sambandhas, GET /v1/vedic/charts/{chart_id}/extended-sambandhas/{planet}, GET /v1/vedic/charts/{chart_id}/focus-areas, GET /v1/vedic/charts/{chart_id}/functional-nature, GET /v1/vedic/charts/{chart_id}/house-aspects, GET /v1/vedic/charts/{chart_id}/house-quality, GET /v1/vedic/charts/{chart_id}/house-relations/house/{house_number}, GET /v1/vedic/charts/{chart_id}/house-relations/planet/{planet}, GET /v1/vedic/charts/{chart_id}/influence-network, GET /v1/vedic/charts/{chart_id}/ishta-kashta, GET /v1/vedic/charts/{chart_id}/jaimini/arudha, GET /v1/vedic/charts/{chart_id}/jaimini/aspects, GET /v1/vedic/charts/{chart_id}/jaimini/karakas, GET /v1/vedic/charts/{chart_id}/karakas/jaimini, GET /v1/vedic/charts/{chart_id}/livelihood, GET /v1/vedic/charts/{chart_id}/meta-factors, GET /v1/vedic/charts/{chart_id}/muhurta, GET /v1/vedic/charts/{chart_id}/navamsa, GET /v1/vedic/charts/{chart_id}/next-important-transit, GET /v1/vedic/charts/{chart_id}/period-lords, GET /v1/vedic/charts/{chart_id}/period-modifiers, GET /v1/vedic/charts/{chart_id}/predict/materialization/{area}, GET /v1/vedic/charts/{chart_id}/predict/materialization/{area}/at, GET /v1/vedic/charts/{chart_id}/probability/{theme}, GET /v1/vedic/charts/{chart_id}/progression, GET /v1/vedic/charts/{chart_id}/rays, GET /v1/vedic/charts/{chart_id}/rectify-lagna, GET /v1/vedic/charts/{chart_id}/risk-signals, GET /v1/vedic/charts/{chart_id}/sade-sati, GET /v1/vedic/charts/{chart_id}/sambandhas, GET /v1/vedic/charts/{chart_id}/sambandhas/{planet}, GET /v1/vedic/charts/{chart_id}/shadbala, GET /v1/vedic/charts/{chart_id}/shadbala/kala, GET /v1/vedic/charts/{chart_id}/shadbala/kala-full, GET /v1/vedic/charts/{chart_id}/special-lagnas, GET /v1/vedic/charts/{chart_id}/special-vargas, GET /v1/vedic/charts/{chart_id}/strength/composite, GET /v1/vedic/charts/{chart_id}/strength/houses, GET /v1/vedic/charts/{chart_id}/strength/planets, GET /v1/vedic/charts/{chart_id}/strength/shadbala, GET /v1/vedic/charts/{chart_id}/strength/signs, GET /v1/vedic/charts/{chart_id}/support-signals, GET /v1/vedic/charts/{chart_id}/theo/house-roles/{house_number}, GET /v1/vedic/charts/{chart_id}/theo/house-strength, GET /v1/vedic/charts/{chart_id}/theo/houses, GET /v1/vedic/charts/{chart_id}/theo/planets, GET /v1/vedic/charts/{chart_id}/theo/sign-influences, GET /v1/vedic/charts/{chart_id}/theo/thematic/{area}, GET /v1/vedic/charts/{chart_id}/transit-events, GET /v1/vedic/charts/{chart_id}/transit-modifiers, GET /v1/vedic/charts/{chart_id}/transits, GET /v1/vedic/charts/{chart_id}/transits/contacts, GET /v1/vedic/charts/{chart_id}/transits/navamsa-activations, GET /v1/vedic/charts/{chart_id}/ux/daily-personal-weather, GET /v1/vedic/charts/{chart_id}/ux/next-important-period, GET /v1/vedic/charts/{chart_id}/ux/profile-summary-cards, GET /v1/vedic/charts/{chart_id}/ux/timeline-cards, GET /v1/vedic/charts/{chart_id}/varga-dignity, GET /v1/vedic/charts/{chart_id}/varga-strength, GET /v1/vedic/charts/{chart_id}/vargas, GET /v1/vedic/charts/{chart_id}/vargas/{varga}, GET /v1/vedic/charts/{chart_id}/varshaphala/{age_years}, GET /v1/vedic/charts/{chart_id}/vimshopaka/{planet}, GET /v1/vedic/charts/{chart_id}/yoga-summary-cards, GET /v1/vedic/charts/{chart_id}/yogas, GET /v1/vedic/charts/{chart_id}/yogas/{category}, GET /v1/vedic/kp/lookup, GET /v1/vedic/muhurta/activity-types, GET /v1/vedic/panchanga, GET /v1/vedic/panchanga/current, GET /v1/vedic/panchanga/windows, GET /v1/vedic/sky/ingresses, GET /v1/vedic/vaishnava/calendar, GET /v1/vedic/vaishnava/upcoming, POST /v1/vedic/muhurta/score, POST /v1/vedic/muhurta/search, POST /v1/vedic/relationships/doshas, POST /v1/vedic/relationships/highlights, POST /v1/vedic/relationships/kuta, POST /v1/vedic/relationships/report, POST /v1/vedic/relationships/topics, POST /v1/vedic/ux/relationship-highlights
charts:write — POST /v1/charts

The /v1/vedic/* endpoints expose a complete classical Vedic toolkit ported from the original astrolink engine (~64k lines) with math byte-identical to the source. All routes layer on top of an existing :chart_id: build a chart through POST /v1/charts first, then call any of the routes below.

All endpoints require Authorization: Bearer <token> and the charts:read scope.

Endpoints at a glance¶

Generated from the live schema by scripts/build_vedic_overview.py — do not edit by hand.

Endpoint	What it returns
`GET /v1/vedic/charts/{chart_id}/arudha`	Deprecated. Arudha pada for every house
`GET /v1/vedic/charts/{chart_id}/ashtakavarga`	Full Ashtakavarga: 7 Bhinnashtakavargas + Sarvashtakavarga
`GET /v1/vedic/charts/{chart_id}/ashtakavarga/bhinna`	Planet-specific Bhinna Ashtakavarga bindu tables
`GET /v1/vedic/charts/{chart_id}/ashtakavarga/corrected`	Corrected Bhinnashtakavarga (Trikona + Ekadhipatya Shodhana)
`GET /v1/vedic/charts/{chart_id}/ashtakavarga/sarva`	Sarvashtakavarga summary with strong and weak signs
`GET /v1/vedic/charts/{chart_id}/ashtakavarga/transit-score`	Ashtakavarga scoring for current transit positions
`GET /v1/vedic/charts/{chart_id}/aspects`	Vedic drishti — regular Parashara + special aspects
`GET /v1/vedic/charts/{chart_id}/aspects/with-orb`	Continuous aspect strength — orb-modulated quadratic decay
`GET /v1/vedic/charts/{chart_id}/badhaka`	Badhaka sign + lord for the chart's lagna
`GET /v1/vedic/charts/{chart_id}/bhava-bala`	Bhava bala per house (bhavadhipati + dig + drishti)
`GET /v1/vedic/charts/{chart_id}/bhava-chakra`	Bhava (house) chakra in Raman or Equal style
`GET /v1/vedic/charts/{chart_id}/complete-factor/{theme}`	Complete factor — full structured explanation of one theme's probability
`GET /v1/vedic/charts/{chart_id}/corrected-nature`	Mercury contamination + Moon phase nature corrections
`GET /v1/vedic/charts/{chart_id}/daily-weather`	Daily personal Vedic weather cards
`GET /v1/vedic/charts/{chart_id}/dasha/chara`	Deprecated. Chara (Jaimini) dasha — sign-based, lord-position years
`GET /v1/vedic/charts/{chart_id}/dasha/current`	Deprecated. Current Vimshottari MD / AD / PD at a moment
`GET /v1/vedic/charts/{chart_id}/dasha/vimshottari`	Deprecated. Full Vimshottari MD/AD/PD chain from natal Moon
`GET /v1/vedic/charts/{chart_id}/dasha/yogini`	Yogini dasha — 8-yogini, 36-year cycle from janma nakshatra
`GET /v1/vedic/charts/{chart_id}/dashamsa`	Dashamsa D10 chart with career and status focus topics
`GET /v1/vedic/charts/{chart_id}/dashas/chara`	Chara (Jaimini) dasha timeline
`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari`	Full Vimshottari MD/AD/PD/SD chain from natal Moon
`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/cards`	Frontend-ready Vimshottari timeline cards
`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/current`	Current Vimshottari MD / AD / PD / SD at a moment
`GET /v1/vedic/charts/{chart_id}/dashas/vimshottari/next-change`	Next Vimshottari period boundary after a moment
`GET /v1/vedic/charts/{chart_id}/dignity`	Per-planet dignity (Exalt/Mooltrikona/Own/Friend/.../Debilitation)
`GET /v1/vedic/charts/{chart_id}/divisional/{varga}`	Get the planet→sign map in a divisional chart (D1..D60)
`GET /v1/vedic/charts/{chart_id}/essential-planets/{theme}`	Planets most responsible for one life theme (Significator-based)
`GET /v1/vedic/charts/{chart_id}/extended-sambandhas`	Extended sambandhas (9 sub-types) between two planets
`GET /v1/vedic/charts/{chart_id}/extended-sambandhas/{planet}`	All extended sambandhas affecting one planet, grouped by counterpart
`GET /v1/vedic/charts/{chart_id}/focus-areas`	Current practical focus areas grounded in daily transit context
`GET /v1/vedic/charts/{chart_id}/functional-nature`	Per-planet functional nature for the chart's ascendant
`GET /v1/vedic/charts/{chart_id}/house-aspects`	Which planets aspect each house (whole-sign drishti)
`GET /v1/vedic/charts/{chart_id}/house-quality`	Per-house auspiciousness (VERY_DIFFICULT..VERY_GOOD)
`GET /v1/vedic/charts/{chart_id}/house-relations/house/{house_number}`	Every relation linking any planet to one house
`GET /v1/vedic/charts/{chart_id}/house-relations/planet/{planet}`	Every relation between one planet and the 12 houses
`GET /v1/vedic/charts/{chart_id}/influence-network`	Theo influence network — how strongly each body is tied to the rest of the chart
`GET /v1/vedic/charts/{chart_id}/ishta-kashta`	Ishta (beneficial) and Kashta (harmful) phala per planet
`GET /v1/vedic/charts/{chart_id}/jaimini/arudha`	Jaimini Arudha Lagna and Upapada Lagna factors
`GET /v1/vedic/charts/{chart_id}/jaimini/aspects`	Jaimini Rashi aspects between signs
`GET /v1/vedic/charts/{chart_id}/jaimini/karakas`	Jaimini Chara Karakas with Atmakaraka, Amatyakaraka, and Karakamsha
`GET /v1/vedic/charts/{chart_id}/karakas/jaimini`	Deprecated. 7 Jaimini karakas (Atma..Daraka) by descending degree-in-sign
`GET /v1/vedic/charts/{chart_id}/livelihood`	Livelihood indicators: the planets deciding the kind of work
`GET /v1/vedic/charts/{chart_id}/meta-factors`	Meta factors — planets driving multiple themes across the chart
`GET /v1/vedic/charts/{chart_id}/muhurta`	Deprecated. Muhurta optimizer — rank candidate moments by tara + day-lord
`GET /v1/vedic/charts/{chart_id}/navamsa`	Navamsa D9 chart with relationship and dharma focus topics
`GET /v1/vedic/charts/{chart_id}/next-important-transit`	Highest-priority transit card in a date range
`GET /v1/vedic/charts/{chart_id}/period-lords`	Year / month / day / hora classical period lords
`GET /v1/vedic/charts/{chart_id}/period-modifiers`	Per-planet quality modifier under the dasha chain at a moment
`GET /v1/vedic/charts/{chart_id}/predict/materialization/{area}`	Natal base potential (0..1) for a life area
`GET /v1/vedic/charts/{chart_id}/predict/materialization/{area}/at`	Date-bound materialization probability — natal x transit modifier
`GET /v1/vedic/charts/{chart_id}/probability/{theme}`	Full theme probability — 7-source decomposition with smooth decrease
`GET /v1/vedic/charts/{chart_id}/progression`	Age-based planetary progression to an event date
`GET /v1/vedic/charts/{chart_id}/rays`	7-Rays classification — per-planet ray count and total
`GET /v1/vedic/charts/{chart_id}/rectify-lagna`	Kunda-Siddhanta lagna rectification (Janma-Tara matching)
`GET /v1/vedic/charts/{chart_id}/risk-signals`	Structured challenging Vedic signals without deterministic claims
`GET /v1/vedic/charts/{chart_id}/sade-sati`	Sade Sati phase and Saturn-Moon context
`GET /v1/vedic/charts/{chart_id}/sambandhas`	Sambandhas (parivartana / graha-yoga / aspect / mutual nakshatra) between two planets
`GET /v1/vedic/charts/{chart_id}/sambandhas/{planet}`	All sambandhas affecting one planet, with total Virupa strength
`GET /v1/vedic/charts/{chart_id}/shadbala`	Shadbala — all six balas, in virupa
`GET /v1/vedic/charts/{chart_id}/shadbala/kala`	Kala bala sub-balas (paksha + vara + abda + masa + yuddha)
`GET /v1/vedic/charts/{chart_id}/shadbala/kala-full`	Ephemeris-time Kala bala — Natha + Unnatha + Tribhaga + Ayana
`GET /v1/vedic/charts/{chart_id}/special-lagnas`	Bhava / Hora / Ghatika lagnas
`GET /v1/vedic/charts/{chart_id}/special-vargas`	22nd drekkana from Lagna + 64th navamsa from Moon (death vargas)
`GET /v1/vedic/charts/{chart_id}/strength/composite`	Composite per-planet strength (shadbala + vimshopaka + dignity)
`GET /v1/vedic/charts/{chart_id}/strength/houses`	Composite strength score for each of the 12 houses
`GET /v1/vedic/charts/{chart_id}/strength/planets`	Planet-level strength profile with Shadbala, phala, avastha, and roles
`GET /v1/vedic/charts/{chart_id}/strength/shadbala`	Full Shadbala decomposition for the classical planets
`GET /v1/vedic/charts/{chart_id}/strength/signs`	Composite strength score for each zodiac sign
`GET /v1/vedic/charts/{chart_id}/support-signals`	Structured benefic and support Vedic signals
`GET /v1/vedic/charts/{chart_id}/theo/house-roles/{house_number}`	Role each planet plays relative to a target house
`GET /v1/vedic/charts/{chart_id}/theo/house-strength`	Theo house strength: one 0-100 verdict per house, and its four witnesses
`GET /v1/vedic/charts/{chart_id}/theo/houses`	Theo — house power (strength weighted by connection) and its support
`GET /v1/vedic/charts/{chart_id}/theo/planets`	Theo — how strong each planet is, and how benefic, as two separate answers
`GET /v1/vedic/charts/{chart_id}/theo/sign-influences`	Per-sign connection and, from the lagna, whether it reads as support
`GET /v1/vedic/charts/{chart_id}/theo/thematic/{area}`	Houses + karakas + activated planets for one life area
`GET /v1/vedic/charts/{chart_id}/transit-events`	Transit ingress, retrograde, nakshatra, and pada events
`GET /v1/vedic/charts/{chart_id}/transit-modifiers`	Per-planet transit-quality modifier (SAV + Bhinnashtaka at transit)
`GET /v1/vedic/charts/{chart_id}/transits`	Transit chart and natal overlays at a moment
`GET /v1/vedic/charts/{chart_id}/transits/contacts`	Transit-vs-natal aspect / conjunction contacts at a moment
`GET /v1/vedic/charts/{chart_id}/transits/navamsa-activations`	Transiting planets sharing a D9 sign with natal planets
`GET /v1/vedic/charts/{chart_id}/ux/daily-personal-weather`	Vedic daily personal weather UX cards
`GET /v1/vedic/charts/{chart_id}/ux/next-important-period`	Next important Vedic period/event UX card
`GET /v1/vedic/charts/{chart_id}/ux/profile-summary-cards`	Vedic profile summary cards for frontend surfaces
`GET /v1/vedic/charts/{chart_id}/ux/timeline-cards`	Vedic dasha/transit timeline cards
`GET /v1/vedic/charts/{chart_id}/varga-dignity`	Own-sign hit count across the Shodasha-varga group per planet
`GET /v1/vedic/charts/{chart_id}/varga-strength`	Own-sign and repeated-sign strength patterns across core vargas
`GET /v1/vedic/charts/{chart_id}/vargas`	Core Vedic divisional charts (D1, D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D45, D60)
`GET /v1/vedic/charts/{chart_id}/vargas/{varga}`	Deprecated. Get one Vedic divisional chart by Varga code
`GET /v1/vedic/charts/{chart_id}/varshaphala/{age_years}`	Varshaphala — annual chart for a specific age (Muntha + solar return)
`GET /v1/vedic/charts/{chart_id}/vimshopaka/{planet}`	Vimshopaka bala 0..20 for a planet in a varga group
`GET /v1/vedic/charts/{chart_id}/yoga-summary-cards`	Frontend-ready positive and challenging yoga cards
`GET /v1/vedic/charts/{chart_id}/yogas`	Detected yogas (Raja, Pancha Mahapurusha, Gajakesari, ...)
`GET /v1/vedic/charts/{chart_id}/yogas/{category}`	Detected yogas filtered by category
`GET /v1/vedic/kp/lookup`	KP sub-lord lookup for an arbitrary longitude (rashi+nak+sub+subsub)
`GET /v1/vedic/muhurta/activity-types`	Supported Muhurta activity taxonomy
`POST /v1/vedic/muhurta/score`	Score one proposed Muhurta moment for an activity
`POST /v1/vedic/muhurta/search`	Search suitable Muhurta windows for an activity
`GET /v1/vedic/panchanga`	Full daily panchanga by civil day, location, and IANA timezone
`GET /v1/vedic/panchanga/current`	Current panchanga factors for a timezone-aware moment and location
`GET /v1/vedic/panchanga/windows`	Auspicious, neutral, and caution Panchanga windows for a day
`POST /v1/vedic/relationships/doshas`	Vedic relationship doshas with Kuja/Manglik cancellation evidence
`POST /v1/vedic/relationships/highlights`	Vedic relationship highlights, overlays, and Upapada comparison
`POST /v1/vedic/relationships/kuta`	Detailed Vedic Ashtakoota relationship dimensions
`POST /v1/vedic/relationships/report`	Unified Vedic relationship report with Kuta, dosha, D9, and Upapada layers
`POST /v1/vedic/relationships/topics`	Vedic relationship topic cards for Moon, Venus, Mars, Jupiter, and Lagna
`GET /v1/vedic/sky/ingresses`	Sign changes in the sky between two moments, in either zodiac
`POST /v1/vedic/ux/relationship-highlights`	Vedic relationship highlight UX cards
`GET /v1/vedic/vaishnava/calendar`	The Gaudiya (ISKCON) calendar for a range of days at one place
`GET /v1/vedic/vaishnava/upcoming`	The next days that carry something, after a given day

Math fidelity¶

Every calculation carries a # Reference: astrolink/<file>:<line> docstring pointing at the source line in the original engine. Tests lock golden values (e.g. SAV must total exactly 337 bindus, the Vimshottari cycle length is exactly 120 years, etc.) so divergence would surface immediately.

Quick example: end-to-end Vedic chart pipeline¶

# 1. Build the natal chart.
CHART=$(curl -s -X POST https://api.astrolinkers.com/v1/charts \
  -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "birth": {
      "moment": "1990-06-15T09:30:00+05:30",
      "latitude": 28.6139,
      "longitude": 77.2090
    },
    "system": "vedic",
    "house_system": "whole_sign",
    "ayanamsha": "lahiri"
  }' | jq -r .id)

# 2. Pull every classical Vedic layer.
curl -s -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/dasha/vimshottari" | jq .
curl -s -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/shadbala" | jq .
curl -s -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/ashtakavarga" | jq .
curl -s -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/yogas" | jq .
curl -s -H "Authorization: Bearer $ASTROLINKERS_API_KEY" \
  "https://api.astrolinkers.com/v1/vedic/charts/$CHART/jaimini/karakas" | jq .

Source¶

All Vedic services live under src/astro_platform/services/astrology/vedic/ in the astro-platform repo. Domain tables (nakshatras, vargas, BPHS bindu tables, dignity points, drishti curves) are in src/astro_platform/domain/astrology/vedic/.