O que é astrologia eletiva e como esta API a automatiza?

Astrologia eletiva é escolher o melhor momento astrológico para iniciar algo importante. Tradicionalmente, astrólogos gastam de 1 a 4 horas verificando centenas de momentos candidatos contra critérios ponderados. Nossa API automatiza todo o processo: envie uma atividade e um intervalo de datas e receba de volta janelas pontuadas de 0 a 100 com detalhamento de fatores e justificativa em linguagem natural em menos de 2 segundos. Três endpoints: /search para intervalos de datas, /evaluate para momentos únicos, /glossary para a taxonomia de atividades.

O que diferencia isso de APIs védicas de muhurta como Prokerala ou KundliAPI?

Duas diferenças fundamentais. Primeiro, fazemos astrologia eletiva ocidental (zodíaco tropical, casas Placidus, dignidades planetárias tradicionais), enquanto Prokerala/KundliAPI fazem muhurta védico (sideral, Choghadiya, Tithi). Segundo, eles retornam Auspicioso/Inauspicioso binário ou listas planas de datas. Nós retornamos pontuações numéricas 0-100 com detalhamento de 31 fatores, mapas de calor em calendário e texto de justificativa em linguagem natural. Ninguém mais oferece comprovação de fatores.

Quanto custa a API de Astrologia Eletiva?

Plano gratuito: 50 requisições/mês. Starter: $11/mês para 1.000 requisições. Professional: $37/mês para 55.000 requisições. Business: $99/mês para 220.000 requisições. Enterprise: $399+/mês para uso ilimitado. Compare com softwares eletivos de desktop a US$ 300-700 de pagamento único, ou consultas eletivas profissionais a US$ 300-800 cada.

Quão rápida é a busca eletiva para grandes intervalos de datas?

Uma busca de 90 dias é concluída em menos de 2 segundos no p95. Uma busca de 367 dias (máximo) leva cerca de 4 a 5 segundos. O /evaluate de momento único responde em menos de 300ms. O desempenho vem da arquitetura de duas passagens: primeiro o mapa de calor rápido em nível de dia, depois o aprofundamento de precisão apenas nos melhores dias. O cache Redis proporciona aceleração de 430x em requisições repetidas.

Como funciona a regra de segurança por área do corpo em cirurgia e odontologia?

Quando a atividade é 'surgery', você precisa fornecer extra_params.body_area (uma de 15 áreas: cabeça, rosto, pescoço, garganta, braços, peito, coração, estômago, costas, rins, sistema reprodutor, coxas, joelhos, panturrilhas, pés). A API aplica a regra tradicional: a Lua não pode estar no signo do zodíaco que rege aquela área do corpo. A atividade 'dental' (dentes e mandíbula) compartilha a mesma lógica de segurança da Lua no signo por área do corpo. Para emergências, defina emergency_mode: true para ignorar os bloqueios absolutos com texto de aviso obrigatório.

O que é o mapa de calor em calendário e como uso?

O mapa de calor é um resumo de pontuações dia a dia para todo o intervalo de busca. Cada dia recebe uma pontuação composta (calculada ao meio-dia) e um grupo de nota (excelente/bom/razoável/ruim/bloqueado). Renderize-o como um calendário codificado por cores na sua interface. Os usuários veem num relance quais semanas são favoráveis e depois aprofundam em dias específicos para recomendações detalhadas de janelas.

O que são comprovações de fatores e por que elas importam?

Cada janela pontuada inclui um detalhamento completo fator a fator: 31 avaliações individuais de fatores mostrando o nome do fator, o nível de satisfação (0.0-1.0), o texto de observação, a contribuição do peso e o status. É como um recibo da pontuação. Astrólogos profissionais podem verificar e defender cada recomendação para seus clientes. Nenhum concorrente oferece esse nível de transparência.

Como integro a API Eletiva no meu app?

API REST padrão. Faça um POST para /api/v3/electional/search com activity, date_range e location. A resposta é um JSON com heatmap, top_windows, excluded_ranges. Para momento único: POST para /evaluate. Para menus suspensos de interface: GET /glossary/activities. SDKs para JavaScript, Python, PHP, Ruby. A maioria dos desenvolvedores integra o fluxo básico em menos de 1 hora.

Posso usar isso com agentes de IA e LLMs?

Sim, foi projetada para isso. A ferramenta MCP find_best_time já está registrada para integração com agentes de IA usando Claude, ChatGPT e agentes personalizados. Defina summary_mode: true para uma saída compacta que cabe nas janelas de contexto de chat (as 3 melhores janelas + justificativa de 1 linha). O endpoint /glossary/activities fornece sinônimos de atividades para classificação de intenção por LLM.

