Астрология мировых событий

Отслеживайте мировые события с API Мунданной Астрологии

Один endpoint ищет восемь семейств небесных событий в окне до пяти лет: ингрессы, станции, новолуния, затмения и соединения Юпитера с Сатурном.

Без карты рождения. Без натальных данных. Только небо.

~20ms

Самый быстрый запрос (4 ингресса)

Семейств событий

5 лет

Макс. окно поиска

С маркировкой Сарос

Солнечные и лунные затмения

Используют 2 800+ разработчиков и астрологов

Доктрина по источникам Птолемея, Лилли и Барбо

Точность Swiss Ephemeris

Для календаря на год вперёд нужны три отдельных расчёта: квартальные ингрессы из одного сервиса, новолуния из другого, затмения из третьего — а затем вы вручную объединяете и сортируете всё это
Чтобы отслеживать ингрессы и станции внешних планет на несколько лет вперёд, приходится писать собственное сканирование эфемерид, а ошибка в интервале выборки либо пропускает события, либо тратит вычисления на лишние проверки
Соединениям Юпитера и Сатурна нужен исторический контекст. Узнать, что соединение произошло, легко. Узнать, сменило ли оно триплицитет по сравнению с предыдущим, означает вручную отслеживать последовательность за десятилетия назад
Данные о затмениях обычно приходят только с одной нумерацией Сарос, и если ваша аудитория пользуется другой, приходится вручную сверять таблицы
Ни один из этих источников не говорит, чем он не является. Обычное сканирование эфемерид не подскажет интерфейсу, что уже идущая ретроградность была просто обрезана окном поиска, а не началась ровно в первый день

Постройте календарь мировых событий с

Отправьте окно дат и нужные типы событий POST-запросом на /mundane/events/search. Ингрессы, новолуния и затмения возвращаются объединёнными в один хронологический список — сортировать на клиенте не нужно
Сканирование ингрессов и станций внешних планет на срок до пяти лет выполняется на сервере с уже настроенной выборкой по каждому телу, поэтому запрос на пять планет за пять лет стоит около 400 замеров эфемерид вместо шестизначного числа
Каждое событие jupiter_saturn_conjunction несёт свой триплицитет и триплицитет предыдущего соединения, а флаг is_triplicity_change вычисляется автоматическим сканированием назад за пределы вашего окна
Каждое затмение явно указывает свою нумерацию Сарос (ван ден Берг/NASA), поэтому вы никогда не перепутаете её с системой Янски/Брейди, которой могут пользоваться ваши пользователи
Ретроградные периоды отдельно помечают start_clipped и end_clipped, так что интерфейс может показать «уже идёт», вместо того чтобы рисовать ложную дату начала

Что на самом деле делает endpoint /mundane/events/search

Цифры от самого endpoint'а, а не маркетинговые округления

~20ms

Самый быстрый запрос (4 кардинальных ингресса)

5 лет (1 826 дней)

Макс. окно поиска

Типов событий за один вызов

~400 замеров

Скан ингрессов: 5 планет за 5 лет

Что входит в endpoint поиска мунданных событий

Восемь семейств событий, точные фильтры и данные, которые сами указывают свои границы

sign_ingress

Любое тело, пересекающее любую 30°-ю границу знака, отслеживается с полной точностью на протяжении лет.

cardinal_ingress

Солнце открывает сезон. Отдельная доктрина от sign_ingress, определена только для Солнца.

station

Разворот в ретроградность или директность, возвращается как единичный момент.

retrograde_period

Те же развороты, объединённые в интервал начало/конец, с флагами обрезанного периода.

lunation

Новолуния, полнолуния и (опционально) первая/последняя четверть Луны.

solar_eclipse & lunar_eclipse

Полная серия Сарос, магнитуда и данные о регионе видимости для каждого затмения.

jupiter_saturn_conjunction

Исторически отслеживаемая пара Великого соединения, с историей триплицитета.

Обязательный фильтр event_types

Непустой список; смешивайте любые из восьми семейств в одном запросе.

Параметр bodies

Ограничивает sign_ingress, station и retrograde_period конкретными планетами; по умолчанию — семь классических планет.

Фильтр to_signs

