Un solo endpoint.
Ciclo persa completo de 75 años con periodos mayores L1 y subperiodos L2. La secta se detecta desde la carta, no con un flag manual.
La mayoría de apps que usan Firdaria también usan
Números que medimos en producción
Diseñado para desarrolladores, no para UIs de escritorio
La técnica de Abu Ma'shar del siglo IX, servida en JSON
Firdaria (también escrita alfridaria, fardar o firdar) es un sistema persa de señores del tiempo que divide la vida en periodos planetarios. Abu Ma'shar la describió en el siglo IX, Bonatti la mencionó en el siglo XIII y Vivian Robson la resumió para astrólogos angloparlantes en el siglo XX. Las cartas diurnas corren un ciclo de 75 años empezando por el Sol. Las cartas nocturnas empiezan por la Luna y usan un orden planetario distinto. Cada periodo mayor (L1) se divide en siete subperiodos (L2) regidos en orden caldeo. Nuestra API devuelve la cascada completa L1 + L2 en una sola petición, elige la secta correcta desde los datos natales e incluye los periodos de los nodos que la mayoría de implementaciones omiten. Si estás construyendo una app de astrología medieval, un chatbot que cita fuentes tradicionales o un dashboard de timing, esta es la forma más rápida de añadir Firdaria sin reimplementar la matemática.
Firdaria divide la vida de una persona en periodos planetarios llamados L1, y luego divide cada L1 en siete subperiodos L2.
Las cartas diurnas empiezan por el Sol: Sol 10 años, Venus 8, Mercurio 13, Luna 9, Saturno 11, Júpiter 12, Marte 7, y luego el Nodo Medio y el Nodo Sur se reparten 3 + 2 años.
Suma todo y obtienes 75 años.
Las cartas nocturnas empiezan por la Luna y siguen otro orden: Luna 9, Saturno 11, Júpiter 12, Marte 7, Sol 10, Venus 8, Mercurio 13, y después los nodos.
El total es el mismo.
Cada periodo L1 se divide en siete trozos L2 iguales, regidos en orden caldeo (Saturno, Júpiter, Marte, Sol, Venus, Mercurio, Luna) empezando por el planeta que rige el L1.
Los nodos no reciben división L2.
Es la tradición, no un bug.
La secta es la distinción diurno/nocturno en la astrología tradicional.
Si el Sol está sobre el horizonte al nacer, la carta es diurna.
Si está debajo, es nocturna.
Firdaria usa la secta para decidir qué secuencia corre.
Una carta diurna calculada por error con el orden nocturno devuelve regentes equivocados para todos los periodos de la vida.
Nuestra API revisa la posición de casa del Sol desde los datos natales y enruta automáticamente a la secuencia correcta.
No pasas un flag day_chart.
El endpoint hace la comprobación, devuelve sect: "diurnal" o sect: "nocturnal" en la respuesta, y tú puedes mostrarlo en tu UI.
Si quieres sobreescribirlo (nacimientos en penumbra, latitudes polares), la lógica subyacente queda expuesta en la respuesta para que puedas razonar sobre ella.
Una entrada L1 contiene el planeta regente, years (un entero entre 2 y 13), start_date y end_date como strings ISO, un booleano node_period y un array l2_periods.
El array l2_periods tiene siete entradas en periodos no-nodo y está vacío para periodos de nodo.
Cada entrada L2 tiene planet, start_date, end_date.
La división es uniforme: un L1 de 12 años da siete periodos L2 de aproximadamente 1,71 años cada uno.
Usamos 365.2422 días por año (la duración del año trópico) para que la matemática cuadre con cómo los astrólogos cuentan habitualmente los periodos de Firdaria.
Si llamas al endpoint con un as_of_date, la respuesta también incluye un objeto active que te dice qué L1 y qué L2 están corriendo en esa fecha.
Útil para apps de chat que responden "¿en qué periodo estoy ahora mismo?".
Las profecciones mueven el ascendente una casa por año a lo largo de un ciclo de 12 años.
Simple, se repite a menudo, contexto ligero.
La liberación zodiacal recorre periodos fijos basados en signos L1, L2, L3, L4.
Mucho más pesada, y los periodos hacen bucle en una duración fija (por ejemplo, 8 años para la Suerte del Espíritu en Aries).
El Dasha Vimshottari védico cubre 120 años con nueve periodos anclados al nakshatra de la Luna natal.
Firdaria queda entre las profecciones y ZR: más larga que las profecciones, más simple que ZR, sensible a la secta de un modo en que Vimshottari no lo es.
Muchos astrólogos tradicionales corren profecciones + Firdaria + ZR juntas.
Nuestro endpoint /timing/timeline agrega las cuatro (profecciones, ZR, decenios, Firdaria) en una sola línea temporal fusionada, así tu front-end no tiene que cosir cuatro llamadas.
Firdaria funciona bien para informes anuales, panorámicas de fases de vida y contexto de chatbot.
El periodo L1 da un tema multianual ("los años de Marte") sobre el que es fácil escribir copy.
El subperiodo L2 da una ventana más estrecha de unos meses a dos años, buena para prompts predictivos.
Combina Firdaria con impactos de tránsitos para marcar eventos concretos dentro de un periodo conocido.
Por ejemplo: "Estás en tu L1 de Marte / sub-L2 de Saturno, y Marte forma cuadratura con tu Sol natal el mes que viene".
Esa combinación se lee natural en una herramienta de coaching y le da al LLM suficiente estructura para fundamentar su respuesta.
Firdaria también encaja bien en apps educativas porque las reglas son cortas y aprendibles, a diferencia de ZR que necesita un capítulo de contexto.
Firdaria en sí no es matemática complicada.
Es aritmética de timedelta sobre constantes planeta-año.
La parte difícil es el sistema que la rodea: detección de secta, casos extremos en latitudes polares, manejo de nodos que respete la tradición, salida de fechas ISO que no derive entre años y comportamiento consistente en los límites de año.
Nuestro servicio está endurecido contra eso.
Además se entrega junto a más de 100 endpoints, así que si más adelante necesitas cartas natales, tránsitos, profecciones o retornos solares, no pagas un segundo coste de integración.
El nivel gratuito ofrece 50 peticiones al mes, los planes de pago empiezan en $11/mes.
Puedes estar en producción en una tarde.
Herramientas para astrólogos tradicionales que ya trabajan con Firdaria, profecciones y ZR. Una API, cuatro sistemas de señores del tiempo.
Firdaria tiene atractivo cruzado persa-indio. Combínala con Dasha Vimshottari para apps dirigidas a ambos públicos.
Inyecta contexto L1 + L2 + periodo activo en el prompt. El bot responde "¿en qué periodo estoy?" sin alucinar fechas.
Las reglas de Firdaria son cortas y enseñables. Usa la API como backend de cálculo para cursos sobre Abu Ma'shar y Bonatti.
Genera informes PDF o web que muestran el L1 + L2 activos con sus rangos de fechas. Los clientes reciben una narrativa anual clara.
Combina Firdaria con profecciones y tránsitos en una sola vista. Los profesionales dejan de saltar entre pestañas de apps de escritorio.
| Endpoint | POST /api/v3/timing/firdaria |
| Respuesta Media | ~220ms |
| Respuesta P95 | <400ms |
| Duración del Ciclo | 75 años (diurno y nocturno) |
| Periodos L1 Devueltos | 9 (7 planetas + 2 nodos) |
| Subperiodos L2 | 7 por cada L1 no-nodo (orden caldeo) |
| Detección de Secta | Automática desde la posición de casa del Sol |
| Duración del Año | 365.2422 días (año trópico) |
| Efemérides | Swiss Ephemeris (swisseph) |
| Formato de Fecha | ISO 8601 (YYYY-MM-DD) |
| Búsqueda de Periodo Activo | Parámetro opcional as_of_date |
| Agregación de Timeline | Salida combinada vía /timing/timeline |
| Rate Limit (Gratis) | 50 peticiones/mes |
| Rate Limit (Business) | 220.000 peticiones/mes |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 en una llamada | Sí | Solo L1 |
| Auto-detección de secta | Sí, desde la carta | Flag manual diurno/nocturno |
| Periodos de nodos incluidos | Sí (Medio + Sur) | Omitidos |
| Tiempo de respuesta | ~220ms | 1-3 segundos |
| Endpoint de timeline combinado | Sí (4 técnicas) | No disponible |
| Periodo activo en fecha | Sí (parámetro as_of_date) | Calcular en cliente |
| Nivel gratuito | 50 peticiones/mes | Solo de pago |
| Backend de efemérides | Swiss Ephemeris | Propietario / poco claro |
Ciclo de 12 años, regente del año, más ligero que Firdaria.
Ciclo védico de señores del tiempo de 120 años. Cruce útil para audiencias persas.
Periodos helenísticos L1-L4 basados en signos. Próximamente.
Periodos planetarios helenísticos de 10 años. Próximamente.
Secta, regentes de triplicidad, almuten — la base sobre la que se asienta Firdaria.
Un endpoint que devuelve profecciones, Firdaria, ZR y decenios fusionados en una sola línea temporal.
Comienza gratis, escala a medida que creces. Sin cargos ocultos.
Para apps pequenas y proyectos personales
Para apps en crecimiento y trafico medio
Para aplicaciones a escala empresarial
Todos los planes incluyen documentacion completa y SDKs
Preguntas? Habla con nuestro equipo
Preguntas que los desarrolladores hacen de verdad