POST/api/astro/mundane-charts/1 кредит

Мунданні карти інгресій

Карти інгресій, за якими судять про ведичний рік. Світова карта асцендента на момент сонячної інгресії, карта Ардра-правеш, яку тлумачать щодо мусону, і карти літнього та осіннього врожаю. Для кожної вказано точний момент, на який її побудовано, і повний набір положень планет на цей момент — саме за цими картами насправді й складають річні прогнози в альманахах. Велика відповідь: чотири повні карти плюс час інгресії.

https://api.occultapi.com/api/astro/mundane-charts/

Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

Поле	Тип	Обов’язкове	Примітки
date_time	string (date-time)	обов’язковий	Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні.
latitude	number (double)	обов’язковий	Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90
longitude	number (double)	обов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180
timezone_as_float	number (double)	обов’язковий	Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14
year	integer	обов’язковий	Рік народження числом, напр. 1990. Чотири цифри.
keys	array	необов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.
nakshatra	string	необов’язковий	Зчитується лише в /nakshatra-chakras/; в інших місцях ігнорується.

Приклад запиту

curl -X POST https://api.occultapi.com/api/astro/mundane-charts/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Відповідь

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2025, \"charts\": [{\"chart\": \"jagat_lagna_chart\", \"describes\": \"World ascendant chart, cast at the solar ingress\", \"result\": {\"ingress_time\": \"2025-04-13T21:51:25Z\", \"chart\": {\"celestial\": {\"sun\": {\"longitude\": {\"degree\": 0, \"sign\": \"Ar\", \"minutes\": 0, \"seconds\": 0}, \"latitude\": -0.0, \"nakshatra\": \"Ashwini\", \"pada\": 1, \"kakshya\": \"saturn\", \"zodiac_name\": \"Aries\", \"house\": 3}, \"moon\": {\"longitude\": {\"degree\": 9, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 32}, \"latitude\": -3.122, \"nakshatra\": \"Swaati\", \"pada\": 1, \"kakshya\": \"mars\", \"zodiac_name\": \"Libra\", \"house\": 9}, \"mercury\": {\"longitude\": {\"degree\": 4, \"sign\": \"Pi\", \"minutes\": 22, \"seconds\": 15}, \"latitude\": -1.443, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"venus\": {\"longitude\": {\"degree\": 0, \"sign\": \"Pi\", \"minutes\": 25, \"seconds\": 44}, \"latitude\": 4.46, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"mars\": {\"longitude\": {\"degree\": 4, \"sign\": \"Cn\", \"minutes\": 4, \"seconds\": 4}, \"latitude\": 2.355, \"nakshatra\": \"Pushyami\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Cancer\", \"house\": 6}, \"jupiter\": {\"longitude\": {\"degree\": 23, \"sign\": \"Ta\", \"minutes\": 55, \"seconds\": 8}, \"latitude\": -0.276, \"nakshatra\": \"Mrigasira\", \"pada\": 1, \"kakshya\": \"moon\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"saturn\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 47, \"seconds\": 31}, \"latitude\": -1.959, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"uranus\": {\"longitude\": {\"degree\": 1, \"sign\": \"Ta\", \"minutes\": 10, \"seconds\": 37}, \"latitude\": -0.219, \"nakshatra\": \"Krittika\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"neptune\": {\"longitude\": {\"degree\": 6, \"sign\": \"Pi\", \"minutes\": 19, \"seconds\": 1}, \"latitude\": -1.269, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"pluto\": {\"longitude\": {\"degree\": 9, \"sign\": \"Cp\", \"minutes\": 30, \"seconds\": 25}, \"latitude\": -3.489, \"nakshatra\": \"Uttaraashaadha\", \"pada\": 4, \"kakshya\": \"mars\", \"zodiac_name\": \"Capricorn\", \"house\": 12}, \"northtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Pi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"northmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"southtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Vi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}, \"southmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Vi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}}, \"houses\": {\"1\": {\"start\": \"18 Cp 10 4\", \"cusp\": \"3 Aq 10 4\", \"end\": \"18 Aq 10 4\"}, \"2\": {\"start\": \"18 Aq 10 4\", \"cusp\": \"3 Pi 10 4\", \"end\": \"18 Pi 10 4\"}, \"3\": {\"start\": \"18 Pi 10 4\", \"cusp\": \"3 Ar 10 4\", \"end\": \"18 Ar 10 4\"}, \"4\": {\"start\": \"18 Ar 10 4\", \"cusp\": \"3 Ta 10 4\", \"end\": \"18 Ta 10 4\"}, \"5\": {\"start\": \"18 Ta 10 4\", \"cusp\": \"3 Ge 10 4\", \"end\": \"18 Ge 10 4\"}, \"6\": {\"start\": \"18 Ge 10 4\", \"cusp\": \"3 Cn 10 4\", \"end\": \"18 Cn 10 4\"}, \"7\": {\"start\": \"18 Cn 10 4\", \"cusp\": \"3 Le 10 4\", \"end\": \"18 Le 10 4\"}, \"8\": {\"start\": \"18 Le 10 4\", \"cusp\": \"3 Vi 10 4\", \"end\": \"18 Vi 10 4\"}, \"9\": {\"start\": \"18 Vi 10 4\", \"cusp\": \"3 Li 10 4\", \"end\": \"18 Li 10 4\"}, \"10\": {\"start\": \"18 Li 10 4\", \"cusp\": \"3 Sc 10 4\", \"end\": \"18 Sc 10 4\"}, \"11\": {\"start\": \"18 Sc 10 4\", \"cusp\": \"3 Sg 10 4\", \"end\": \"18 Sg 10 4\"}, \"12\": {\"start\": \"18 Sg 10 4\", \"cusp\": \"3 Cp 10 4\", \"end\": \"18 Cp 10 4\"}}, \"ascendant\": {\"longitude\": {\"degree\": 3, \"sign\": \"Aq\", \"minutes\": 10, \"seconds\": 4}, \"zodia"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.