API транзитів

Запит

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

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

Відповідь

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

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

• window: дати, які ви запитали.
• events: до 60 точних аспектів транзитних тіл до натальних, переходів у нові знаки й стаціонарностей у порядку дат, кожна подія з моментом за UTC, положенням і задіяними домами. Якщо у вікні їх більше, залишаються найзначущіші.
• activeOnFirstDay: транзити, які вже в межах орбісу в перший день, разом із використаними орбісами.
• Кожна подія має значущість (висока, середня чи низька), яка залежить від задіяних тіл.

Обмеження

• Лише API Pro, не більше 92 днів і 60 подій на запит. З безкоштовним ключем ендпоінт відповідає кодом 403 і посиланням для переходу на API Pro.
• Дати народження з 1800 по 2399 рік. Для домів транзиту потрібен час народження; без нього доми не наводяться.
• Кожен точний момент шукається за допомогою Swiss Ephemeris і подається за UTC.
• Дані народження зчитуються, використовуються й забуваються: тіла запитів ніколи не зберігаються.

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

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

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

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

Запитання