Endpoint unique.
Cycle perse complet de 75 ans avec périodes majeures L1 et sous-périodes L2. Secte détectée depuis le thème, sans flag manuel.
La plupart des applis qui utilisent Firdaria utilisent aussi
Chiffres mesurés en production
Pensé pour les développeurs, pas pour les UIs desktop
La technique du 9e siècle d'Abu Ma'shar, servie en JSON
Firdaria (aussi orthographié alfridaria, fardar ou firdar) est un système perse de seigneurs du temps qui divise une vie en périodes planétaires. Abu Ma'shar l'a décrit au 9e siècle, Bonatti l'a référencé au 13e, et Vivian Robson l'a résumé pour les astrologues anglophones au 20e. Les thèmes diurnes suivent un cycle de 75 ans commençant par le Soleil. Les thèmes nocturnes commencent par la Lune et utilisent un ordre planétaire différent. Chaque période majeure (L1) est divisée en sept sous-périodes (L2) régies dans l'ordre chaldéen. Notre API renvoie la cascade complète L1 + L2 en une seule requête, choisit la bonne secte à partir des données de naissance et inclut les périodes des nœuds que la plupart des implémentations ignorent. Si vous construisez une application d'astrologie médiévale, un chatbot qui cite les sources traditionnelles ou un dashboard de timing, c'est le moyen le plus rapide d'ajouter Firdaria sans réimplémenter le calcul.
Firdaria divise une vie en périodes planétaires appelées L1, puis subdivise chaque L1 en sept sous-périodes L2.
Les thèmes diurnes commencent par le Soleil : Soleil 10 ans, Vénus 8, Mercure 13, Lune 9, Saturne 11, Jupiter 12, Mars 7, puis le Nœud Moyen et le Nœud Sud se partagent 3 + 2 ans.
Total : 75 ans.
Les thèmes nocturnes commencent par la Lune et suivent un ordre différent : Lune 9, Saturne 11, Jupiter 12, Mars 7, Soleil 10, Vénus 8, Mercure 13, puis les nœuds.
Le total reste identique.
Chaque période L1 est découpée en sept segments L2 égaux régis dans l'ordre chaldéen (Saturne, Jupiter, Mars, Soleil, Vénus, Mercure, Lune), en partant de la planète régente du L1.
Les nœuds n'ont pas de subdivision L2.
C'est la tradition, pas un bug.
La secte est la distinction jour/nuit en astrologie traditionnelle.
Si le Soleil est au-dessus de l'horizon à la naissance, le thème est diurne.
En dessous, nocturne.
Firdaria utilise la secte pour choisir la séquence à appliquer.
Un thème diurne qui utilise par erreur l'ordre nocturne renvoie de mauvais régents pour chaque période de la vie.
Notre API vérifie la position du Soleil dans les maisons depuis les données de naissance et route automatiquement vers la bonne séquence.
Vous n'avez pas à passer de flag day_chart.
L'endpoint fait la vérification, renvoie sect: "diurnal" ou sect: "nocturnal" dans la réponse, et vous pouvez l'afficher dans votre UI.
Si vous voulez forcer (naissances au crépuscule, latitudes polaires), la logique sous-jacente est exposée dans la réponse pour que vous puissiez raisonner dessus.
Une entrée L1 contient la planète régente, years (un entier de 2 à 13), start_date et end_date au format ISO, un booléen node_period et un tableau l2_periods.
Le tableau l2_periods contient sept entrées pour les périodes non-nodales et est vide pour les périodes nodales.
Chaque entrée L2 a planet, start_date, end_date.
La division est régulière : un L1 de 12 ans donne sept périodes L2 d'environ 1,71 an chacune.
Nous utilisons 365,2422 jours par an (la longueur de l'année tropique) pour que le calcul colle avec la façon dont les astrologues comptent normalement les périodes Firdaria.
Si vous appelez l'endpoint avec un as_of_date, la réponse inclut aussi un objet active qui indique quels L1 et L2 sont en cours à cette date.
Pratique pour les chatbots qui répondent à "dans quelle période suis-je en ce moment ?".
Les profections font avancer l'ascendant d'une maison par an sur un cycle de 12 ans.
Simple, répétitif, léger en contexte.
Le zodiacal releasing parcourt des périodes fixes basées sur les signes en L1, L2, L3, L4.
Beaucoup plus lourd, et les périodes bouclent sur une longueur fixe (par exemple 8 ans pour la Part de l'Esprit en Bélier).
La Vimshottari Dasha védique couvre 120 ans sur neuf périodes ancrées au nakshatra de la Lune natale.
Firdaria se situe entre les profections et le ZR : plus longue que les profections, plus simple que le ZR, sensible à la secte d'une manière que Vimshottari n'est pas.
Beaucoup d'astrologues traditionnels combinent profections + Firdaria + ZR.
Notre endpoint /timing/timeline agrège les quatre techniques (profections, ZR, décennaires, Firdaria) en une timeline fusionnée pour que votre front-end n'ait pas à coudre quatre appels.
Firdaria fonctionne bien pour les rapports annuels, les vues d'ensemble de phases de vie et le contexte de chatbot.
La période L1 donne un thème pluriannuel ("les années Mars") facile à mettre en mots.
La sous-période L2 donne une fenêtre plus serrée de quelques mois à deux ans, parfaite pour les prompts prédictifs.
Combinez Firdaria avec des hits de transits pour signaler des événements spécifiques à l'intérieur d'une période connue.
Par exemple : "Vous êtes dans votre période L1 Mars / sous-période L2 Saturne, et Mars sera carré votre Soleil natal le mois prochain." Ce combo se lit naturellement dans un outil de coaching et donne à un LLM assez de structure pour ancrer sa réponse.
Firdaria convient aussi bien aux applis éducatives car les règles sont courtes et apprenables, contrairement au ZR qui demande un chapitre d'introduction.
Firdaria n'est pas un calcul difficile en soi.
C'est de l'arithmétique sur des timedeltas avec des constantes en années planétaires.
Le dur, c'est le système autour : détection de secte, cas limites aux latitudes polaires, gestion des nœuds conforme à la tradition, dates ISO qui ne dérivent pas au fil des années, comportement cohérent aux limites annuelles.
Notre service a été durci sur tous ces points.
Il s'inscrit aussi à côté de 100+ autres endpoints, donc si vous avez besoin ensuite de thèmes natals, transits, profections ou révolutions solaires, vous ne payez pas un second tax d'intégration.
Le tier gratuit donne 50 requêtes par mois, les plans payants démarrent à $11/mois.
Vous pouvez être en production dans l'après-midi.
Outils pour astrologues traditionnels qui travaillent déjà avec Firdaria, profections et ZR. Une API, quatre systèmes de seigneurs du temps.
Firdaria a un attrait croisé perso-indien. Combinez-la avec Vimshottari Dasha pour les applis ciblant les deux publics.
Injectez le contexte L1 + L2 + période active dans le prompt. Le bot répond à "dans quelle période suis-je ?" sans halluciner des dates.
Les règles de Firdaria sont courtes et enseignables. Utilisez l'API comme backend de calcul pour des cours sur Abu Ma'shar et Bonatti.
Générez des rapports PDF ou web qui montrent les L1 + L2 actifs avec leurs plages de dates. Les clients obtiennent un récit annuel clair.
Combinez Firdaria avec profections et transits dans une seule vue. Les praticiens arrêtent de jongler entre logiciels desktop.
| Endpoint | POST /api/v3/timing/firdaria |
| Réponse moyenne | ~220ms |
| Réponse P95 | <400ms |
| Longueur du cycle | 75 ans (jour et nuit) |
| Périodes L1 renvoyées | 9 (7 planètes + 2 nœuds) |
| Sous-périodes L2 | 7 par L1 non-nodal (ordre chaldéen) |
| Détection de secte | Automatique depuis la position du Soleil |
| Longueur de l'année | 365,2422 jours (année tropique) |
| Éphémérides | Swiss Ephemeris (swisseph) |
| Format de date | ISO 8601 (YYYY-MM-DD) |
| Lookup de période active | Paramètre as_of_date optionnel |
| Agrégation timeline | Sortie combinée via /timing/timeline |
| Rate limit (Free) | 50 requêtes/mois |
| Rate limit (Business) | 220 000 requêtes/mois |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 en un appel | Oui | L1 uniquement |
| Auto-détection de secte | Oui, depuis le thème | Flag manuel jour/nuit |
| Périodes des nœuds incluses | Oui (Moyen + Sud) | Ignorées |
| Temps de réponse | ~220ms | 1-3 secondes |
| Endpoint timeline combiné | Oui (4 techniques) | Non disponible |
| Période active à une date | Oui (param as_of_date) | Calcul côté client |
| Tier gratuit | 50 requêtes/mois | Payant uniquement |
| Backend éphémérides | Swiss Ephemeris | Propriétaire / flou |
Cycle de 12 ans, seigneur de l'année, plus léger que Firdaria.
Cycle védique de seigneurs du temps sur 120 ans. Crossover utile pour les publics persans.
Périodes hellénistiques L1-L4 basées sur les signes. Bientôt disponible.
Périodes planétaires hellénistiques de 10 ans. Bientôt disponible.
Secte, régents de triplicité, almuten — les fondations sur lesquelles Firdaria repose.
Un endpoint qui renvoie profections, Firdaria, ZR et décennaires fusionnés sur une seule timeline.
Commencez gratuitement, evoluez selon vos besoins. Pas de frais caches.
Pour petites apps et projets personnels
Pour apps en croissance et trafic moyen
Pour applications a echelle entreprise
Tous les plans incluent documentation complete et SDKs
Questions? Parlez a notre equipe
Questions que les développeurs posent vraiment