# Річна карта Таджика (варшапхал)

Ведична карта на один рік життя, побудована на момент, коли сидеричне Сонце повертається на свою довготу народження. Повертає вхід у рік із точністю до секунди, річну карту, мунтху з її домом і господарем, п'ятикратну силу для всіх семи грах, п'ятьох претендентів на господаря року і самого господаря в обох прочитаннях, які підтримують джерела.

## Ендпоінт

`POST /v1/vedic/varshaphal`

- Operation ID: `vedic/varshaphal`
- Вартість: 50 кредитів (тариф 3)
- Типова латентність: 190 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/varshaphal/

## Що обчислює

Таджика це окрема школа від парашарі, зі своїми аспектами, своєю мірою сили і своїм таймінгом, і цей ендпоінт рахує її саме так, а не вбирає натальну карту в річний одяг. Рік входить на сидеричному соляр, і це важливіше, ніж звучить: тропічний повернення розходиться з ним на накопичену аянамсу, двадцять хвилин на рік, тож для людини тридцяти шести років ці два моменти стоять за дванадцять годин один від одного і дають різні асценденти. Мунтха стартує з натального лагна і рухається на один знак за кожен завершений рік, повертаючись додому кожного дванадцятого. Панчаваргія бала оцінює кожну граху з двадцяти за її знаком, відстанню від падіння, єгипетською межею, декканом і навамшею. Господаря року обирають серед господарів мунтхи, натального лагна, річного лагна, тригону річного лагна і світила секти.

## Коли використовувати

Беріть для річного читання, якого клієнти джйотіш чекають на день народження, і для будь-якого продукту, якому потрібна ведична рамка на рік, а не на життя. Це доповнення до ендпоінтів даш, а не конкурент: даша каже, який розділ життя відкритий, річна карта каже, як виглядає конкретний рік усередині нього.

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string | yes | Birth date, YYYY-MM-DD. |
| `time` | string | yes | Birth time, HH:mm:ss. |
| `timezoneOffset` | number | yes | Hours from UTC at birth. |
| `latitude` | number | yes | Birth latitude. Required, not defaulted: the muntha starts at the natal lagna. |
| `longitude` | number | yes | Birth longitude. Required for the same reason. |
| `year` | number | yes | Calendar year of the solar return. The year is entered on the birthday of that year, not on 1 January. |
| `entryLatitude` | number | no | Where the year is entered, if not the birthplace. Moves the annual ascendant and every house with it; the planets and the muntha do not move. |
| `entryLongitude` | number | no | Longitude of the year entry. Use with entryLatitude. |

## Приклад запиту

```bash
curl -X POST https://api.astroway.info/v1/vedic/varshaphal \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "year": 2026
}'
```

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "year": 2026,
    "yearsElapsed": 36,
    "pravesh": { "julianDay": 2461176.210016, "utc": "2026-05-15T17:02:25Z" },
    "isDayBirth": true,
    "ascendant": { "sign": 6, "signName": "Libra", "degreeInSign": 25.22 },
    "muntha": { "signName": "Leo", "degree": 26.25, "house": 11, "lordName": "Sun" },
    "varshesha": {
      "planetName": "Venus",
      "role": "varsha-lagnesha",
      "school": "hayanaratna",
      "reason": "aspects the annual ascendant by trine and is the strongest of the 3 that do (Vishwa 14.76)"
    },
    "varsheshaByStrength": { "planetName": "Venus", "school": "charak" }
  }
}
```

## Нотатки

Господар року повертається двічі навмисно. Класичне правило в «Хаянаратні» Балабхадри вимагає, щоб претендент спершу аспектував річний асцендент, і лише тоді дивиться на силу; сучасна практика зазвичай бере найсильнішого з п'яти одразу. Ці два прочитання можуть розійтися, тому відповідь несе обидва, називає, яке з них дало який результат, і показує причину вибору класичного. Відвантажено п'ять сахамів, а не тридцять п'ять, які часто наводять: той довший перелік спирається на одне вторинне джерело і містить формули-дублікати та розбіжність за сектою, тож решта чекає на друге джерело. Поправка на доданий знак у сахамі перевіряється по асценденту, бо саме його називає правило: чотири сахами з п'яти й так додають асцендент, Мітра додає Венеру, тож зрушити прочитання може лише її, і рівно на один знак. Мудда-даші тут немає з тієї ж причини, і документація каже це прямо, а не лишає з'ясовувати самому.

## Пов’язані техніки

- https://api.astroway.info/astrology-api/vedic-shadbala/
- https://api.astroway.info/astrology-api/vedic-dasha/
- https://api.astroway.info/astrology-api/vedic-vargas/
- https://api.astroway.info/astrology-api/solar-return/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md