Фильтрует sign_ingress по знаку, в который входит тело, но никогда по знаку, который оно покидает.

Фильтр cardinal_points

Выберите Овен, Рак, Весы, Козерог или оставьте пустым — тогда вернутся все четыре.

Фильтр lunation_phases

По умолчанию только новолуние и полнолуние; добавьте first_quarter или last_quarter, чтобы расширить список.

Пятилетнее окно поиска

date_from и date_to принимают любой диапазон до 1 826 дней.

Серия Сарос и порядковый номер

Нумерация ван ден Берг / NASA, явно указана в saros_numbering.

Явно указанная конвенция магнитуды

magnitude_kind помечает nasa_solar или lunar_umbral, поэтому эти две величины никогда не сравниваются как равные.

Регион точки наибольшей фазы затмения

visibility_regions — это грубая метка, а не полная трасса затмения.

История триплицитета Юпитер-Сатурн

Каждое соединение несёт свою стихию и стихию предыдущего соединения.

Флаг is_triplicity_change

Вычисляется автоматическим сканированием назад за пределы вашего окна поиска.

Поле datetime_is

Указывает, какой из нескольких обоснованных моментов затмения (наибольшая фаза) был опубликован.

is_chart: false у каждого события

Это моменты, а не карты; никаких домов, углов или управителей не прилагается.

start_clipped / end_clipped

Отмечает ретроградные периоды, уже идущие на границе вашего окна поиска.

nearest_syzygy_utc / phase

Кардинальные ингрессы несут ближайшее новолуние или полнолуние, если также запрошен lunation.

precision_seconds у каждого события

Число вместо ничем не подтверждённого «точно», так что вы знаете допуск решателя.

Предварительная проверка стоимости

Отклоняет слишком широкий запрос за миллисекунды с указанием количества замеров, вместо того чтобы держать воркер.

warnings[UNKNOWN_FIELD]

Нераспознанные поля запроса возвращают 200 с именованным предупреждением — никогда молчаливое отбрасывание.

Ответ в виде дискриминированного объединения

Форма каждого события следует его event_type; ни одно поле не является nullable по построению.

Время ответа от ~20мс до ~2с

Быстро для простого запроса ингресса, и всё ещё меньше 2 секунд для скана пяти тел за пять лет.

Один плоский массив events[]

Отсортирован по возрастанию datetime_utc, готов к отрисовке как таймлайн.

Точность Swiss Ephemeris

Геоцентрическая видимая система координат, только тропический зодиак.

Полная поддержка SDK

JavaScript, Python, PHP, Ruby, Swift, Kotlin, плюс обычный REST.

Стандартный конверт ответа v3

То же поведение предупреждений и пагинации, что и у любого другого endpoint'а платформы.

Что такое API Мунданной Астрологии? Руководство по поиску мировых событий

Как /mundane/events/search находит небесные события без карты рождения

Мунданная астрология читает небо для мира, а не для человека. Там, где натальная астрология строит карту на момент чьего-то рождения, мунданная отслеживает моменты, которые принадлежат всем: равноденствие, затмение, Великое соединение. Здесь нет субъекта, нет времени рождения и нет системы домов, привязанной к конкретному месту. Endpoint /mundane/events/search построен вокруг этого различия. Отправьте окно дат и нужные типы событий — в ответ вы получите восемь семейств небесных событий: ингрессы в знак (любое тело пересекает любую 30-градусную границу), кардинальные ингрессы (Солнце открывает сезон), станции и ретроградные периоды, новолуния и полнолуния, солнечные и лунные затмения, соединения Юпитера с Сатурном. Каждое событие возвращается с is_chart: false, потому что это моменты, а не карты. Чтобы построить мунданную карту для конкретного события, нужно место на Земле — углы зависят от широты, а этот endpoint ищет во времени, а не в пространстве. Это также значит, что API не ранжирует события по дому или углу. Исследования по этому вопросу дают неоднозначный результат: в работе Барбо по 404 картам ингрессов и лунаций против начал войн Марс оказался угловым 80 раз при ожидаемых 91 — нулевой результат, который endpoint уважает, не выдумывая никакую оценку. Что он действительно делает — ищет в окне до пяти лет за один вызов, сортирует каждый результат хронологически и снабжает каждое событие достаточным контекстом (серия Сарос, триплицитет, флаги обрезанных периодов), чтобы вы могли построить календарь, триггер планировщика или исследовательский датасет, не сверяясь с тремя другими endpoint'ами.

