# API дерев середин

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

## Ендпоінт

`POST /v1/midpoint-trees`

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

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

За моментом і місцем народження ендпоінт бере довготи планет і обчислює середини між парами, а потім шукає в карті будь-яку планету, що стоїть на одній із цих середин — і прямий контакт, де тіло потрапляє на буквальний серединний градус, і непрямі контакти, які диск виявляє через свої гармоніки жорстких аспектів. Для кожної планети він збирає серединні картини, у яких вона бере участь, у дерево середин — структуру, яку космобіологи записують як A = B/C, — і повертає їх у data.trees. Поряд він виявляє симетрії конфігурації — точки, де карта згортається сама на себе, — і повертає їх у data.symmetries. Ефект полягає в перепрочитанні карти не як планет у знаках і домах, а як павутини рівновіддалених відношень, що саме так школа Ебертіна зважує вплив: планета, що завершує середину двох інших, вважається фокусом, де розряджається їхнє поєднане значення.

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

Звертайтеся до цього ендпоінта, коли будуєте для аудиторії космобіології та уранічної астрології чи для будь-якого інтерпретатора, що хоче серединні картини, а не класичні аспекти — для інструмента 90° диска, звіту в стилі Ебертіна чи аналізатора карти, що ранжує фокусні планети. Дерева дають готову структуру для рендерингу й тлумачення: перелічіть картини, на вершині яких стоїть планета, і ви маєте ядро космобіологічної делінеації. Надішліть ті самі дані народження, що й ендпоінту natal-chart, і структура середин ляже на ідентичні положення планет, тож обидва погляди описують одну карту. Оскільки вивід відокремлює дерева по планетах від загальносхемних симетрій, ви можете обрати, що показати — сфокусоване читання по планеті чи глобальну картину того, де карта структурно навантажена.

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

| 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/midpoint-trees \
  -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": {
    "trees": [
      {
        "planet": "Sun",
        "pictures": [
          "Moon/Venus",
          "Mars/Jupiter"
        ]
      }
    ],
    "symmetries": [
      "…"
    ]
  }
}
```

## Нотатки

Метод слідує космобіології Райнгольда Ебертіна, викладеній у «The Combination of Stellar Influences», працюючи в традиції 90° диска, де вагу несуть середини жорстких аспектів. Довготи планет беруться з рушія Swiss Ephemeris (Astrodienst) на WASM у тропічному зодіаку, тож середини й дерева тримаються на тих самих положеннях, що й натальні ендпоінти.

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

- https://api.astroway.info/astrology-api/arabic-parts/
- https://api.astroway.info/astrology-api/declinations/

---

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