O que é o aviso pessoal e como funciona a entrada de mapa natal?

Se você fornecer um natal_chart (dados de nascimento) na requisição, duas coisas acontecem: (1) um modificador natal ajusta as pontuações universais em até mais/menos 20% com base nos trânsitos aos planetas natais, e (2) o detector PersonalAdvisory destaca trânsitos pessoais importantes (retorno de Saturno, aspectos duros de planetas externos) mesmo quando a pontuação universal é alta. Isso evita recomendar uma data universalmente boa que seja pessoalmente terrível.

Quais bloqueios absolutos o motor eletivo verifica?

23 verificadores de bloqueio absoluto dedicados avaliam: eclipses solares e lunares (janelas assimétricas), períodos de Mercúrio/Vênus/Marte retrógrados, Lua fora de curso, planetas combustos, conflitos da Lua no signo por área do corpo (cirurgia) e condições específicas da atividade. Momentos bloqueados são excluídos por completo dos resultados, com explicações no array excluded_ranges.

Quão precisos são os cálculos astronômicos?

Dados Swiss Ephemeris JPL DE431 com precisão de 0,001 segundo de arco. A mesma fonte de dados usada pela NASA. Posições planetárias, aspectos, fases lunares, eclipses, retrogradações e ingressos são todos calculados a partir dessas efemérides padrão-ouro. Três rodadas de validação por astrólogos em atividade confirmaram que todos os fatores retornam resultados corretos.

Posso filtrar os resultados da busca por horário do dia ou dia da semana?

Sim. O parâmetro filters aceita hours_from e hours_to (ex.: 9-21 apenas para o dia), days_of_week (ex.: ['fri', 'sat', 'sun'] para casamentos de fim de semana) e exclude_dates para datas específicas a pular. Isso reduz drasticamente o espaço de busca e melhora a relevância.

Quais linguagens de programação funcionam com a API Eletiva?

Qualquer linguagem com suporte a HTTP. SDKs oficiais para JavaScript/Node.js, Python, PHP e Ruby. A API retorna JSON padrão. A maioria dos desenvolvedores integra com fetch/axios em apps de frontend ou requests/httpx em serviços de backend. Especificação OpenAPI completa disponível para gerar clientes automaticamente em qualquer linguagem.

Existe um plano gratuito para a API Eletiva?

Sim, 50 requisições gratuitas todo mês. Isso basta para testar todo o fluxo de busca e avaliação, explorar todas as 34 atividades predefinidas e prototipar sua integração antes de assinar um plano pago. O plano gratuito inclui todos os recursos - sem bloqueio de funcionalidades.

Como a predefinição de casamento lida com Vênus retrógrado?

A predefinição de casamento inclui Vênus retrógrado como bloqueio absoluto - qualquer momento durante Vênus Rx é excluído dos resultados com uma explicação. Ela também aplica o aviso de retorno de Saturno se o mapa natal mostrar um retorno de Saturno dentro do intervalo de busca, e a exclusão da Lua fora de curso para o timing da cerimônia. A dignidade de Vênus e a fase lunar estão entre os fatores de maior peso.

Posso usar a API para o timing de lançamento de negócios?

Sim, a predefinição de negócios é uma das 34 atividades suportadas. Ela prioriza as condições de Mercúrio (evitando retrogradação e combustão), aspectos de Júpiter para crescimento, fase da Lua (crescente preferida) e a força da casa 10. Os bloqueios absolutos incluem Mercúrio Rx, eclipses e Lua fora de curso. Há predefinições separadas para assinatura/contrato, lançamento de produto, compra, venda e empréstimo, então você pode escolher a que corresponde ao evento de negócios exato.

Como vocês pontuam o timing de casamento, namoro e divórcio?

Cada um é sua própria predefinição. Casamento e namoro ponderam fortemente as condições de Vênus (dignidade, aspectos, ausência de retrogradação e combustão), favorecem uma Lua crescente e excluem Lua fora de curso e eclipses. O divórcio usa fatores diferentes de áreas da vida - não busca um momento 'de sorte', mas sim evita as piores condições da Lua e de maléficos em ângulos para uma ruptura limpa. Os três retornam pontuações 0-100 com notas e justificativa por janela, para que os usuários vejam por que uma data supera outra.

Posso encontrar o melhor momento para um corte de cabelo ou procedimento estético?

Sim. As predefinições de corte de cabelo e procedimento estético usam o timing lunar tradicional - uma Lua crescente para o crescimento (bom para cortes de cabelo em que se deseja um recrescimento mais cheio) e fatores da Lua no signo para a área do corpo. São recursos de autocuidado do dia a dia para apps de bem-estar. Envie a atividade 'haircut' ou 'cosmetic procedure' com um intervalo de datas e uma localização e receba de volta janelas pontuadas com notas de excelente a ruim.