Данные по затмениям делегируются тому же сервису затмений, что использует вся платформа, а не пересчитываются отдельно, поэтому цифры не могут разъехаться между endpoint'ами.

Каждое затмение явно указывает свою нумерацию Сарос как van_den_Bergh — конвенцию NASA, потому что астрологи, отслеживающие серии Сарос, иногда пользуются вместо неё нумерацией Янски/Брейди, которая может обозначить одно и то же затмение иначе.

magnitude_kind указывает, относится ли значение магнитуды к nasa_solar или lunar_umbral, поскольку эти две конвенции несравнимы, а lunar_umbral по определению равно 0.0 для каждого полутеневого затмения.

Соединения Юпитера и Сатурна рассчитываются по позициям Swiss Ephemeris и возвращают triplicity, previous_triplicity и is_triplicity_change — буквальный флаг смены стихии, а не доктринальное суждение о «Великой мутации».

Каждое значение указывает свою конвенцию, поэтому ничего не смешивается незаметно

1 min read

Чего API намеренно не делает и почему?

Никаких домов, углов, управителей или оценок значимости: каждое событие возвращает is_chart: false, потому что моменту нужно место на Земле, прежде чем он станет картой, а этот endpoint ищет только во времени.

Только тропический зодиак: сидерический ингресс Солнца — это другое событие под названием санкранти, и на 0 градусе сидерического Овна нет равноденствия, поэтому endpoint отказывает в сидерических запросах, а не молча их аппроксимирует.

Никакого вердикта о мутации за пределами is_triplicity_change, поскольку Великие мутации традиции — это датированные, спорные единичные события, а не любая смена стихии.

И неизвестные поля запроса никогда не исчезают бесследно: схема допускает лишние ключи, а нераспознанный вернёт HTTP 200 с записью warnings[UNKNOWN_FIELD], называющей его по имени, так что опечатка в имени поля никогда не будет неотличима от того, что опции просто не существует.

Никаких выдуманных оценок значимости: если endpoint чего-то не знает, он так и говорит

1 min read

Кто строит на API Мунданной Астрологии?

Астрологи-предприниматели, создающие инструменты мунданной и финансовой астрологии, используют его для генерации календарей на год вперёд и автоматической маркировки смены триплицитета без ручного отслеживания истории соединений.

Контент-платформы и новостные или аналитические сайты подтягивают ближайшее затмение или Великое соединение во врезку статьи, не сверяясь самостоятельно с таблицами Сарос.

Исследователи запрашивают многолетние окна данных retrograde_period или jupiter_saturn_conjunction, чтобы изучать периодичность, распределение серий Сарос или частоту смены стихий в масштабе.

Системы планирования и уведомлений запускают задачу в момент наступления станции, ингресса или затмения, фильтруя по одному списку event_types вместо объединения трёх лент.

Это намеренно не продукт для персональных гороскопов: поля subject в запросе нет вообще.

Создан для календарей, планировщиков и исследовательских датасетов, а не гороскопных лент

1 min read

Use Cases

Платформы финансовой и мунданной астрологии

Стройте календари ингрессов, новолуний и затмений на год вперёд для прогнозов подписчикам — со сменой триплицитета Юпитер-Сатурн, помеченной автоматически.

Новостные и аналитические сайты

Подтягивайте ближайшее затмение или Великое соединение во врезку статьи, не отслеживая вручную номера Сарос или историю триплицитета.

Системы планирования и уведомлений

Запускайте push-уведомление или cron-задачу в момент наступления станции, ингресса или затмения, используя один фильтр event_types вместо объединения трёх лент.

Академические и независимые исследования

Запрашивайте пятилетние окна данных retrograde_period или jupiter_saturn_conjunction, чтобы изучать периодичность, распределение серий Сарос или частоту смены стихий в масштабе.

Астрологи-контент-мейкеры

Генерируйте кардинальный ингресс квартала вместе с ближайшей сизигией за один вызов для сезонного разбора, не запрашивая отдельно endpoint новолуний.

