API NatalChart.AI открывает разработчикам расчётный движок приложения NatalChart.AI. Отправьте дату, время и координаты рождения и получите карту: не нужно размещать у себя файлы эфемерид, поддерживать таблицы часовых поясов и обновлять астрологическую библиотеку.
Что можно создать
Страницы с натальной картой
Солнце, Луна и восходящий знак, каждая планета в своём знаке и доме, аспекты с орбисами и баланс стихий для любой даты рождения с 1800 по 2399 год. /v1/chart/full, /v1/chart/short
Гороскопы на день по реальному небу
Транзиты дня к карте человека, каждый с орбисом и указанием, усиливается он или ослабевает, а также фаза Луны и события на небе на неделю. /v1/horoscope/daily, /v1/sky
Совместимость для сервисов знакомств
Сравнение двух карт: все аспекты между ними, положение планет каждого человека в домах другого и оценка по каждой сфере жизни. /v1/synastry
Прогнозы и предстоящий год
Каждый точный транзит за период до 92 дней и карта соляра на любой год для места рождения или для того места, где человек будет находиться. /v1/transits, /v1/solar-return
Лучшие дни
Оценка каждого дня периода для выбранного занятия (бизнес, романтика, путешествия, здоровье и не только) с транзитами, которые ему помогают и мешают. /v1/timing
Астрокартография и релокация
Оценка одного города по карте или рейтинг крупных городов мира для неё по сферам жизни и регионам. /v1/locations/score, /v1/locations/rank
Начните за минуту
Создайте ключ (бесплатно, без банковской карты), затем отправьте данные рождения:
curl https://api.natalchart.ai/v1/chart/short \
-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}}'Все эндпоинты, поля и ошибки собраны в документации API, а спецификация OpenAPI описывает их для генераторов кода.
Точность, которую можно проверить
Тропический зодиак, дома по Плацидусу, пять мажорных аспектов, истинный лунный узел, положения с точностью до десятитысячных долей градуса. Часовой пояс определяется по координатам с правилами летнего времени на дату рождения, а если время рождения неизвестно, дома и углы карты не угадываются, а просто не выдаются. Отчёт о точности сравнивает расчёты движка с NASA JPL Horizons, а опубликованная демонстрационная карта позволяет проверить ответ ещё до того, как вы напишете код.
Для ИИ-ассистентов: MCP-сервер
Те же расчёты доступны как MCP-сервер по адресу https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor и VS Code подключаются с тем же ключом и сами вызывают инструменты для карты, транзитов и совместимости, поэтому ассистент читает рассчитанную карту, а не угаданную.
Цены
| Тариф | Цена | Запросы | Эндпоинты |
|---|---|---|---|
| Бесплатно | $0 | 10 в день | Карты и их части, гороскоп на день, небо, статистика использования |
| API Pro | $6.99 в месяц | 1 000 в день | Всё: транзиты, синастрия, соляры, лучшие дни, места |
Лимит действует на аккаунт и восполняется в 00:00 UTC. Запрос, отклонённый как некорректный, не засчитывается, а данные рождения никогда не сохраняются: в журнале остаются только эндпоинт, статус и время.
Вопросы
Есть ли бесплатный астрологический API?
Да. Ключ NatalChart.AI бесплатен и даёт 10 запросов в день: натальные карты целиком или по частям, небо на день с транзитами к карте и положения планет на любую дату. Банковская карта не нужна. API Pro ($6.99 в месяц) поднимает лимит до 1 000 в день и открывает транзиты за период, синастрию, соляры, лучшие дни и астрокартографию.
Насколько точны расчёты?
Положения рассчитывает библиотека Swiss Ephemeris, стандарт профессиональных астрологических программ, с её файлами данных и включённым флагом скорости. Тот же движок строит каждую карту в приложении NatalChart.AI, а отчёт о точности сравнивает его результаты с NASA JPL Horizons.
Можно ли сделать на этом API приложение с гороскопами или совместимостью?
Да, для этого он и создан: страницы с натальной картой, гороскопы на день по реальным транзитам, оценки совместимости для сервисов знакомств, подбор лучших дней и карты релокации. Коммерческое использование разрешено на обоих тарифах; храните ключ на своём сервере.
Возвращает ли API текстовые трактовки?
Нет. API рассчитывает и возвращает числа: знаки, градусы, дома, аспекты с орбисами, оценки по сферам жизни. Обращений к ИИ нет, поэтому одни и те же входные данные всегда дают один и тот же результат, а слова остаются за вами или вашей моделью.
С какими языками программирования и фреймворками работает API?
С чем угодно, что умеет отправить HTTPS-запрос с телом в формате JSON: JavaScript, Python, PHP, Swift, Kotlin, инструменты no-code. В документации есть готовые примеры для копирования, а спецификация OpenAPI описывает каждый эндпоинт для генераторов кода.
Могут ли ИИ-ассистенты пользоваться API?
Да, через MCP-сервер: Claude, ChatGPT, Cursor и VS Code подключаются к нему с тем же ключом и вызывают расчёты как инструменты.