A API suporta o timing de plantio e colheita para a agricultura?

Sim. As predefinições de plantio e colheita usam preferências de Lua crescente/minguante e mansões lunares, a base tradicional do timing eletivo agrícola. O plantio geralmente favorece uma Lua crescente para culturas que crescem acima do solo; a colheita favorece uma Lua minguante para armazenamento. Ambos retornam pontuações 0-100, um mapa de calor em calendário para toda a estação e uma justificativa que explica a fase lunar e o raciocínio da Lua no signo para cada janela.

Quais notas a API retorna junto com a pontuação?

Cada pontuação 0-100 mapeia para uma nota: excelente (90-100), bom (75-89), razoável (60-74), cautela (40-59), ruim (0-39). A nota dá à sua interface um rótulo e um grupo de cor instantâneos sem que você precise definir limiares. O mapa de calor em calendário usa a mesma graduação, então os usuários varrem um mês inteiro e identificam os dias excelentes num relance, e depois aprofundam em janelas específicas.

Quais idiomas o texto de justificativa suporta?

9 idiomas: inglês, russo, alemão, espanhol, francês, italiano, português, chinês e hindi. Defina o parâmetro language e a justificativa em linguagem natural, as observações de fatores e as explicações dos intervalos excluídos voltam localizadas. Isso significa que você pode lançar recursos de timing astrológico para um público global sem escrever suas próprias traduções do texto de raciocínio.

Posso controlar o quão precisas são as janelas candidatas?

Sim, com o parâmetro granularity: 1m, 5m, 15m, 1h, 4h ou 1d. Use 1d ou 4h para uma varredura rápida de uma estação inteira e depois 1m ou 5m para definir o horário exato de início de uma cerimônia ou cirurgia dentro dos melhores dias. A busca em duas passagens mantém isso rápido - o mapa de calor em nível de dia roda primeiro, depois a passagem de precisão aprofunda apenas nos melhores dias com a granularidade que você escolher.

As 34 atividades predefinidas são revisadas por astrólogos reais?

Sim. O catálogo cresceu do conjunto original para 34 predefinições ao longo de três ondas de lançamento (Ondas 1-3), cada uma revisada por astrólogos. Os revisores verificaram os pesos dos fatores, as regras de bloqueio absoluto e a lógica específica de cada atividade - Lua no signo por área do corpo em cirurgia e odontologia, ênfase em Vênus para casamento e namoro, Lua crescente/minguante para plantio e colheita. As regras seguem a prática eletiva tradicional, não uma pontuação arbitrária.

Posso impor minhas próprias regras absolutas, como 'a Lua deve estar crescente'?

Sim. Além do motor de pontuação de 0 a 100, você pode passar filtros de critérios absolutos personalizados que toda janela retornada DEVE satisfazer. Os filtros suportados incluem moon_waxing (a Lua deve estar crescente), planet_dignified (um planeta escolhido deve estar em sua dignidade) e planet_angular (um planeta escolhido deve estar sobre um ângulo). Eles funcionam como portões de aprovação/reprovação, não como ajustes suaves de pontuação - qualquer momento que reprove em um filtro é excluído dos resultados, de modo que você pode impor as regras eletivas inegociáveis que sua tradição exige sem tocar nos pesos da predefinição.

Vocês sinalizam planetas combustos na janela escolhida?

Sim. /search e /evaluate retornam combust_flags por significador, mostrando quais planetas estão combustos (próximos demais do Sol) em cada janela pontuada. Você pode ler os flags para identificar e evitar um significador combusto antes de recomendar uma data. A combustão já influencia a pontuação e os bloqueios absolutos, mas combust_flags a expõe explicitamente por significador para que sua interface possa avisar os usuários ou deixá-los filtrar as janelas combustas.

Posso renderizar o mapa de um momento recomendado sem uma segunda chamada?

Sim. Toda janela pontuada em /search e /evaluate agora retorna body_positions - as posições planetárias completas (signo, grau e casa) naquele horário exato. Você as lê diretamente da resposta e desenha o mapa de qualquer momento recomendado na sua interface, sem precisar de uma requisição adicional. Isso elimina um ida e volta: escolha uma das melhores janelas, renderize a roda dela a partir do mesmo payload e mostre aos usuários o céu real por trás da pontuação.

Astrologia Eletiva

Encontre o Melhor Momento para Qualquer Coisa. Pontuado de 0 a 100.

Primeira API REST de astrologia eletiva ocidental com pontuação numérica.

