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, а опублікована демонстраційна карта дає змогу перевірити відповідь ще до того, як ви напишете хоч рядок коду.
Для AI-асистентів: MCP-сервер
Ті самі обчислення доступні як MCP-сервер за адресою https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor і VS Code підключаються з тим самим ключем і самі викликають інструменти для карти, транзитів і сумісності, тож асистент читає карту, яку обчислено, а не вгадано.
Тарифи
| План | Ціна | Запити | Ендпоінти |
|---|---|---|---|
| Free | $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 обчислює й повертає числа: знаки, градуси, доми, аспекти з орбісами, оцінки для кожної сфери життя. AI не викликається, тож ті самі вхідні дані завжди дають той самий результат, а слова лишаються за вами чи за вашою моделлю.
З якими мовами програмування й фреймворками працює API?
З усім, що може надіслати HTTPS-запит із тілом у JSON: JavaScript, Python, PHP, Swift, Kotlin, інструменти no-code. У документації є приклади, які можна скопіювати й вставити, а документ OpenAPI описує кожен ендпоінт для генераторів коду.
Чи можуть AI-асистенти користуватися цим API?
Так, через MCP-сервер: Claude, ChatGPT, Cursor і VS Code підключаються до нього з тим самим ключем і викликають обчислення як інструменти.