Один ендпоінт.
Повний 75-річний перський цикл з мажорними періодами L1 та підперіодами L2. Секта визначається з карти, без ручного прапорця.
Більшість застосунків з Firdaria також використовують
Числа, які ми міряємо в продакшені
Зроблено для розробників, а не для десктоп UI
Техніка Abu Ma'shar (IX століття), подана як JSON
Firdaria (також пишеться alfridaria, fardar або firdar) — це перська система володарів часу, яка ділить життя на планетні періоди. Abu Ma'shar описав її в IX столітті, Bonatti згадав у XIII, а Vivian Robson підсумував для англомовних астрологів у XX столітті. Денні карти йдуть 75-річним циклом, починаючи з Сонця. Нічні карти починаються з Місяця і використовують інший порядок планет. Кожен мажорний період (L1) ділиться на сім підперіодів (L2) у халдейському порядку. Наш API повертає повний каскад L1 + L2 одним запитом, обирає правильну секту з даних народження і включає періоди вузлів, які більшість реалізацій пропускає. Якщо ти будуєш застосунок з середньовічної астрології, чатбот, що цитує традиційні джерела, або дашборд для таймінгу — це найшвидший спосіб додати Firdaria без переписування математики.
Firdaria ділить життя людини на планетні періоди L1, потім розбиває кожен L1 на сім підперіодів L2.
Денні карти починаються з Сонця: Сонце 10 років, Венера 8, Меркурій 13, Місяць 9, Сатурн 11, Юпітер 12, Марс 7, далі Mean Node і South Node ділять 3 + 2 роки.
Складаємо — отримуємо 75 років.
Нічні карти починаються з Місяця і йдуть в іншому порядку: Місяць 9, Сатурн 11, Юпітер 12, Марс 7, Сонце 10, Венера 8, Меркурій 13, потім вузли.
Підсумок той самий.
Кожен період L1 ділиться на сім рівних шматків L2 у халдейському порядку (Сатурн, Юпітер, Марс, Сонце, Венера, Меркурій, Місяць), починаючи з планети, яка править L1.
Вузли не отримують поділу на L2.
Це традиція, а не баг.
Секта — це поділ день/ніч у традиційній астрології.
Якщо Сонце над горизонтом у момент народження, карта діурнальна.
Якщо під — ноктюрнальна.
Firdaria використовує секту, щоб обрати, яка послідовність піде.
Денна карта, помилково порахована за нічним порядком, поверне неправильних володарів для кожного періоду життя.
Наш API перевіряє положення Сонця по будинках з даних народження і автоматично направляє в потрібну послідовність.
Ти не передаєш прапорець day_chart.
Ендпоінт сам робить перевірку, повертає sect: "diurnal" або sect: "nocturnal" у відповіді, і ти можеш показати це в UI.
Якщо хочеш перевизначити (народження в сутінках, полярні широти) — базова логіка лежить у відповіді, щоб ти міг з нею працювати.
Запис 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 днів на рік (тропічний рік), щоб математика збігалася з тим, як астрологи зазвичай рахують періоди Firdaria.
Якщо викликати ендпоінт з as_of_date, відповідь також містить об'єкт active, який каже, який L1 і який L2 діють на цю дату.
Зручно для чат-застосунків, що відповідають на питання "у якому періоді я зараз?".
Профекції зсувають асцендент на один будинок щороку, 12-річний цикл.
Просто, часто повторюється, мало контексту.
Zodiacal releasing працює з фіксованими знаковими періодами L1, L2, L3, L4.
Набагато важче, а періоди йдуть фіксованою довжиною (наприклад, 8 років для Lot of Spirit в Овні).
Ведійська Vimshottari Dasha охоплює 120 років через дев'ять періодів, прив'язаних до накшатри Місяця при народженні.
Firdaria сидить між профекціями і ZR: довша за профекції, простіша за ZR, чутлива до секти так, як Vimshottari не є.
Багато традиційних астрологів запускають профекції + Firdaria + ZR разом.
Наш ендпоінт /timing/timeline агрегує всі чотири (профекції, ZR, декенніали, Firdaria) в один зведений таймлайн, щоб фронтенд не зшивав чотири виклики.
Firdaria добре працює для річних звітів, оглядів життєвих фаз і контексту чатбота.
Період L1 дає багаторічну тему ("роки Марса"), під яку легко писати копірайт.
Підперіод L2 дає вужче вікно від кількох місяців до двох років — добре для прогнозних промптів.
Поєднай Firdaria з транзитами, щоб підсвічувати конкретні події всередині відомого періоду.
Наприклад: "Ти в Mars L1 / Saturn L2, і Марс робить квадратуру до твого натального Сонця наступного місяця".
Це поєднання природно читається в коучинговому інструменті і дає LLM достатньо структури, щоб обґрунтувати відповідь.
Firdaria також добре підходить для освітніх застосунків, бо правила короткі і легкі для вивчення — на відміну від ZR, де потрібен цілий розділ передісторії.
Сама Firdaria — це не складна математика.
Це timedelta-арифметика на константах планетних років.
Складне — це навколишня система: визначення секти, edge-кейси полярних широт, обробка вузлів, що відповідає традиції, ISO-дати без зсуву через роки, послідовна поведінка на межах років.
Наш сервіс закалений проти всього цього.
До того ж він живе поруч зі 100+ іншими ендпоінтами — тож якщо пізніше знадобляться натальні карти, транзити, профекції чи solar return, повторної інтеграції не платитимеш.
Free tier дає 50 запитів на місяць, платні плани стартують від $11/міс.
Можна піти в продакшен за пів дня.
Інструменти для традиційних астрологів, які вже працюють з Firdaria, профекціями і ZR. Один API, чотири time-lord системи.
Firdaria має персько-індійську аудиторію. Поєднай її з Vimshottari Dasha для застосунків, що цілять в обидві аудиторії.
Подавай L1 + L2 + активний період у промпт. Бот відповідає на "у якому я зараз періоді?" без галюцинацій з датами.
Правила Firdaria короткі і легко вчаться. Використовуй API як бекенд розрахунків для курсів про Abu Ma'shar і Bonatti.
Генеруй PDF або веб-звіти з активними L1 + L2 та діапазонами дат. Клієнти отримують чіткий річний наратив.
Поєднай Firdaria з профекціями і транзитами в одному екрані. Практики перестають стрибати між десктоп-вкладками.
| Ендпоінт | POST /api/v3/timing/firdaria |
| Середній відгук | ~220мс |
| P95 відгук | <400мс |
| Довжина циклу | 75 років (день і ніч) |
| Повертається L1-періодів | 9 (7 планет + 2 вузли) |
| Підперіоди L2 | 7 на кожен не-вузловий L1 (халдейський порядок) |
| Визначення секти | Автоматичне з положення Сонця по будинках |
| Довжина року | 365.2422 днів (тропічний рік) |
| Ефемериди | Swiss Ephemeris (swisseph) |
| Формат дат | ISO 8601 (YYYY-MM-DD) |
| Пошук активного періоду | Опційний параметр as_of_date |
| Агрегація таймлайну | Зведений вивід через /timing/timeline |
| Rate Limit (Free) | 50 запитів/місяць |
| Rate Limit (Business) | 220 000 запитів/місяць |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 одним викликом | Так | Тільки L1 |
| Авто-визначення секти | Так, з карти | Ручний прапорець день/ніч |
| Періоди вузлів | Так (Mean + South) | Пропущені |
| Час відгуку | ~220мс | 1-3 секунди |
| Зведений timeline-ендпоінт | Так (4 техніки) | Недоступний |
| Активний період на дату | Так (параметр as_of_date) | Рахуй на клієнті |
| Безкоштовний рівень | 50 запитів/місяць | Тільки платно |
| Бекенд ефемерид | Swiss Ephemeris | Пропрієтарний / незрозуміло |
12-річний цикл, володар року, легший за Firdaria.
Ведійський 120-річний цикл володарів часу. Корисний кросовер для перської аудиторії.
Еллінські L1-L4 знакові періоди. Скоро.
Еллінські 10-річні планетні періоди. Скоро.
Секта, тригонократори, альмутен — фундамент, на якому стоїть Firdaria.
Один ендпоінт, що повертає профекції, Firdaria, ZR і декенніали зведеними в один таймлайн.
Почніть безкоштовно, масштабуйтеся по мірі росту. Ніяких прихованих платежів, ніяких сюрпризів.
Для невеликих додатків та особистих проєктів
Для зростаючих додатків та середнього трафіку
Для корпоративних застосунків
Всі плани включають повну документацію та SDK
Питання? Поговоріть з нашою командою
Питання, які реально ставлять розробники