Mapa de calor em calendário, 34 atividades predefinidas (cirurgia, casamento, negócios, plantio, corte de cabelo e mais), detalhamento de fatores com comprovação, justificativa em linguagem natural em 9 idiomas. Nenhum concorrente oferece isso. Mercado comprovadamente vazio.

Ver Documentação

0-100

Pontuação Numérica

Atividades Predefinidas

Avaliadores de Fatores

<2s

Busca de 90 Dias

Primeira API REST eletiva ocidental

Precisão do Swiss Ephemeris

Pronta para MCP em agentes de IA

Ferramentas apenas para desktop (Solar Fire, Janus): sem API, sem pontuação, interface dos anos 1990
Ferramentas web (Astro-Seek): pontuação como caixa-preta, máximo de 90 dias, sem exportação
APIs védicas (Prokerala, KundliAPI): apenas binário Auspicioso/Inauspicioso, nada ocidental
A KundliAPI retorna listas planas de datas sem pontuações, sem mapas de calor, sem justificativas
Nenhuma API existente retorna detalhamento de fatores, justificativa em linguagem natural ou mapas de calor em calendário

Transforme com

Pontuação numérica 0-100 com comprovação transparente fator a fator
Mapa de calor em calendário para varredura visual de intervalos de datas num relance
34 atividades predefinidas: cirurgia, casamento, negócios, contratos, plantio, corte de cabelo, divórcio e mais
Justificativa em linguagem natural por janela em 9 idiomas: "por que este momento é bom"
Ferramenta find_best_time chamável via MCP para agentes de IA e integração com LLM

Desempenho da API Eletiva

Feita para produção, validada por astrólogos

0-100

Faixa de Pontuação

Atividades Predefinidas

31 + 23

Fatores + Bloqueios Absolutos

<2 segundos

Busca de 90 Dias

<300ms

Avaliação Única

293 testes

Cobertura de Testes

Recursos Completos de Astrologia Eletiva

31 fatores, 23 bloqueios absolutos, 34 atividades predefinidas, 9 idiomas, 3 endpoints

Busca por Intervalo de Datas

Avaliação de Momento Único

34 Atividades Predefinidas

Motor de Pontuação

Integração com IA e LLM

Notas e Localização

Janelas Prontas para o Mapa

Pontuação Explicável

O Que É a API de Astrologia Eletiva? Guia Completo para Desenvolvedores

A primeira API REST para encontrar momentos astrologicamente ideais - com pontuações reais

O que é astrologia eletiva? É a prática antiga de escolher o melhor momento para iniciar algo importante - uma cirurgia, um casamento, o lançamento de um negócio, a assinatura de um contrato, até mesmo plantar um jardim ou cortar o cabelo. A API agora cobre 34 atividades predefinidas, todas revisadas por astrólogos ao longo de três ondas de lançamento. Astrólogos profissionais cobram US$ 300 a US$ 800 por consulta eletiva, gastando de 1 a 4 horas verificando manualmente centenas de momentos candidatos. Nossa API de Astrologia Eletiva é o primeiro endpoint REST que automatiza todo esse processo com saída em JSON estruturado. Você envia uma atividade e um intervalo de datas e recebe de volta uma pontuação 0-100 para cada momento candidato, um mapa de calor em calendário mostrando dias bons e ruins num relance, um detalhamento fator a fator que mostra exatamente por que cada pontuação é o que é, e texto de justificativa em linguagem natural em 9 idiomas (en, ru, de, es, fr, it, pt, zh, hi). Nenhum outro provedor de API oferece pontuação eletiva ocidental - verificamos Solar Fire, Janus, AstroApp, Prokerala, AstrologyAPI.com, KundliAPI, VedicRishi. Todos confirmaram a lacuna. O ecossistema védico retorna classificações binárias de muhurta, não pontuações numéricas. Este é um mercado genuinamente vazio.

Como funciona a API de Astrologia Eletiva?

Três endpoints movem todo o sistema.

POST /search aceita uma atividade (como 'surgery' ou 'marriage'), um intervalo de datas (até 367 dias) e uma localização.

Ela executa uma busca em duas passagens: primeiro uma passagem rápida de mapa de calor em nível de dia, pontuando cada dia ao meio-dia, e depois uma passagem de precisão que aprofunda nos melhores dias com granularidade configurável (janelas de 1m, 5m, 15m, 1h, 4h ou 1d).

O resultado é um mapa de calor em calendário com dias graduados por cor, as melhores janelas ranqueadas com pontuações individuais, intervalos de datas excluídos (eclipses, retrogradações etc.) com explicações, e justificativa em linguagem natural por janela.

POST /evaluate pontua um único momento específico - perfeito para verificações do tipo 'esta data é boa?'.

