# API дирекцій солярної дуги

Солярна дуга рухає всю карту вперед на одне число: відстань, яку пройшло Сонце за вторинною прогресією. Кожна планета, кожен куспід і обидві осі зсуваються на ту саму дугу, тож натальний аспект, якому бракувало двох градусів до точного, стає точним приблизно за два роки. Цей ендпоінт віддає скеровану карту й дугу, що її утворила.

## Ендпоінт

`POST /v1/symbolic-directions`

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

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

За даними народження та цільовою датою ендпоінт спершу прогресує карту за принципом «день за рік», міряє, наскільки прогресоване Сонце відійшло від натального положення, і бере цю відстань за дугу. Далі він додає дугу до всіх натальних довгот одразу: до планет, до куспідів домів, до асценденту й MC. Відповідь несе скеровані положення у data.planets і data.houses, саму дугу в градусах у data.arc, а ключ, що її утворив, у data.key. Оскільки єдина дуга застосовується рівномірно, геометрія натальної карти зберігається, і змінюється лише її співвідношення з натальними градусами. Саме це робить техніку такою ощадною для читання: одне число описує стан усієї карти у певному віці. На тому ж ендпоінті доступні ще два ключі. Передайте naibod для середньої сонячної швидкості 59'08.3" на рік або не передавайте нічого для звичайного градуса на рік. Значення converse true скеровує назад від моменту народження замість уперед, обертаючи знак дуги.

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

Беріть солярну дугу, коли потрібен таймінг радше символічний, ніж астрономічний, і коли він має лишитися зрозумілим читачеві. Оскільки все рухається з однією швидкістю, скерований контакт випадає на конкретний рік, а не на проміжок, і це пасує стрічці життєвих подій, звіту про віковий рубіж або AI-наративу, що має сказати, про що саме цей рік. Техніка природно поєднується з вторинними прогресіями, бо дуга виводиться з того самого прогресованого Сонця: прогресії дають рухому внутрішню карту, солярна дуга переносить уперед карту цілком. Порівнюйте три ключі, якщо точність важлива вашій аудиторії. Солярна дуга йде за фактичним Сонцем і тому трохи різниться залежно від дати народження, Найбода бере середню швидкість, а градус на рік є умовністю круглого числа. Для народженого в середині травня три ключі дають приблизно 34.5, 35.5 і 36.0 градуса за 36 років: досить близько, щоб зійтися на десятилітті, і досить далеко, щоб назвати різні роки.

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

| 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. 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 | The date the chart is directed to. |
| `key` | string | no | Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year). |
| `converse` | boolean | no | Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc. |

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

```bash
curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -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-05-15",
  "key": "solar_arc"
}'
```

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

```json
{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}
```

## Нотатки

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

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

- https://api.astroway.info/astrology-api/secondary-progressions/
- https://api.astroway.info/astrology-api/natal-chart/
- https://api.astroway.info/astrology-api/solar-return/

---

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