# API альмутена фігури

Альмутен фігури є традиційною відповіддю на питання, якого сучасна карта уникає: яка одна планета має найсильніші права на цю нативність. Його вирішує підрахунок достоїнств по ключових місцях карти, а ендпоінт віддає і переможця, і повний підрахунок.

## Ендпоінт

`POST /v1/almuten`

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

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

Ендпоінт будує натальну карту й оцінює кожну з семи класичних планет за есенційним достоїнством, яке вона має над вирішальними положеннями фігури. Кожна планета накопичує бали там, де керує через доміциль, екзальтацію, тригон, терм і фас, після чого суми порівнюються. Відповідь дає планету-переможця, її бал і бали всіх семи, щоб було видно, наскільки близьким був двобій, а поруч карту, на якій рахувалося. У прикладі Венера перемагає з 23 проти Меркурія й Сатурна, що поділили 14, тож вердикт впевнений, а не крайовий, і ця різниця видима у відповіді, а не схована за одним іменем. Оскільки розрахунок спирається на асцендент, час народження важить тут більше, ніж для функції за сонячним знаком: зсув у кілька хвилин може перевести асцендент в інший терм і змінити підрахунок.

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

Беріть альмутена, коли продукту потрібна одна планета, навколо якої вишикується решта. Він прямо відповідає на питання про управителя для традиційного прочитання карти, дає звіту хребет для наративу й забезпечує AI-інтерпретацію єдиним якорем замість десяти рівнозначних положень. Він природно стоїть поруч з ендпоінтом есенційних достоїнств, що показує підрахунок докладно, і поруч із профекціями, де управитель року є тією самою ідеєю, застосованою до часу, а не до цілого життя. Повернені бали варто показувати користувачеві, коли перші два близькі, бо вузька перемога є справжнім астрологічним твердженням про карту, поділену між двома управителями.

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `date` | string (YYYY-MM-DD) | yes | Birth date. |
| `time` | string (HH:MM:SS) | yes | Local clock time at birth. The almuten depends on the ascendant, so an accurate time matters here. |
| `timezoneOffset` | number (hours) | yes | UTC offset in effect at the birth moment. |
| `latitude` | number | yes | Birth-place latitude, decimal degrees (north positive). |
| `longitude` | number | yes | Birth-place longitude, decimal degrees (east positive). |
| `houseSystem` | string | no | House system code, P for Placidus by default. |

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

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

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

```json
{
  "ok": true,
  "data": {
    "almuten": {
      "planet": "Venus",
      "score": 23,
      "scores": {
        "Sun": 1, "Moon": 8, "Mercury": 14, "Venus": 23,
        "Mars": 9, "Jupiter": 2, "Saturn": 14
      }
    },
    "chart": { "planets": [], "houses": {} }
  }
}
```

## Нотатки

Підрахунок іде за традиційними п'ятьма есенційними достоїнствами: доміциль, екзальтація, тригон, терм і фас, зважені класичним чином і накопичені по вирішальних положеннях фігури. Оцінюються сім класичних планет; сучасні зовнішні у цій схемі управління не мають. Карта рахується рушієм Swiss Ephemeris у тропічному зодіаку.

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

- https://api.astroway.info/astrology-api/essential-dignities/
- https://api.astroway.info/astrology-api/natal-chart/
- https://api.astroway.info/astrology-api/annual-profections/

---

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