GET /glossary/activities retorna todas as 34 atividades suportadas com sinônimos para correspondência de intenção por LLM e menus suspensos de interface.

Busca em duas passagens: mapa de calor primeiro, depois aprofundamento de precisão nos melhores dias

1 min read

O que torna esta API eletiva única?

Cinco coisas que nenhum concorrente oferece: (1) Pontuação numérica 0-100 com curvas de saturação - não é sim/não binário, nem um vago 'bom/ruim'.

(2) Mapa de calor em calendário - graduação visual dia a dia para um intervalo de datas inteiro.

(3) Detalhamento fator a fator ('comprovação') - cada pontuação vem com 31 avaliações individuais de fatores mostrando o nível de satisfação, a observação e a contribuição para a pontuação final.

Astrólogos profissionais podem defender cada recomendação.

(4) Justificativa em linguagem natural em 9 idiomas - explicações geradas por máquina para cada janela, prontas para exibir aos usuários ou alimentar LLMs.

(5) 34 atividades predefinidas com pesos ajustados - uma eleição de casamento prioriza as condições de Vênus de forma diferente de uma eleição de cirurgia, e o plantio pondera de outra maneira a fase lunar e a fertilidade da Lua no signo.

Cada predefinição tem pesos calibrados profissionalmente que somam 100, revisados por astrólogos ao longo de três ondas de lançamento.

A única API com pontuação numérica + mapa de calor + comprovação de fatores + justificativa em linguagem natural

1 min read

Quais atividades a API Eletiva suporta?

34 atividades predefinidas, todas revisadas por astrólogos ao longo de três ondas de lançamento.

Saúde e corpo: cirurgia, odontologia (dentes e mandíbula), medicação, concepção, parto, procedimento estético, corte de cabelo, desmame.

Relacionamentos e eventos de vida: casamento, namoro, divórcio, escolha de nome.

Negócios e dinheiro: negócios, assinatura/contrato, lançamento de produto, compra, venda, empréstimo, investimento, contratação, demissão.

Propriedade e mudança: mudança, realocação, locação, instalação, viagem.

Trabalho e estudo: prova, entrevista, estudo.

Terra e crescimento: plantio, colheita.

Além dos originais como casamento (cerimônia) e lançamento.

Cada predefinição define seus próprios pesos de fatores e regras de bloqueio absoluto.

Cirurgia e odontologia impõem a segurança da Lua no signo correspondente à área do corpo: a cirurgia exige um parâmetro body_area (15 áreas: cabeça, rosto, pescoço, garganta, braços, peito, coração, estômago, costas, rins, sistema reprodutor, coxas, joelhos, panturrilhas, pés) e a regra tradicional de que a Lua não pode estar no signo que rege a parte do corpo a ser operada.

Casamento e namoro ponderam as condições de Vênus e evitam Vênus retrógrado.

Plantio e colheita usam preferências de Lua crescente/minguante e mansões lunares.

Toda atividade está documentada no endpoint /glossary/activities com sinônimos.

34 atividades predefinidas com regras de segurança e pesos de fatores específicos de cada atividade

1 min read

Como funciona o motor de pontuação por dentro?

Cada predefinição define 31 fatores com pesos individuais que somam 100.

Para cada momento candidato, cada avaliador de fator retorna uma pontuação de satisfação (0.0-1.0), uma string de observação e detalhes opcionais.

Essas satisfações brutas passam por curvas de saturação (configuráveis por predefinição) antes da agregação ponderada em uma pontuação final 0-100, mapeada para uma nota: excelente (90-100), bom (75-89), razoável (60-74), cautela (40-59), ruim (0-39).

Os bloqueios absolutos são verificados separadamente por 23 verificadores dedicados: eclipses, planetas retrógrados, Lua fora de curso, planetas combustos, maléficos em ângulos, verificações de planeta em cúspide e condições específicas da atividade, como a Lua no signo da área do corpo em cirurgia e odontologia.

Um momento bloqueado é excluído por completo com uma explicação.

Além dos verificadores integrados, você pode passar seus próprios filtros de critérios absolutos - moon_waxing, planet_dignified, planet_angular - que toda janela retornada deve satisfazer, transformando preferências suaves de pontuação em portões inegociáveis.

Cada janela também carrega combust_flags por significador, para que você possa identificar e ignorar significadores combustos.

Se um mapa natal for fornecido, um modificador natal (limitado a mais ou menos 20%) ajusta a pontuação universal, e o detector PersonalAdvisory destaca trânsitos importantes, como o retorno de Saturno, mesmo quando a pontuação universal é alta.

31 fatores com curvas de saturação + 23 verificadores de bloqueio absoluto por momento

2 min read

O que cada janela pontuada retorna agora?

