AstroWay/api v2.130.2 · astrology-api
усі системи в нормі
// astrology api · POST /v1/symbolic-directions

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

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

Ендпоінт
POST /v1/symbolic-directions
Вартість
50 кредитів
Латентність
~50 ms
Тариф
Tier 3
// 01 / Що обчислює

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

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

// 02 / Живий запит

POST/v1/symbolic-directions

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"
}'
Відповідь (фрагмент)
{
  "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
    }
  }
}
// 03 / Параметри

Параметри

nametypeОбов’язк.
date string (YYYY-MM-DD) так Birth date.
time string (HH:MM:SS) так Local clock time at birth.
timezoneOffset number (hours) так UTC offset in effect at the birth moment. Decimal allowed for half-hour zones.
latitude number так Birth-place latitude, decimal degrees (north positive).
longitude number так Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) так The date the chart is directed to.
key string ні 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 ні Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc.
// 04 / Коли використовувати

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

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

// 05 / Нотатки

Нотатки

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

Спробуйте Дирекції солярної дуги API

Отримайте ключ і зробіть перший виклик за хвилину.

99.9% SLA · платні плани · 30d status →