D'où vient Firdaria historiquement ?

La technique est attribuée aux astrologues perses et est arrivée en Europe médiévale via les écrits d'Abu Ma'shar. Bonatti lui a consacré un commentaire substantiel au 13e siècle dans son Liber Astronomiae. Elle a été largement utilisée durant la Renaissance, puis largement oubliée jusqu'à ce que la revival de l'astrologie traditionnelle à la fin du 20e siècle la remette en lumière. Les traductions modernes de Robert Hand, Benjamin Dykes et d'autres ont rendu les règles à nouveau accessibles.

Pourquoi le jour vs la nuit compte pour Firdaria ?

La secte détermine quelle séquence s'applique. Les thèmes diurnes commencent par le Soleil. Les nocturnes par la Lune. L'ordre des planètes restantes diffère aussi. Un thème diurne calculé avec la séquence nocturne renvoie le mauvais régent pour chaque période de la vie. Notre API détecte la secte depuis la position du Soleil en maison et route automatiquement, vous n'avez pas à passer de flag manuel.

Quelle est la durée des périodes majeures ?

En années : Soleil 10, Vénus 8, Mercure 13, Lune 9, Saturne 11, Jupiter 12, Mars 7, Nœud Moyen 3, Nœud Sud 2. Total : 75 ans. L'ordre de ces nombres dépend de la secte, mais les longueurs elles-mêmes ne changent pas. Après 75 ans, le cycle redémarre avec le même premier régent, donc quelqu'un qui vit au-delà de 80 ans entame un second passage partiel.

À quoi ressemble la réponse JSON ?

Clés de premier niveau : sect ("diurnal" ou "nocturnal"), l1_periods (tableau de 9), et active (le L1 et L2 en cours si vous passez as_of_date). Chaque entrée L1 a planet, years, start_date, end_date, node_period et l2_periods. Chaque entrée L2 a planet, start_date, end_date. Toutes les dates sont des chaînes ISO (YYYY-MM-DD). Rien dans la réponse ne nécessite de traduction. Les noms de planètes sont des clés stables.

Comment chercher la période active actuelle ?

Passez as_of_date dans le body de la requête sous forme de datetime ISO. La réponse inclut un objet active avec la planète L1, la planète L2 et les dates de début/fin des deux. Si vous omettez as_of_date, vous obtenez quand même la cascade complète et pouvez localiser la période active côté client en comparant les dates. Pour les chatbots et dashboards live, passer as_of_date est plus simple.

Quelles éphémérides l'API utilise-t-elle ?

Swiss Ephemeris (swisseph), la même bibliothèque sur laquelle reposent les logiciels desktop professionnels. Firdaria utilise des constantes fixes en années planétaires, donc la précision des éphémérides compte moins ici que pour les transits. Les services autour (thème natal, détermination de secte, cuspides de maisons) tournent tous sur swisseph, donc les résultats restent cohérents entre endpoints.

Puis-je combiner Firdaria avec d'autres techniques de timing en un seul appel ?

Oui. POST /api/v3/timing/timeline renvoie une timeline fusionnée de profections, Firdaria, zodiacal releasing et décennaires pour n'importe quelle plage de dates. L'agrégateur est conçu pour que votre front-end n'ait pas à appeler quatre endpoints et coudre les résultats. Si vous n'avez besoin que de Firdaria, POST /api/v3/timing/firdaria est l'endpoint dédié.

Quels inputs l'API attend-elle ?

Un sujet avec date, heure et lieu de naissance. La même forme de payload que pour un thème natal fonctionne ici. Le lieu est nécessaire pour calculer les cuspides de maisons pour la détection de secte. Si l'heure de naissance manque, la secte ne peut pas être déterminée de façon fiable. Passez un thème de midi en fallback et la réponse reflètera cette incertitude.

Pour quels ICPs cet endpoint est-il pensé ?

SaaS d'astrologie médiévale et traditionnelle, applis perses et adjacentes au védique (Firdaria a un attrait croisé dans les deux), chatbots d'astrologie IA qui ont besoin de contexte de seigneurs du temps pour ancrer leurs réponses, et plateformes éducatives qui enseignent les méthodes d'Abu Ma'shar. Si votre produit propose des prévisions annuelles ou des récits de phases de vie, Firdaria s'y prête.

