API соляра

Запрос

Настоящий запрос: соляр демонстрационной карты на 2027 год для места рождения.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

Ответ

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

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

• exactMomentUtc: момент, когда Солнце снова достигает своей натальной долготы, по UTC.
• location: место, для которого строится карта; место рождения, если вы не передали другое.
• natalSun: долгота натального Солнца, от которой отсчитывается соляр.
• chart: полная карта на этот момент для этого места в той же структуре, что и ответ эндпоинта натальной карты.

Ограничения

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

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

Через MCP-сервер по адресу https://www.natalchart.ai/mcp ассистенты вызывают инструмент solar_return и читают предстоящий год по рассчитанной карте.

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

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

Вопросы