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.
• Данные рождения читаются, используются и забываются: тела запросов никогда не сохраняются.

В ИИ-ассистенте

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

Другие возможности API

Тот же ключ открывает весь астрологический API: натальные карты, ежедневные транзиты, синастрию, транзиты за период, соляры, лучшие дни и астрокартографию. Все эндпоинты, поля и ошибки описаны в документации, а на странице цен объяснено, что считается запросом.

Вопросы