Varshaphala (annual chart)

Classical varsha-phala gives one chart per year-of-life, anchored at the solar return (the moment the Sun returns to its natal longitude). The two headline data points are the solar-return moment and the Muntha — a slow-moving point that walks one zodiac sign per year, starting from the natal ascendant.

GET /v1/vedic/charts/{id}/varshaphala/{age_years}

Path param	Type	Meaning
age_years	int (0..120)	Year of life to look up. 0 = birth year.

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

{
  "chart_id": "01HKD…",
  "age_years": 35,
  "solar_return_moment": "2025-06-15T09:30:00+00:00",
  "natal_lagna_sign": "aries",
  "muntha_sign": "pisces",
  "muntha_degree_in_sign": 5.0
}

How to read Muntha

• At age 0, Muntha sits at the natal ascendant — same sign + same degree.
• Each year of life Muntha advances one full sign. So at age 35 it has moved 35 signs from the start (35 mod 12 = 11 → 11 signs forward → Pisces if natal lagna is Aries).
• The Muntha's sign for a given year is the "ruling house" of that year. The house counted from the natal lagna in which Muntha sits flags the area of life under emphasis.

Solar-return moment

Computed by linearly advancing the natal date by age_years × 365.2564 days (mean tropical year). This is an approximation good to about ± 1 day; the exact solar-return moment requires solving for the moment the Sun returns to its natal longitude via ephemeris.

For most non-time-critical reads (year-of-life summaries, Muntha position) the linear approximation is more than enough. When the exact return moment matters (electional astrology, fine-grained Muddha dasha), use a higher-precision pipeline.

Out of scope

The classical Tajaka system layered on top of Varshaphala — Muddha dasha, Sahams (special points like Punya, Vidya, Pati), Pancha-Vargeeya bala (5-fold strength) — remains a future port. Those are independent calculation trees that don't fit the "give me the year's frame" use case this endpoint addresses.