Puis-je utiliser Firdaria dans une appli boostée par LLM ?

Oui, et c'est un bon fit. Le régent L1 donne un thème pluriannuel, la sous-période L2 donne une fenêtre plus serrée. Injecter les deux dans le prompt avec les dates actives donne au modèle une vraie structure sur laquelle s'appuyer, donc il arrête d'inventer des plages de dates. Combinez le contexte Firdaria avec des hits de transits pour des prédictions au niveau de l'événement.

Combien coûte la Firdaria API ?

Le tier gratuit couvre 50 requêtes par mois à $0. Starter est à $11/mois pour 1 000 requêtes. Professional à $37/mois pour 55 000 requêtes. Business à $99/mois pour 220 000 requêtes et inclut tous les endpoints. Enterprise démarre à $399/mois avec infrastructure dédiée. Firdaria est dispo sur tous les tiers, y compris le gratuit.

Y a-t-il une limite d'usage sur le tier gratuit ?

Oui, 50 requêtes par mois, facturées jamais. C'est assez pour prototyper, construire une démo ou faire tourner une appli personnelle. Quand vous le dépassez, le tier Starter à $11 couvre 1 000 requêtes/mois et le Professional à $37 en couvre 55 000.

À quelle vitesse répond l'endpoint ?

Temps de réponse moyen autour de 220ms. Le P95 reste sous 400ms. Le calcul lui-même est léger. Le gros de la latence vient de la détection de secte (qui demande les cuspides de maisons), pas du calcul des périodes. Pour de l'usage en masse, la même forme de payload marche sur les autres endpoints de timing, donc vous pouvez chaîner les appels.

L'API supporte-t-elle les requêtes en batch ?

Oui, sur les plans Business et Enterprise vous pouvez soumettre jusqu'à 100 sujets par requête. Pour les plans plus légers, lancez-les en séquence ou en petits batchs parallèles. Chaque appel est peu coûteux et stateless, donc la concurrence scale linéairement jusqu'à la rate limit de votre tier.

API des Seigneurs du Temps Perses

Construisez avec Firdaria

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.

Voir la réponse JSON

220ms

Temps de réponse moyen

75 ans

Cycle complet (jour)

L1+L2

Profondeur des périodes

9e s.

Abu Ma'shar

Construit sur Swiss Ephemeris

Détection de secte par défaut

99,9% de disponibilité

Renvoient uniquement les périodes majeures L1, sans sous-périodes L2
Exigent un flag manuel jour/nuit, facile à se tromper
Ignorent totalement les périodes des nœuds (Nœud Moyen + Nœud Sud)
Difficiles à combiner avec profections, ZR ou décennaires
Enfermées dans des logiciels desktop, sans API JSON

Pourquoi les développeurs passent à

Cascade complète L1 + L2 dans une seule réponse
Secte détectée automatiquement depuis la position du Soleil
Périodes des nœuds incluses, avec leur subdivision L2 ignorée selon la tradition
S'intègre directement dans /timing/timeline avec les autres techniques de seigneurs du temps
Précision Swiss Ephemeris, sortie JSON, réponse ~220ms

Des performances API sur lesquelles vous pouvez compter

Chiffres mesurés en production

~220ms

Temps de réponse

75 ans

Longueur du cycle (thèmes diurnes)

7 (L2)

Sous-périodes par majeure

7 + 2 nœuds

Régents de période

Ce que fait l'endpoint Firdaria

Pensé pour les développeurs, pas pour les UIs desktop

Cascade L1 complète

Les neuf périodes majeures depuis la naissance, dans l'ordre.

7 périodes planétaires + 2 nodales, 75 ans au total

Sous-périodes L2 incluses

Sept sous-périodes dans chaque majeure non-nodale.

Rotation en ordre chaldéen à partir du régent L1

Routage selon la secte

Séquence diurne ou nocturne choisie depuis les données du thème.

Basé sur la position du Soleil en maison

Périodes des nœuds gérées correctement

Nœud Moyen 3 ans, Nœud Sud 2 ans. Pas de subdivision L2, selon la tradition.

Flag node_period: true dans la réponse

Lookup de période active

Passez une date, récupérez le L1 et le L2 en cours.

Paramètre as_of_date optionnel

