API гороскопів

Запит

Справжній запит для демонстраційної карти:

curl -X POST https://api.natalchart.ai/v1/horoscope/daily \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"date":"2026-09-18"}'

Відповідь

Частина відповіді на цей запит: основні поля, кожен список скорочено до перших трьох елементів.

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

Що повертається

• positions: де перебуває кожне тіло опівдні за UTC у цю дату, за знаком і градусом.
• moon: фаза та освітлена частка, знак Місяця, а також найближчі молодик і повня.
• events: події на небі на найближчий тиждень, як-от переходи в нові знаки й стаціонарності.
• transits: за наявності даних народження кожен транзит до натальної карти з аспектом, орбісом, тим, сходиться він чи розходиться, моментом точного аспекту й натальним домом, у якому перебуває транзитне тіло.
• focus: три контакти, що посідають найвищі місця за швидкістю планети й точністю, кожен із полем tone за фіксованим правилом (тригон і секстиль сприятливі, квадрат і опозиція напружені, з'єднання посилює).

Обмеження

• Безкоштовний ключ: 10 запитів на добу; API Pro: 1 000.
• Орбіси транзитів: 2° для Місяця, Сонця, Меркурія, Венери й Марса, 3° для повільніших тіл.
• Жодних текстів за знаками Сонця й жодного згенерованого тексту: ендпоінт повертає числа для однієї карти.
• Дані народження зчитуються, використовуються й забуваються: тіла запитів ніколи не зберігаються.

В AI-асистенті

Через MCP-сервер за адресою https://www.natalchart.ai/mcp асистенти викликають інструмент daily_transits і пишуть гороскоп на основі обчислених транзитів, а не вигадують їх.

Інші можливості API

Той самий ключ відкриває весь астрологічний API: натальні карти, щоденні транзити, синастрію, транзити за період, соляри, найкращі дні й астрокартографію. Усі ендпоінти, поля й помилки описано в документації, а на сторінці цін пояснено, що вважається запитом.

Запитання