Dois aprimoramentos na resposta tornam os momentos recomendados autossuficientes e explicáveis.

Primeiro, toda janela pontuada carrega body_positions: as posições planetárias completas (signo, grau e casa) naquele horário exato.

Você renderiza o mapa de qualquer momento recomendado diretamente da resposta de search ou evaluate, sem uma segunda chamada de API - o mesmo payload alimenta tanto a pontuação 0-100 quanto a roda que você desenha na sua interface.

Segundo, toda janela agora indica seus key_significators: os planetas e regentes específicos que o motor de fato pontuou para aquela atividade.

Uma janela de casamento mostra os regentes de Vênus e da Lua que pesou; uma janela de cirurgia mostra os corpos que importaram para o procedimento.

Assim você mostra aos usuários por que um momento fica onde fica, em vez de um número solto.

A pontuação também classifica a combustão por gravidade e papel agora, não apenas com um sinalizador sim/não - um significador principal combusto derruba a pontuação muito mais do que um corpo combusto secundário, de modo que o ranking reflete o quanto a combustão realmente importa para aquela atividade.

body_positions + key_significators em cada janela, com combustão classificada por papel

1 min read

Como integro a API Eletiva?

REST padrão.

Envie um POST para /api/v3/electional/search com sua atividade, intervalo de datas e localização.

Receba de volta um JSON com heatmap, top_windows, excluded_ranges e summary.

Para verificações de momento único, faça um POST para /evaluate.

Para menus suspensos de interface ou correspondência de intenção por LLM, faça um GET em /glossary/activities, que retorna todas as 34 atividades com sinônimos.

Parâmetros opcionais: natal_chart para pontuação personalizada, filters para restrições de horário do dia e dia da semana, granularity (1m/5m/15m/1h/4h/1d) para a precisão das janelas, language para o texto da justificativa (en, ru, de, es, fr, it, pt, zh, hi), summary_mode para uma saída compacta e amigável a LLMs, e emergency_mode para cirurgias quando o procedimento não pode esperar.

A API foi projetada para ser chamável via MCP - a ferramenta find_best_time já está registrada para integração com agentes de IA.

3 endpoints, pronta para MCP, summary_mode amigável a LLM

1 min read

Quem usa a API de Astrologia Eletiva?

Cinco segmentos principais: (1) Desenvolvedores de apps de astrologia criando recursos de timing - o mapa de calor e as janelas pontuadas já são dados de interface prontos para renderizar, e as 34 atividades cobrem quase qualquer pergunta do tipo 'melhor momento para X' que os usuários fazem.

(2) Plataformas de casamento e eventos adicionando recomendações de datas - as predefinições de casamento e cerimônia lidam automaticamente com Vênus Rx, eclipses, Lua fora de curso e retorno de Saturno.

(3) Apps de saúde e bem-estar - as predefinições de cirurgia e odontologia impõem a segurança da Lua no signo da área do corpo, enquanto o timing de corte de cabelo, procedimento estético e medicação atende a recursos de autocuidado do dia a dia.

(4) Criadores de agentes de IA usando ferramentas MCP - a ferramenta find_best_time funciona de imediato com function calling da OpenAI/Anthropic.

(5) Astrólogos profissionais escalando sua prática - em vez de 1 a 4 horas por consulta, obtêm resultados pontuados instantâneos com comprovação de fatores para revisar e apresentar aos clientes.

A API faz o cálculo; o astrólogo fornece a expertise e o toque pessoal.

1 min read

Use Cases

Apps de Casamento e Eventos

Recomende datas ideais de casamento com análise de Vênus/Lua, aviso de retorno de Saturno e exclusão de eclipses. A comprovação de fatores explica cada recomendação.

Integração com Agentes de IA (MCP)

Ferramenta MCP find_best_time para ChatGPT, Claude e agentes de IA personalizados. O modo de resumo retorna JSON compacto para janelas de contexto de chat.

Ferramentas de Agendamento de Cirurgias

Segurança hipocrática com 15 áreas do corpo. Aplicação da regra da Lua no signo. Modo de emergência com texto de aviso obrigatório.

Plataformas de Lançamento de Negócios

Exclusão de Mercúrio retrógrado, exclusão de Lua fora de curso e otimização de aspectos de Júpiter para o timing de negócios.

Painéis para Astrólogos Profissionais

A comprovação fator a fator permite que astrólogos verifiquem e apresentem resultados pontuados aos clientes. De 1 a 4 horas de trabalho em menos de 2 segundos.

Timing Imobiliário e Jurídico

Otimização de assinatura de contrato, compra de imóvel, locação, mudança, realocação e instalação com predefinições específicas de cada atividade.

Apps de Saúde e Autocuidado

