# API драконічної карти

Перезакріплює весь зодіак на Висхідному вузлі Місяця. Зсуває 0° Овна на натальний Висхідний вузол, і кожна планета перечитується у вузловій — «драконічній» — довготі. Передайте натальну карту — отримаєте планети, доми й аспекти, виражені в драконічному каркасі. Точність Swiss Ephemeris, відповідь у JSON.

## Ендпоінт

`POST /v1/draconic`

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

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

Драконічний ендпоінт обчислює стандартну тропічну карту з даних народження, а потім обертає весь зодіак так, щоб Висхідний вузол Місяця опинився на 0° Овна. Кожна довгота планети зсувається на ту саму величину — від кожної віднімається тропічна позиція вузла — перевиражаючи всю карту у вузлових, або драконічних, координатах, зберігаючи всі відносні кутові співвідношення між тілами. Відповідь повертає драконічні планети з їхніми новими знаками й положеннями в домах, куспіди домів у поверненому каркасі й повну сітку аспектів із позначками наближення й розходження та точними орбісами. Оскільки обертання жорстке, аспекти між планетами лишаються незмінними; змінюється те, які знаки й градуси вони займають. Драконічну карту традиційно читають як накладення рівня душі чи кармічне, внутрішній візерунок під тропічною картою особистості.

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

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

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

| 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). |

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

```bash
curl -X POST https://api.astroway.info/v1/draconic \
  -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
}'
```

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

```json
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Sun",
        "longitude": 211.6,
        "sign": "Scorpio",
        "house": 4
      }
    ],
    "houses": {
      "ascendant": 318,
      "mc": 228,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ],
    "chartSect": "day"
  }
}
```

## Нотатки

Обертання закріплене на Висхідному вузлі Місяця, розміщуючи його на 0° Овна; усі тіла зсуваються на тропічну довготу вузла, тож міжпланетні аспекти зберігаються, а змінюються лише положення за знаком і градусом. Читайте її як кармічне накладення на тропічну карту, а не як заміну. Доми за обраною системою в поверненому каркасі; усе похідне від тропічного й Swiss Ephemeris.

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

- https://api.astroway.info/astrology-api/heliocentric-chart/
- https://api.astroway.info/astrology-api/natal-chart/

---

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