Endpoint único.
Ciclo persa completo de 75 anos com períodos maiores L1 e subperíodos L2. Seita detectada a partir do mapa, sem flag manual.
A maioria dos apps que usam Firdaria também usa
Números que medimos em produção
Projetado para desenvolvedores, não para UIs desktop
A técnica do século IX de Abu Ma'shar, servida em JSON
Firdaria (também grafada alfridaria, fardar ou firdar) é um sistema persa de senhor do tempo que divide a vida em períodos planetários. Abu Ma'shar descreveu a técnica no século IX, Bonatti a referenciou no século XIII, e Vivian Robson a resumiu para astrólogos de língua inglesa no século XX. Mapas diurnos rodam um ciclo de 75 anos começando pelo Sol. Mapas noturnos começam pela Lua e usam uma ordem planetária diferente. Cada período maior (L1) é dividido em sete subperíodos (L2) regidos em ordem caldaica. Nossa API retorna a cascata completa L1 + L2 em uma única requisição, escolhe a seita correta a partir dos dados de nascimento e inclui os períodos dos nodos que a maioria das implementações pula. Se você está construindo um app de astrologia medieval, um chatbot que cita fontes tradicionais ou um dashboard de timing, este é o jeito mais rápido de adicionar Firdaria sem reimplementar a matemática.
Firdaria divide a vida da pessoa em períodos planetários chamados L1, depois divide cada L1 em sete subperíodos L2.
Mapas diurnos começam pelo Sol: Sol 10 anos, Vênus 8, Mercúrio 13, Lua 9, Saturno 11, Júpiter 12, Marte 7, depois o Nodo Médio e o Nodo Sul dividem 3 + 2 anos.
Somando tudo dá 75 anos.
Mapas noturnos começam pela Lua e seguem uma ordem diferente: Lua 9, Saturno 11, Júpiter 12, Marte 7, Sol 10, Vênus 8, Mercúrio 13, depois os nodos.
O total é o mesmo.
Cada período L1 é dividido em sete fatias L2 iguais, regidas em ordem caldaica (Saturno, Júpiter, Marte, Sol, Vênus, Mercúrio, Lua) começando pelo planeta que rege o L1.
Nodos não recebem divisão L2.
Isso é tradição, não bug.
Seita é a distinção diurno/noturno na astrologia tradicional.
Se o Sol está acima do horizonte no nascimento, o mapa é diurno.
Se está abaixo, noturno.
Firdaria usa a seita para escolher qual sequência rodar.
Um mapa diurno que erroneamente usa a ordem noturna retorna regentes errados em todos os períodos da vida.
Nossa API checa a posição do Sol nas casas a partir dos dados de nascimento e roteia para a sequência correta automaticamente.
Você não passa uma flag day_chart.
O endpoint faz a checagem, retorna sect: "diurnal" ou sect: "nocturnal" na resposta, e você pode mostrar isso na sua UI.
Se quiser sobrescrever (nascimentos crepusculares, latitudes polares), a lógica fica exposta na resposta para você analisar.
Uma entrada L1 contém o planeta regente, years (inteiro de 2 a 13), start_date e end_date como strings ISO, um booleano node_period e um array l2_periods.
O array l2_periods tem sete entradas para períodos não-nodais e fica vazio para períodos de nodos.
Cada entrada L2 tem planet, start_date, end_date.
A divisão é uniforme: um L1 de 12 anos gera sete períodos L2 de aproximadamente 1,71 anos cada.
Usamos 365,2422 dias por ano (a duração do ano tropical) para que a matemática bata com a forma como astrólogos normalmente contam períodos de Firdaria.
Se você chamar o endpoint com as_of_date, a resposta também inclui um objeto active que diz qual L1 e qual L2 estão rodando naquela data.
Útil pra chat apps que respondem "em que período eu estou agora?".
Profecções movem o ascendente uma casa por ano em um ciclo de 12 anos.
Simples, repete com frequência, contexto leve.
Zodiacal releasing roda períodos baseados em signos com níveis L1, L2, L3, L4.
Bem mais pesado, e os períodos fazem loop em duração fixa (ex.: 8 anos para Lote do Espírito em Áries).
A Vimshottari Dasha védica cobre 120 anos usando nove períodos ancorados na nakshatra da Lua natal.
Firdaria fica entre profecções e ZR: mais longa que profecções, mais simples que ZR, sensível à seita de um jeito que a Vimshottari não é.
Muitos astrólogos tradicionais rodam profecções + Firdaria + ZR juntos.
Nosso endpoint /timing/timeline agrega as quatro técnicas (profecções, ZR, decenais, Firdaria) em uma timeline unificada para que seu front-end não precise costurar quatro chamadas.
Firdaria funciona bem para relatórios anuais, visões gerais de fases da vida e contexto pra chatbot.
O período L1 entrega um tema plurianual ("os anos de Marte") fácil de escrever copy.
O subperíodo L2 entrega uma janela mais apertada, de alguns meses a dois anos, boa para prompts preditivos.
Combine Firdaria com trânsitos para sinalizar eventos específicos dentro de um período conhecido.
Por exemplo: "Você está no seu período L1 de Marte / L2 de Saturno, e Marte faz quadratura com seu Sol natal no mês que vem." Essa combinação lê natural numa ferramenta de coaching e dá estrutura suficiente para um LLM ancorar a resposta.
Firdaria também encaixa bem em apps educativos porque as regras são curtas e aprendíveis, ao contrário de ZR que precisa de um capítulo de fundamentos.
Firdaria em si não é uma matemática difícil.
É aritmética de timedelta sobre constantes de anos planetários.
A parte difícil é o sistema ao redor: detecção de seita, edge cases em latitudes polares, tratamento de nodos que bate com a tradição, saída de datas ISO que não desliza ao longo dos anos e comportamento consistente nas viradas de ano.
Nosso serviço já está endurecido contra isso.
Também roda ao lado de mais de 100 outros endpoints, então se você depois precisar de mapas natais, trânsitos, profecções ou retornos solares, não paga um segundo custo de integração.
O free tier dá 50 requisições por mês, planos pagos começam em $11/mês.
Você pode estar no ar em uma tarde.
Ferramentas que atendem astrólogos tradicionais que já trabalham com Firdaria, profecções e ZR. Uma API, quatro sistemas de senhor do tempo.
Firdaria tem apelo de cruzamento persa-indiano. Combine com Vimshottari Dasha para apps que miram nos dois públicos.
Alimente L1 + L2 + contexto do período ativo no prompt. O bot responde "em que período estou?" sem alucinar datas.
As regras de Firdaria são curtas e ensináveis. Use a API como backend de cálculo para cursos sobre Abu Ma'shar e Bonatti.
Gere relatórios em PDF ou web mostrando o L1 + L2 ativos com intervalos de datas. Clientes recebem uma narrativa anual clara.
Combine Firdaria com profecções e trânsitos em uma única visão. Profissionais param de pular entre abas de softwares desktop.
| Endpoint | POST /api/v3/timing/firdaria |
| Resposta Média | ~220ms |
| Resposta P95 | <400ms |
| Duração do Ciclo | 75 anos (diurno e noturno) |
| Períodos L1 Retornados | 9 (7 planetas + 2 nodos) |
| Subperíodos L2 | 7 por L1 não-nodal (ordem caldaica) |
| Detecção de Seita | Automática pela posição do Sol nas casas |
| Duração do Ano | 365,2422 dias (ano tropical) |
| Efeméride | Swiss Ephemeris (swisseph) |
| Formato de Data | ISO 8601 (YYYY-MM-DD) |
| Lookup de Período Ativo | Parâmetro opcional as_of_date |
| Agregação de Timeline | Saída combinada via /timing/timeline |
| Rate Limit (Free) | 50 requisições/mês |
| Rate Limit (Business) | 220.000 requisições/mês |
| Feature | Astrology API | Others |
|---|---|---|
| L1 + L2 em uma chamada | Sim | Apenas L1 |
| Detecção automática de seita | Sim, pelo mapa | Flag manual diurno/noturno |
| Períodos de nodo incluídos | Sim (Médio + Sul) | Pulados |
| Tempo de resposta | ~220ms | 1-3 segundos |
| Endpoint de timeline combinada | Sim (4 técnicas) | Indisponível |
| Período ativo na data | Sim (param as_of_date) | Calcular no client |
| Free tier | 50 requisições/mês | Apenas pago |
| Backend de efeméride | Swiss Ephemeris | Proprietário / não declarado |
Ciclo de 12 anos, regente do ano, mais leve que Firdaria.
Ciclo védico de senhor do tempo de 120 anos. Cruzamento útil para públicos persas.
Períodos helenísticos baseados em signos L1-L4. Em breve.
Períodos planetários helenísticos de 10 anos. Em breve.
Seita, regentes de triplicidade, almuten — a base sobre a qual Firdaria se apoia.
Um endpoint que retorna profecções, Firdaria, ZR e decenais mescladas em uma única timeline.
Comece gratis, escale conforme cresce. Sem taxas ocultas.
Para apps pequenos e projetos pessoais
Para apps em crescimento e trafego medio
Para aplicacoes em escala empresarial
Todos os planos incluem documentacao completa e SDKs
Duvidas? Fale com nossa equipe
Perguntas que devs realmente fazem