Segurança por área do corpo em odontologia (dentes/mandíbula) e cirurgia, além de timing do dia a dia para corte de cabelo, procedimento estético, medicação e desmame.

Apps de Relacionamento e Eventos de Vida

Casamento, namoro, divórcio, concepção, parto e escolha de nome - cada um com fatores ajustados de Vênus, Lua e áreas da vida.

Apps de Agricultura e Jardinagem

Timing de plantio e colheita usando preferências de Lua crescente/minguante e mansões lunares para fertilidade e produtividade.

Ferramentas de Carreira e Trabalho

Melhor timing para provas, entrevistas, sessões de estudo, contratações e demissões - 34 atividades cobrem todo o expediente.

Technical Specifications

Endpoints	3 (search, evaluate, glossary)
Faixa de Pontuação	0-100 numérica com curvas de saturação
Atividades Predefinidas	34 (cirurgia, casamento, negócios, plantio, corte de cabelo etc.)
Notas	excelente 90-100, bom 75-89, razoável 60-74, cautela 40-59, ruim 0-39
Idiomas	9 (en, ru, de, es, fr, it, pt, zh, hi)
Avaliadores de Fatores	31 avaliações por fator a cada momento
Verificadores de Bloqueio Absoluto	23 verificadores de exclusão dedicados
Intervalo de Busca	Até 367 dias por requisição
Velocidade de Busca	<2s para busca de 90 dias (p95)
Velocidade de Avaliação	<300ms para pontuação de momento único
Granularidade	1m / 5m / 15m / 1h / 4h / 1d configurável
Segurança em Cirurgia e Odontologia	Regra da Lua no signo por área do corpo (15 áreas)
Aviso Pessoal	Retorno de Saturno, trânsitos duros de planetas externos ao natal
Saída	Mapa de calor + janelas ranqueadas + intervalos excluídos + justificativa em linguagem natural
Detalhe por Janela	Posições do mapa + significadores pontuados por janela
Integração MCP	ferramenta find_best_time registrada
Efemérides	Swiss Ephemeris JPL DE431
Cache	Pool Redis por event-loop, TTL de 24h, aceleração de 430x quando aquecido

API Eletiva vs Concorrentes

Feature	Astrology API	Others
Pontuação Eletiva Ocidental	0-100 numérica	Nenhuma (Solar Fire: booleana, Védica: binária)
Mapa de Calor em Calendário	Graduado dia a dia	Não disponível
Detalhamento de Fatores	31 fatores com comprovação	Não disponível
Justificativa em Linguagem Natural	Texto por janela em inglês	Não disponível
Atividades Predefinidas	34 com pesos ajustados	KundliAPI: 9 (só védica, sem pontuações)
Acesso por API	API REST JSON	Apenas desktop ou API só védica
Intervalo de Busca	Até 367 dias	Máximo de 90 dias (ferramentas web)
Segurança em Cirurgia	Regra hipocrática de 15 áreas	Não disponível
Pronta para MCP/LLM	Ferramenta integrada + summary_mode	Não disponível
Preço	A partir de $11/mês	$300-700/mês (software desktop)

APIs de Astrologia Relacionadas

Transit API

Trânsitos planetários em tempo real que alimentam os avaliadores de fatores eletivos

Planetary Hours API

Horas planetárias tradicionais - um dos 31 fatores eletivos

Horary API

Astrologia baseada em perguntas que compartilha o mesmo motor de cálculo

Natal Chart API

Mapas natais para pontuação eletiva personalizada

Documentação da API

Referência completa de endpoints com exemplos de requisição/resposta

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

Precos Simples e Transparentes

Comece gratis, escale conforme cresce. Sem taxas ocultas.

Sempre Gratis

Sem Cartao de Credito

Perfeito para aprender, testar e pequenos projetos pessoais

50 chamadas API/mes

Mapas natais basicos

5 sistemas de casas

Suporte da comunidade

Pro

$11/mes

Para apps pequenos e projetos pessoais

Todos os endpoints basicos
12 sistemas de casas
Suporte por email

Melhor Valor

Pro Plus

$21/mes

Para apps em crescimento e trafego medio

Todos os endpoints aprimorados
18 sistemas de casas
Interpretacoes com IA
Suporte email prioritario

Ultra

$37/mes

Para aplicacoes de astrologia profissionais

Credit math ↓

Todos os endpoints premium
23 sistemas de casas
Interpretacoes IA avancadas
Suporte prioritario

Planos de Alto Volume

Para aplicacoes em escala empresarial

Business

$99/mes

Para aplicacoes de alto volume

Credit math ↓

TODOS os endpoints
Pronto para marca branca
Ajuste fino de IA personalizado
Suporte telefonico