Sortie de dates ISO

start_date et end_date au format YYYY-MM-DD.

Aucune dérive de fuseau horaire sur la cascade

Backend Swiss Ephemeris

Le même moteur qui équipe les logiciels desktop professionnels.

swisseph sous le capot

Support timeline combinée

S'intègre dans /timing/timeline aux côtés des autres techniques.

Profections + Firdaria + ZR + décennaires

Hooks d'interprétation

Bloc d'interprétation optionnel indexé par planète.

Depuis les traductions report_data, swappable par locale

Longueur d'année tropique

Utilise 365,2422 jours/an pour coller au comptage traditionnel.

Correspond aux tables Firdaria manuelles des sources classiques

Qu'est-ce que Firdaria ? Guide développeur de l'API des seigneurs du temps perses

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.

Comment fonctionne Firdaria ? Le cycle de 75 ans expliqué

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.

Cycle diurne = 75 ans. Cycle nocturne = 75 ans. Planète de départ et ordre différents.

1 min read

Pourquoi la secte compte, et comment on la détecte

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.

La secte est détectée depuis le thème. Aucun flag manuel requis.

1 min read

L1 vs L2 : ce que vous récupérez dans le JSON

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 ?".

Une seule réponse = cascade complète sur la vie + période active si vous la demandez.

1 min read

Firdaria comparée aux autres techniques de seigneurs du temps

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 se glisse entre les profections (cycle 12 ans) et le zodiacal releasing (multi-niveaux).

1 min read

Quand utiliser Firdaria dans vos features produit

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.

L1 cadre les années, L2 cadre les mois, les transits cadrent les jours.

1 min read

Pourquoi construire sur notre API plutôt que faire le vôtre

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.

Dix lignes d'intégration remplacent un week-end de chasse aux cas limites.

1 min read

Use Cases

SaaS d'astrologie médiévale

Outils pour astrologues traditionnels qui travaillent déjà avec Firdaria, profections et ZR. Une API, quatre systèmes de seigneurs du temps.

Applis perses et adjacentes au védique

Firdaria a un attrait croisé perso-indien. Combinez-la avec Vimshottari Dasha pour les applis ciblant les deux publics.

Chatbots d'astrologie IA

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.

Plateformes éducatives

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.

Rapports de lecture annuels

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.

Dashboards de timing pour astrologues

Combinez Firdaria avec profections et transits dans une seule vue. Les praticiens arrêtent de jongler entre logiciels desktop.

Technical Specifications

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

APIs Firdaria comparées

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

Autres APIs de timing du stack

API Profections Annuelles

Cycle de 12 ans, seigneur de l'année, plus léger que Firdaria.

API Vimshottari Dasha

Cycle védique de seigneurs du temps sur 120 ans. Crossover utile pour les publics persans.

API Zodiacal Releasing

Périodes hellénistiques L1-L4 basées sur les signes. Bientôt disponible.

API Décennaires

Périodes planétaires hellénistiques de 10 ans. Bientôt disponible.

API d'Astrologie Traditionnelle

Secte, régents de triplicité, almuten — les fondations sur lesquelles Firdaria repose.

API Timing

Un endpoint qui renvoie profections, Firdaria, ZR et décennaires fusionnés sur une seule timeline.

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

Tarifs Simples et Transparents

Commencez gratuitement, evoluez selon vos besoins. Pas de frais caches.

Toujours Gratuit

Sans Carte de Credit

Parfait pour apprendre, tester et petits projets personnels

100 appels API/mois

Cartes natales de base

5 systemes de maisons

Support communautaire

Pro

11€/mois

Pour petites apps et projets personnels

Tous les endpoints de base
12 systemes de maisons
Support email

Meilleur Rapport Qualite-Prix

Pro Plus

21€/mois

Pour apps en croissance et trafic moyen

Tous les endpoints ameliores
18 systemes de maisons
Interpretations IA
Support email prioritaire

Ultra

37€/mois

Pour applications d'astrologie professionnelles

Credit math ↓

Tous les endpoints premium
23 systemes de maisons
Interpretations IA avancees
Support prioritaire

Plans Haut Volume

Pour applications a echelle entreprise

Business

99€/mois

Pour applications a haut volume

Credit math ↓