Инструменты многолетних прогнозов

Отслеживайте ингрессы и станции внешних планет от Юпитера до Плутона на горизонте в пять лет — медленный костяк любого долгосрочного мунданного прогноза.

Technical Specifications

Флагманский endpoint	POST /api/v3/mundane/events/search
Operation ID	mundane_events_search
Семейства событий	8: sign_ingress, cardinal_ingress, station, retrograde_period, lunation, solar_eclipse, lunar_eclipse, jupiter_saturn_conjunction
Макс. окно поиска	5 лет (1 826 дней)
Самый быстрый ответ	~20ms (четыре кардинальных ингресса)
Самый медленный ответ	~2с (пять лет ингрессов, пять тел)
Тела по умолчанию	Семь классических планет, если bodies не указан
Фильтр знака ингресса	to_signs фильтрует по знаку, в который входит тело (to_sign), никогда по from_sign
Фильтр кардинальных точек	cardinal_points сужает до Ari / Can / Lib / Cap; по умолчанию — все четыре
Фильтр фаз лунации	lunation_phases; по умолчанию только новолуние и полнолуние
Зодиакальная система	Только тропический (options.zodiac_type = Tropic)
Форма ответа	Дискриминированное объединение по event_type, один плоский массив events[]
Данные карты	Отсутствуют. Каждое событие возвращает is_chart: false
Эфемериды	Swiss Ephemeris, геоцентрические видимые
Нумерация Сарос	ван ден Берг / NASA, явно указана в saros_numbering
Магнитуда затмения	magnitude_kind различает nasa_solar и lunar_umbral
Флаги ретроградности	start_clipped / end_clipped отмечают периоды, обрезанные окном поиска
Предварительная проверка стоимости	Слишком широкие запросы отклоняются за миллисекунды с указанием количества замеров
Неизвестные поля	extra='allow'; возвращает 200 с warnings[UNKNOWN_FIELD], никогда не отбрасывается молча
Формат вывода	JSON, события отсортированы по возрастанию datetime_utc

API Мунданной Астрологии против ручной сборки трёх endpoint'ов

Feature	Astrology API	Others
Ингрессы + новолуния + затмения	Один endpoint, один отсортированный список	Три отдельных вызова, объединение вручную
Многолетнее сканирование внешних планет	~400 замеров для 5 планет за 5 лет	Пишете и настраиваете собственное сканирование эфемерид
История триплицитета Юпитер-Сатурн	previous_triplicity + is_triplicity_change вычисляются автоматически	Вручную отслеживаете последовательность соединений
Ясность нумерации Сарос	ван ден Берг / NASA указана явно	Система нумерации часто не указана
Уже идущая ретроградность	Флаги start_clipped / end_clipped	Ложные даты начала или пропущенные периоды
Доктрина открытия кардинального года	Параметр cardinal_points, вы выбираете Овен/Козерог/Весы	Одна доктрина зашита намертво
Неизвестные поля запроса	200 + warnings[UNKNOWN_FIELD]	Молча игнорируются или жёсткая ошибка
Время ответа	~20ms для простого запроса ингресса	1-3 секунды
Цена	$11/месяц за 1 000 запросов	$99-299/месяц
Бесплатный тариф	50 запросов/месяц, всегда бесплатно	50-100 или отсутствует

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Простые, прозрачные цены

Начните бесплатно, масштабируйтесь по мере роста. Без скрытых платежей и сюрпризов.

Всегда бесплатно

Начать бесплатно

Идеально для обучения, тестирования и небольших личных проектов

50 API-запросов/месяц

Базовые натальные карты

5 систем домов

Поддержка сообщества

Pro

$11/месяц

Для небольших приложений и личных проектов

Все базовые эндпоинты
12 систем домов
Поддержка по email

Лучшая цена

Pro Plus

$21/месяц

Для растущих приложений и среднего трафика

Все расширенные эндпоинты
18 систем домов
Интерпретации на основе ИИ
Приоритетная поддержка по email

Ultra

$37/месяц

Для профессиональных астрологических приложений

Расчёт кредитов ↓

Все премиум-эндпоинты
23 системы домов
Продвинутые интерпретации на основе ИИ
Приоритетная поддержка

