API синастрии

Запрос

Настоящий запрос для двух вымышленных людей: один с демонстрационными данными рождения в Киеве, второй родился в Нью-Йорке.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

Ответ

Часть ответа на этот запрос: основные поля, каждый список сокращён до первых трёх элементов.

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

Что возвращается

• aspects: каждый мажорный аспект между телом одной карты и телом другой, с углом и орбисом.
• overlays: в какие дома карты другого человека попадают планеты каждого, в обе стороны. Одна из сторон равна null, если время рождения другого человека неизвестно, потому что дома зависят от него.
• sphereScores: оценки сфер «Я», «Любовь», «Тело», «Деньги», «Дом» и «Разум», каждая от 0 до 100, которые складываются из аспектов синастрии (60%) и наложения домов (40%).
• scoring: правило, по которому считаются оценки, указанное прямо в ответе. Оно описывает геометрию двух карт, а не будущее отношений.

Ограничения

• Только API Pro. С бесплатным ключом эндпоинт отвечает кодом 403 и ссылкой для перехода на API Pro.
• Даты рождения с 1800 по 2399 год. Тропический зодиак, дома по Плацидусу, пять мажорных аспектов.
• Без геокодирования: передавайте координаты. Часовой пояс определяется по ним с правилами летнего времени на дату рождения.
• Данные рождения читаются, используются и забываются: тела запросов никогда не сохраняются.

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

MCP-сервер по адресу https://www.natalchart.ai/mcp предлагает тот же расчёт в виде инструмента synastry, поэтому Claude, ChatGPT или Cursor могут сравнить две карты, прежде чем говорить о совместимости.

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

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

Вопросы