# API вторинних прогресій

Просуває натальну карту символічно вперед: один ефемеридний день руху планет відповідає одному року життя. Передайте натальну карту й цільову дату — отримаєте прогресовану карту (планети, доми, аспекти) для цього віку. Точність Swiss Ephemeris, відповідь у JSON.

## Ендпоінт

`POST /v1/progressions`

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

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

Ендпоінт прогресій застосовує класичну вторинну техніку «день за рік». Він бере натальну дату, час, зсув UTC й місце народження, вимірює кількість років до вашої цільової дати й просуває карту на стільки ж ефемеридних днів після моменту народження — тож тридцять років відповідають небу через тридцять днів після народження. Потім він перетворює цей прогресований момент на юліанський день, бере геоцентричні позиції й швидкості з рушія Swiss Ephemeris і повертає прогресовані планети зі знаками й положеннями в домах, куспіди домів і повну сітку аспектів із позначками наближення й розходження та точними орбісами. Оскільки Місяць рухається приблизно на градус за день, він просувається приблизно на градус за рік життя, що робить прогресований Місяць найшвидшим і найбільш відстежуваним маркером внутрішнього розвитку в карті.

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

Використовуйте вторинні прогресії для повільної внутрішньої сюжетної лінії життя, а не для щоденної погоди транзитів. Вони пасують для звіту «що розгортається цього року», трекера фаз прогресованого Місяця, функції вікових віх чи ШІ-наративу, якому потрібна внутрішня карта, що еволюціонує, у певній точці. Там, де транзити описують зовнішній таймінг від поточного неба, прогресії описують психологічне дозрівання — карту, що визріває зсередини. Обчислюйте їх для дня народження, поворотного моменту чи будь-якого віку, який хочете охарактеризувати, і подавайте прогресовані положення в інтерпретацію поряд із натальною картою й поточними транзитами для багатошарової картини таймінгу. Техніка символічна, тож вона краще відповідає на «яка тема визріває», ніж на «що станеться саме цієї дати».

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Birth-place longitude, decimal degrees (east positive). |
| `targetDate` | string (YYYY-MM-DD) | yes | Required date to progress the chart to (YYYY-MM-DD); the elapsed years set the day-for-a-year advance. |

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

```bash
curl -X POST https://api.astroway.info/v1/progressions \
  -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,
  "targetDate": "2026-06-15"
}'
```

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

```json
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 312.7,
        "sign": "Aquarius",
        "house": 5
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}
```

## Нотатки

Це стандартний вторинний метод «день за рік», що просуває натальну карту на один ефемеридний день за кожен рік життя до цільової дати. Прогресований Місяць рухається приблизно на градус за рік і є головним маркером; зовнішні планети майже не зсуваються. Доми за обраною системою; скрізь тропічний зодіак і Swiss Ephemeris.

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

- https://api.astroway.info/astrology-api/transits/
- https://api.astroway.info/astrology-api/solar-return/

---

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