Планы для больших объёмов

Для приложений корпоративного масштаба

Business

$99/месяц

Для высоконагруженных приложений

Расчёт кредитов ↓

ВСЕ эндпоинты
Готовность к white-label
Индивидуальная настройка ИИ
Поддержка по телефону

БЕЗЛИМИТ

Enterprise

$399+в месяц

Безлимитные запросы с выделенной инфраструктурой

Выделенная серверная инфраструктура
Гарантированная задержка менее 300 мс
Круглосуточная выделенная поддержка 24/7
SLA с аптаймом 99,99%

Все планы включают подробную документацию и SDK

Есть вопросы? Поговорите с нашей командой

FAQ по API Мунданной Астрологии

Что произойдёт, если отправить поле, которое API не распознаёт?

Pricing

Сколько стоит API Мунданной Астрологии?

Pricing

Есть ли бесплатный тариф для тестирования поиска мунданных событий?

Дополните стек мировых событий

API Мунданной Астрологии лучше всего работает вместе с нашими инструментами на основе карт. Добавьте

Новое: /mundane/events/search выдаёт 8 семейств событий за один вызов

Ищите небо. А не три разных API.

Отправьте окно дат POST-запросом. Получите ингрессы, станции, новолуния, затмения и Великие соединения одним отсортированным списком — меньше чем за 2 секунды даже для пяти лет.

~20ms

Самый быстрый запрос

Семейств событий

5 лет

Макс. окно

Начать бесплатно сейчас

30-дневный возврат денег

Бесплатная помощь с миграцией

Без установочных сборов

"Мы заменили три отдельных вызова — для ингрессов, новолуний и затмений — одним запросом /mundane/events/search. Функцию календаря на год вперёд мы выпустили за день вместо целого спринта."

Elena R.

Основатель, SkyCycles

Выпустите календарь мировых событий уже сегодня

Интеграция обычно занимает меньше часа. Каждое семейство событий доступно на бесплатном тарифе.

Что такое API Мунданной Астрологии? Руководство по поиску мировых событий

Как /mundane/events/search находит небесные события без карты рождения

Use Cases

Платформы финансовой и мунданной астрологии

Новостные и аналитические сайты

Системы планирования и уведомлений

Академические и независимые исследования

Астрологи-контент-мейкеры

Инструменты многолетних прогнозов

Technical Specifications

Флагманский endpoint	POST /api/v3/mundane/events/search
Operation ID	mundane_events_search
Семейства событий	8: sign_ingress, cardinal_ingress, station, retrograde_period, lunation, solar_eclipse, lunar_eclipse, jupiter_saturn_conjunction
Макс. окно поиска	5 лет (1 826 дней)
Самый быстрый ответ	~20ms (четыре кардинальных ингресса)
Самый медленный ответ	~2с (пять лет ингрессов, пять тел)
Тела по умолчанию	Семь классических планет, если bodies не указан
Фильтр знака ингресса	to_signs фильтрует по знаку, в который входит тело (to_sign), никогда по from_sign
Фильтр кардинальных точек	cardinal_points сужает до Ari / Can / Lib / Cap; по умолчанию — все четыре
Фильтр фаз лунации	lunation_phases; по умолчанию только новолуние и полнолуние
Зодиакальная система	Только тропический (options.zodiac_type = Tropic)
Форма ответа	Дискриминированное объединение по event_type, один плоский массив events[]
Данные карты	Отсутствуют. Каждое событие возвращает is_chart: false
Эфемериды	Swiss Ephemeris, геоцентрические видимые
Нумерация Сарос	ван ден Берг / NASA, явно указана в saros_numbering
Магнитуда затмения	magnitude_kind различает nasa_solar и lunar_umbral
Флаги ретроградности	start_clipped / end_clipped отмечают периоды, обрезанные окном поиска
Предварительная проверка стоимости	Слишком широкие запросы отклоняются за миллисекунды с указанием количества замеров
Неизвестные поля	extra='allow'; возвращает 200 с warnings[UNKNOWN_FIELD], никогда не отбрасывается молча
Формат вывода	JSON, события отсортированы по возрастанию datetime_utc