ILIMITADO

Enterprise

$399+por mes

Requisicoes ilimitadas com infraestrutura dedicada

Infraestrutura de servidor dedicado
Sub-300ms garantido
Suporte dedicado 24/7
99,99% uptime SLA

Todos os planos incluem documentacao completa e SDKs

Duvidas? Fale com nossa equipe

Perguntas Frequentes Sobre a API de Astrologia Eletiva

Respostas técnicas para desenvolvedores que criam recursos de timing

Complete Seu Conjunto de Timing Astrológico

A API Eletiva funciona melhor combinada com nossas outras ferramentas de timing e cálculo.

Transit API Planetary Hours Horary API Natal Chart API Lunation API

Comece a Encontrar

Primeira API REST de astrologia eletiva ocidental. Pontuação 0-100, 34 atividades predefinidas, comprovação de fatores, 9 idiomas. Nenhum concorrente tem isso.

Comece Grátis Ver Documentação

50 requisições grátis/mês

Precisão do Swiss Ephemeris

Sem taxas de configuração

O plano gratuito inclui todos os recursos

Encontre o Melhor Momento para Qualquer Coisa. Pontuado de 0 a 100.

Não Existe API Eletiva Ocidental

Primeira API REST Eletiva Criada para Esse Fim

Desempenho da API Eletiva

Recursos Completos de Astrologia Eletiva

Busca por Intervalo de Datas

Avaliação de Momento Único

34 Atividades Predefinidas

Motor de Pontuação

Integração com IA e LLM

Notas e Localização

Janelas Prontas para o Mapa

Pontuação Explicável

O Que É a API de Astrologia Eletiva? Guia Completo para Desenvolvedores

Como funciona a API de Astrologia Eletiva?

O que torna esta API eletiva única?

Quais atividades a API Eletiva suporta?

Como funciona o motor de pontuação por dentro?

O que cada janela pontuada retorna agora?

Como integro a API Eletiva?

Quem usa a API de Astrologia Eletiva?

Use Cases

Apps de Casamento e Eventos

Integração com Agentes de IA (MCP)

Ferramentas de Agendamento de Cirurgias

Plataformas de Lançamento de Negócios

Painéis para Astrólogos Profissionais

Timing Imobiliário e Jurídico

Apps de Saúde e Autocuidado

Apps de Relacionamento e Eventos de Vida

Apps de Agricultura e Jardinagem

Ferramentas de Carreira e Trabalho

Technical Specifications

API Eletiva vs Concorrentes

APIs de Astrologia Relacionadas

Transit API

Planetary Hours API

Horary API

Natal Chart API

Documentação da API

References & Standards

Precos Simples e Transparentes

Sempre Gratis

Pro

Pro Plus

Ultra

Planos de Alto Volume

Business

Enterprise

Perguntas Frequentes Sobre a API de Astrologia Eletiva

O que é astrologia eletiva e como esta API a automatiza?

O que diferencia isso de APIs védicas de muhurta como Prokerala ou KundliAPI?

Quanto custa a API de Astrologia Eletiva?

Quão rápida é a busca eletiva para grandes intervalos de datas?

Quais atividades e eventos a API eletiva suporta?

Como funciona a regra de segurança por área do corpo em cirurgia e odontologia?

O que é o mapa de calor em calendário e como uso?

O que são comprovações de fatores e por que elas importam?

Como integro a API Eletiva no meu app?

Posso usar isso com agentes de IA e LLMs?

O que é o aviso pessoal e como funciona a entrada de mapa natal?

Quais bloqueios absolutos o motor eletivo verifica?

Quão precisos são os cálculos astronômicos?

Posso filtrar os resultados da busca por horário do dia ou dia da semana?

Quais linguagens de programação funcionam com a API Eletiva?

Existe um plano gratuito para a API Eletiva?

Como a predefinição de casamento lida com Vênus retrógrado?

Posso usar a API para o timing de lançamento de negócios?

Como vocês pontuam o timing de casamento, namoro e divórcio?

Posso encontrar o melhor momento para um corte de cabelo ou procedimento estético?

A API suporta o timing de plantio e colheita para a agricultura?

Quais notas a API retorna junto com a pontuação?

Quais idiomas o texto de justificativa suporta?

Posso controlar o quão precisas são as janelas candidatas?

As 34 atividades predefinidas são revisadas por astrólogos reais?

Posso impor minhas próprias regras absolutas, como 'a Lua deve estar crescente'?

Vocês sinalizam planetas combustos na janela escolhida?

Posso renderizar o mapa de um momento recomendado sem uma segunda chamada?

Como sei por que um momento foi bem pontuado?

Complete Seu Conjunto de Timing Astrológico