Один эндпоинт.
Полный персидский цикл на 75 лет с большими периодами L1 и подпериодами L2. Секта определяется по карте, а не вручную через флаг.
Большинство приложений, использующих фирдарию, также используют
Цифры, которые мы измеряем в продакшене
Сделано для разработчиков, а не для десктопных интерфейсов
Техника Абу Ма'шара IX века, отдаваемая в виде JSON
Фирдария (также пишется как альфридария, фардар или фирдар) — персидская система управителей времени, которая делит жизнь на планетарные периоды. Абу Ма'шар описал её в IX веке, Бонатти ссылался на неё в XIII, а Вивиан Робсон обобщил её для англоязычных астрологов в XX веке. Дневные карты идут по циклу в 75 лет, начиная с Солнца. Ночные карты начинаются с Луны и используют другой порядок планет. Каждый большой период (L1) делится на семь подпериодов (L2), управляемых в халдейском порядке. Наш API возвращает полный каскад L1 + L2 одним запросом, выбирает правильную секту по данным рождения и включает периоды узлов, которые большинство реализаций пропускают. Если вы создаёте приложение по средневековой астрологии, чат-бота, цитирующего традиционные источники, или дашборд тайминга, это самый быстрый способ добавить фирдарию, не переписывая всю математику заново.
Фирдария делит жизнь человека на планетарные периоды L1, а затем каждый L1 — на семь подпериодов L2.
Дневные карты начинаются с Солнца: Солнце 10 лет, Венера 8, Меркурий 13, Луна 9, Сатурн 11, Юпитер 12, Марс 7, затем средний узел и южный узел делят 3 + 2 года.
Сложите всё — получится 75 лет.
Ночные карты начинаются с Луны и идут в другом порядке: Луна 9, Сатурн 11, Юпитер 12, Марс 7, Солнце 10, Венера 8, Меркурий 13, затем узлы.
Сумма та же.
Каждый период L1 делится на семь равных отрезков L2, управляемых в халдейском порядке (Сатурн, Юпитер, Марс, Солнце, Венера, Меркурий, Луна), начиная с той планеты, которая управляет L1.
Узлы не получают разбивки на L2.
Это традиция, а не баг.
Секта — это различение день/ночь в традиционной астрологии.
Если Солнце было над горизонтом в момент рождения, карта дневная (диурнальная).
Если под горизонтом — ночная (ноктюрнальная).
Фирдария использует секту, чтобы выбрать, какая последовательность будет работать.
Дневная карта, по ошибке использующая ночной порядок, вернёт неправильных управителей для каждого периода жизни.
Наш API проверяет положение Солнца в доме по данным рождения и автоматически направляет в правильную последовательность.
Вам не нужно передавать флаг day_chart.
Эндпоинт сам выполняет проверку, возвращает sect: "diurnal" или sect: "nocturnal" в ответе, и вы можете показать это в интерфейсе.
Если вам нужно переопределить значение (рождения в сумерках, полярные широты), базовая логика отображается в ответе, чтобы вы могли её осмыслить.
Запись L1 содержит управителя-планету, years (целое число от 2 до 13), start_date и end_date в виде ISO-строк, булево значение node_period и массив l2_periods.
Массив l2_periods содержит семь записей для периодов без узлов и пуст для периодов узлов.
Каждая запись L2 имеет planet, start_date, end_date.
Разбивка равномерная: L1 в 12 лет даёт семь периодов L2 примерно по 1,71 года каждый.
Мы используем 365.2422 дня в году (длину тропического года), чтобы математика совпадала с тем, как астрологи обычно отсчитывают периоды фирдарии.
Если вы вызываете эндпоинт с as_of_date, ответ также включает объект active, который сообщает, какие L1 и L2 идут на эту дату.
Это удобно для чат-приложений, отвечающих на вопрос «в каком периоде я сейчас?».
Профекции сдвигают асцендент на один дом в год по 12-летнему циклу.
Просто, часто повторяется, мало контекста.
Зодиакальное высвобождение идёт по фиксированным знаковым периодам L1, L2, L3, L4.
Гораздо тяжелее, и периоды зацикливаются на фиксированной длине (например, 8 лет для Жребия Духа в Овне).
Ведическая Вимшоттари даша охватывает 120 лет через девять периодов, привязанных к накшатре Луны при рождении.
Фирдария находится между профекциями и ZR: длиннее профекций, проще ZR, чувствительна к секте так, как Вимшоттари нет.
Многие традиционные астрологи работают с профекциями + фирдарией + ZR одновременно.
Наш эндпоинт /timing/timeline объединяет все четыре техники (профекции, ZR, деценнии, фирдарию) в один слитный таймлайн, чтобы вашему фронтенду не пришлось сшивать четыре вызова.
Фирдария хорошо работает для годовых отчётов, обзоров жизненных этапов и контекста чат-ботов.
Период L1 задаёт многолетнюю тему («годы Марса»), вокруг которой легко писать текст.
Подпериод L2 даёт более узкое окно от нескольких месяцев до двух лет — годится для прогнозных промптов.
Совмещайте фирдарию с попаданиями транзитов, чтобы отмечать конкретные события внутри известного периода.
Например: «Вы в большом периоде Марса L1 / подпериоде Сатурна L2, и Марс будет в квадрате к вашему натальному Солнцу в следующем месяце».
Такая связка естественно читается в коучинговом инструменте и даёт LLM достаточно структуры, чтобы обосновать ответ.
Фирдария также хорошо подходит для образовательных приложений, потому что правила короткие и легко усваиваются, в отличие от ZR, которому нужна целая глава предыстории.
Сама фирдария — не сложная математика.
Это арифметика timedelta на константах планетарных лет.
Сложное — это окружающая система: определение секты, краевые случаи полярных широт, обработка узлов, совпадающая с традицией, вывод дат в ISO без дрейфа по годам и единообразное поведение на границах годов.
Наш сервис выдержан против всего этого.
Он также поставляется рядом с 100+ другими эндпоинтами, так что если позже вам понадобятся натальные карты, транзиты, профекции или соляры, вы не заплатите за вторую интеграцию.
Бесплатный тариф даёт 50 запросов в месяц, платные планы начинаются от $11/месяц.
Вы можете запуститься за один день.
Инструменты для традиционных астрологов, которые уже работают с фирдарией, профекциями и ZR. Один API, четыре системы управителей времени.
Фирдария привлекательна для персидско-индийского пересечения. Совместите её с Вимшоттари дашей для приложений, нацеленных на обе аудитории.
Подавайте контекст L1 + L2 + активный период в промпт. Бот отвечает на вопрос «в каком я сейчас периоде?» без галлюцинаций с датами.
Правила фирдарии короткие и обучаемые. Используйте API как расчётный бэкенд для курсов по Абу Ма'шару и Бонатти.
Генерируйте PDF- или веб-отчёты, показывающие активные L1 + L2 с диапазонами дат. Клиенты получают ясное годовое повествование.
Объедините фирдарию с профекциями и транзитами в одном представлении. Практики перестают прыгать между вкладками десктопных приложений.
| Эндпоинт | POST /api/v3/timing/firdaria |
| Среднее время ответа | ~220ms |
| Ответ P95 | <400ms |
| Длина цикла | 75 лет (день и ночь) |
| Возвращается периодов L1 | 9 (7 планет + 2 узла) |
| Подпериоды L2 | 7 на каждый L1 без узла (халдейский порядок) |
| Определение секты | Автоматически по положению Солнца в доме |
| Длина года | 365.2422 дня (тропический год) |
| Эфемериды | Swiss Ephemeris (swisseph) |
| Формат даты | ISO 8601 (YYYY-MM-DD) |
| Поиск активного периода | Опциональный параметр as_of_date |
| Агрегация таймлайна | Объединённый вывод через /timing/timeline |
| Лимит запросов (Free) | 50 запросов/месяц |
| Лимит запросов (Business) | 220,000 запросов/месяц |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 в одном вызове | Да | Только L1 |
| Автоопределение секты | Да, по карте | Ручной флаг день/ночь |
| Периоды узлов включены | Да (средний + южный) | Пропущены |
| Время ответа | ~220ms | 1-3 секунды |
| Эндпоинт объединённого таймлайна | Да (4 техники) | Недоступно |
| Активный период на дату | Да (параметр as_of_date) | Считать на клиенте |
| Бесплатный тариф | 50 запросов/месяц | Только платно |
| Бэкенд эфемерид | Swiss Ephemeris | Проприетарный / неясный |
12-летний цикл, управитель года, легче фирдарии.
Ведический 120-летний цикл управителей времени. Полезное пересечение для персидской аудитории.
Эллинистические знаковые периоды L1-L4. Скоро.
Эллинистические 10-летние планетарные периоды. Скоро.
Секта, управители тригонов, альмутен — фундамент, на котором стоит фирдария.
Один эндпоинт, возвращающий профекции, фирдарию, ZR и деценнии, слитые в единый таймлайн.
Начните бесплатно, масштабируйтесь по мере роста. Без скрытых платежей и сюрпризов.
Для небольших приложений и личных проектов
Для растущих приложений и среднего трафика
Для приложений корпоративного масштаба
Все планы включают подробную документацию и SDK
Есть вопросы? Поговорите с нашей командой
Вопросы, которые реально задают разработчики