API Мунданной Астрологии против ручной сборки трёх endpoint'ов

Feature	Astrology API	Others
Ингрессы + новолуния + затмения	Один endpoint, один отсортированный список	Три отдельных вызова, объединение вручную
Многолетнее сканирование внешних планет	~400 замеров для 5 планет за 5 лет	Пишете и настраиваете собственное сканирование эфемерид
История триплицитета Юпитер-Сатурн	previous_triplicity + is_triplicity_change вычисляются автоматически	Вручную отслеживаете последовательность соединений
Ясность нумерации Сарос	ван ден Берг / NASA указана явно	Система нумерации часто не указана
Уже идущая ретроградность	Флаги start_clipped / end_clipped	Ложные даты начала или пропущенные периоды
Доктрина открытия кардинального года	Параметр cardinal_points, вы выбираете Овен/Козерог/Весы	Одна доктрина зашита намертво
Неизвестные поля запроса	200 + warnings[UNKNOWN_FIELD]	Молча игнорируются или жёсткая ошибка
Время ответа	~20ms для простого запроса ингресса	1-3 секунды
Цена	$11/месяц за 1 000 запросов	$99-299/месяц
Бесплатный тариф	50 запросов/месяц, всегда бесплатно	50-100 или отсутствует

Отслеживайте мировые события с API Мунданной Астрологии

Построить календарь мунданной астрологии с нуля — значит склеить три разных API

Один endpoint, восемь семейств событий, уже отсортированные

Что на самом деле делает endpoint /mundane/events/search

Что входит в endpoint поиска мунданных событий

sign_ingress

cardinal_ingress

station

retrograde_period

lunation

solar_eclipse & lunar_eclipse

jupiter_saturn_conjunction

Обязательный фильтр event_types

Параметр bodies

Фильтр to_signs

Фильтр cardinal_points

Фильтр lunation_phases

Пятилетнее окно поиска

Серия Сарос и порядковый номер

Явно указанная конвенция магнитуды

Регион точки наибольшей фазы затмения

История триплицитета Юпитер-Сатурн

Флаг is_triplicity_change

Поле datetime_is

is_chart: false у каждого события

start_clipped / end_clipped

nearest_syzygy_utc / phase

precision_seconds у каждого события

Предварительная проверка стоимости

warnings[UNKNOWN_FIELD]

Ответ в виде дискриминированного объединения

Время ответа от ~20мс до ~2с

Один плоский массив events[]

Точность Swiss Ephemeris

Полная поддержка SDK

Стандартный конверт ответа v3

Что такое API Мунданной Астрологии? Руководство по поиску мировых событий

Как работает endpoint /mundane/events/search?

Какие восемь семейств мунданных событий существуют?

Почему cardinal_points позволяет выбрать, какой знак открывает мунданный год?

Насколько точны расчёты затмений и соединений?

Чего API намеренно не делает и почему?

Кто строит на API Мунданной Астрологии?

Use Cases

Платформы финансовой и мунданной астрологии

Новостные и аналитические сайты

Системы планирования и уведомлений

Академические и независимые исследования

Астрологи-контент-мейкеры

Инструменты многолетних прогнозов

Technical Specifications

API Мунданной Астрологии против ручной сборки трёх endpoint'ов

Похожие астрологические API

API Транзитов

API Натальной Карты

API Хорарной Астрологии

API Казими и Комбустии

API Арабских Частей

Документация API

References & Standards

Простые, прозрачные цены

Всегда бесплатно

Pro

Pro Plus

Ultra

Business

Enterprise

FAQ по API Мунданной Астрологии

Что такое API Мунданной Астрологии?

Чем мунданная астрология отличается от натальной?

Какую систему зодиака использует API?

Какие восемь типов событий можно искать?

В чём разница между sign_ingress и cardinal_ingress?

Насколько длинное окно дат можно искать?

Почему cardinal_points позволяет выбрать, какой знак открывает мунданный год?

Что означает поле nearest_syzygy у кардинального ингресса?

Сообщает ли API, если соединение Юпитера и Сатурна сменило триплицитет?

Какую нумерацию Сарос используют затмения?

Почему магнитуда затмения иногда равна 0.0?

Можно ли построить с этим астрологический календарь на год вперёд?