TOUS les endpoints
Pret pour marque blanche
Affinage IA personnalise
Support telephonique

ILLIMITE

Enterprise

399€+par mois

Requetes illimitees avec infrastructure dediee

Infrastructure serveur dediee
Moins de 300ms garanti
Support dedie 24/7
99,99% uptime SLA

Tous les plans incluent documentation complete et SDKs

Questions? Parlez a notre equipe

FAQ de la Firdaria API

Questions que les développeurs posent vraiment

Connectez Firdaria au reste du stack de timing

La plupart des applis qui utilisent Firdaria utilisent aussi

Profections Annuelles Zodiacal Releasing Décennaires Vimshottari Dasha Astrologie Traditionnelle API Timing

Livrez Firdaria dans l'après-midi, pas dans un sprint

Détection de secte, gestion des nœuds, rotation L2, dates ISO. Réglés. Le tier gratuit vous donne 50 requêtes pour prouver que ça marche dans votre appli.

Obtenir une clé API Lire la doc

Garantie 30 jours

Tier gratuit, sans carte bancaire

Résiliable à tout moment

Construisez avec Firdaria

La plupart des implémentations Firdaria s'arrêtent en chemin

Ce que livre notre Firdaria API

Des performances API sur lesquelles vous pouvez compter

Ce que fait l'endpoint Firdaria

Cascade L1 complète

Sous-périodes L2 incluses

Routage selon la secte

Périodes des nœuds gérées correctement

Lookup de période active

Sortie de dates ISO

Backend Swiss Ephemeris

Support timeline combinée

Hooks d'interprétation

Longueur d'année tropique

Qu'est-ce que Firdaria ? Guide développeur de l'API des seigneurs du temps perses

Comment fonctionne Firdaria ? Le cycle de 75 ans expliqué

Pourquoi la secte compte, et comment on la détecte

L1 vs L2 : ce que vous récupérez dans le JSON

Firdaria comparée aux autres techniques de seigneurs du temps

Quand utiliser Firdaria dans vos features produit

Pourquoi construire sur notre API plutôt que faire le vôtre

Use Cases

SaaS d'astrologie médiévale

Applis perses et adjacentes au védique

Chatbots d'astrologie IA

Plateformes éducatives

Rapports de lecture annuels

Dashboards de timing pour astrologues

Technical Specifications

APIs Firdaria comparées

Autres APIs de timing du stack

API Profections Annuelles

API Vimshottari Dasha

API Zodiacal Releasing

API Décennaires

API d'Astrologie Traditionnelle

API Timing

References & Standards

Tarifs Simples et Transparents

Toujours Gratuit

Pro

Pro Plus

Ultra

Plans Haut Volume

Business

Enterprise

FAQ de la Firdaria API

Qu'est-ce que Firdaria ?

D'où vient Firdaria historiquement ?

En quoi Firdaria diffère des profections, du zodiacal releasing et de la dasha védique ?

Pourquoi le jour vs la nuit compte pour Firdaria ?

Quelle est la durée des périodes majeures ?

L'API renvoie-t-elle les sous-périodes ?

À quoi ressemble la réponse JSON ?

Comment chercher la période active actuelle ?

Quelles éphémérides l'API utilise-t-elle ?

Puis-je combiner Firdaria avec d'autres techniques de timing en un seul appel ?

Quels inputs l'API attend-elle ?

Pour quels ICPs cet endpoint est-il pensé ?

Puis-je utiliser Firdaria dans une appli boostée par LLM ?

Combien coûte la Firdaria API ?

Y a-t-il une limite d'usage sur le tier gratuit ?

À quelle vitesse répond l'endpoint ?

L'API supporte-t-elle les requêtes en batch ?

Connectez Firdaria au reste du stack de timing

Livrez Firdaria dans l'après-midi, pas dans un sprint

La plupart des implémentations Firdaria s'arrêtent en chemin

Ce que livre notre Firdaria API

Des performances API sur lesquelles vous pouvez compter

Ce que fait l'endpoint Firdaria

Cascade L1 complète

Sous-périodes L2 incluses

Routage selon la secte

Périodes des nœuds gérées correctement

Lookup de période active

Sortie de dates ISO

Backend Swiss Ephemeris

Support timeline combinée

Hooks d'interprétation