Obtenha posições planetárias atuais com precisão de Efemérides Suíças (dados NASA JPL).
Sol, Lua, Mercúrio, Vênus, Marte, Júpiter, Saturno, Rahu, Ketu - tudo em uma chamada API. 13 idiomas suportados.
Confiabilidade de nível empresarial para dados planetários
Tudo para integrar rastreamento planetário em tempo real
A API de Posições Planetárias funciona como um app de clima para planetas. Acesso instantâneo a onde estão os 9 planetas AGORA (Sol, Lua, Mercúrio, etc.). Resposta em 2-7ms com precisão NASA.
Posições planetárias são as localizações exatas dos planetas no zodíaco em qualquer momento.
Medidas em graus, minutos e segundos ao longo da eclíptica (o caminho que os planetas seguem).
Exemplo: "Sun at 15° Aries 23' 12"" significa que o Sol está a 15 graus, 23 minutos de arco e 12 segundos de arco no signo de Aries.
Por que isso importa? Na astrologia, ONDE um planeta está determina O QUE ele influencia.
Sol em Aries = energia confiante e pioneira.
Sol em Pisces = energia compassiva e sonhadora.
Para mapas natais, são necessárias as posições no momento do nascimento.
Para horóscopos diários, são necessárias as posições de HOJE.
Para previsões de trânsitos, compara-se as posições atuais com as natais.
Os planetas mudam de posição constantemente – a Lua é a mais rápida (13°/dia), Saturno a mais lenta (0,03°/dia).
Aplicativos que usam dados desatualizados fornecem previsões incorretas.
É como usar a previsão do tempo de ontem para hoje – inútil.
Nossa API rastreia os 9 planetas 24/7 usando Swiss Ephemeris (dados NASA JPL) – o mesmo motor de cálculo usado pela NASA.
Tempo de resposta <300ms garante que os usuários recebam dados precisos instantaneamente, sem atrasos de "carregando...".
Essencial para qualquer aplicativo sério de astrologia.
O rastreamento preciso dos planetas requer três elementos: (1) Dados astronômicos de efemérides – utilizamos Swiss Ephemeris baseado nas teorias planetárias da NASA JPL, (2) Cálculos temporais precisos – os planetas se movem a cada segundo, não apenas por dia, (3) Conversão do sistema de coordenadas – zodíaco tropical versus sideral com 12 sistemas de ayanamsa.
Veja como funciona: Swiss Ephemeris contém fórmulas matemáticas (não tabelas) para calcular posições planetárias para QUALQUER data/hora entre 3000 a.C.
e 3000 d.C.
Ao solicitar "posições dos planetas em 5 de janeiro de 2025 às 15:42 UTC", nossa API calcula a longitude eclíptica exata (posição em graus ao longo do cinturão zodiacal), declinação (norte/sul do equador celeste) e distância da Terra.
Em seguida, converte para o sistema zodiacal desejado – tropical (baseado nas estações, usado na astrologia ocidental) ou sideral (baseado nas estrelas, usado na astrologia védica).
Suportamos 12 sistemas de ayanamsa, incluindo Lahiri, Raman, Krishnamurti.
A diferença atual é cerca de 24 graus devido à precessão dos equinócios.
O cálculo manual exige livros de efemérides, interpolação entre datas e conversões de coordenadas – levando de 5 a 10 minutos por planeta.
Nossa API realiza o cálculo dos 9 planetas em <300ms com precisão de 0,001°.
Softwares profissionais como Solar Fire utilizam o mesmo motor Swiss Ephemeris – nós apenas o tornamos acessível via API em 13 idiomas (8 indianos + 5 europeus).
O zodíaco tropical (astrologia ocidental) fixa 0° de Áries no equinócio da primavera – quando o dia e a noite têm a mesma duração.
Portanto, Áries tropical SEMPRE começa por volta de 20-21 de março.
O zodíaco sideral (astrologia védica) fixa 0° de Áries nas constelações estelares reais.
Mas a Terra oscila em seu eixo (precessão), fazendo o ponto do equinócio retroceder pelas constelações a cerca de 1° a cada 72 anos.
Atualmente, os zodíacos tropical e sideral estão cerca de 24° afastados.
Essa diferença é chamada de "ayanamsa".
Suportamos 12 sistemas de ayanamsa – Lahiri, Raman, Krishnamurti (KP) e outros.
Exemplo prático: se o Sol tropical está a 10° de Áries, o Sol sideral (usando ayanamsa Lahiri) estará por volta de 16° de Peixes.
O signo solar ocidental pode ser Áries, mas o signo solar védico pode ser Peixes.
Nossa API calcula AMBOS os sistemas.
Especifique ayanamsa: null para tropical ou ayanamsa: "lahiri" para sideral.
É possível obter ambos em uma única resposta – ideal para apps que atendem usuários globais (ocidental popular nos EUA/Europa, védico popular na Índia).
Não há necessidade de integrar duas APIs separadas.
Uma chamada, ambos os sistemas, resposta em <300ms.
Concorrentes forçam a escolha entre ocidental OU védico – oferecemos ambos com 12 opções de ayanamsa.
Os planetas movem-se em velocidades muito diferentes.
Lua: 13° por dia (muda de signo a cada 2,5 dias).
Sol: 1° por dia (muda de signo mensalmente).
Mercúrio: 1-2° por dia quando direto, aparenta retroceder durante o movimento retrógrado.
Vênus: média de 1° por dia.
Marte: média de 0,5° por dia.
Júpiter: 0,08° por dia (5 minutos de arco).
Saturno: 0,03° por dia (2 minutos de arco).
Rahu/Ketu (nodos lunares): movem-se para trás a 0,05° por dia.
Para horóscopos diários, atualizar uma vez por dia à meia-noite (posição da Lua é a mais importante).
Para alertas de trânsito em tempo real ("Lua entrando na sua 7ª casa AGORA"), atualizar a cada poucas horas.
Para cálculos de mapa natal, consulta única no momento do nascimento.
Para painéis de astroclima mostrando "planetas agora", atualizar a cada 15-60 minutos.
Nossa API é projetada para requisições de alta frequência – com cache de 5 minutos (posições planetárias não mudam significativamente em 5 min), permitindo chamadas a cada minuto sem impacto na performance.
Diferente de efemérides que publicam posições diárias à meia-noite, nossa API calcula para QUALQUER horário – se precisar das posições às 15:42 em uma data específica, obtém-se as posições exatas para esse momento, não uma aproximação da meia-noite.
Essencial para trabalhos que exigem precisão temporal.
Trânsito = onde os planetas estão AGORA em comparação com onde estavam no seu nascimento.
Exemplo: você nasceu com o Sol a 10° de Áries.
Hoje, Júpiter em trânsito está a 10° de Áries – isso é um Retorno de Júpiter (acontece a cada 12 anos).
Período de grande expansão na vida.
Ou Saturno em trânsito está em oposição à sua Lua natal – período emocional desafiador.
Aplicativos usam trânsitos para: (1) Previsões diárias – "Marte trânsitoando sua 10ª casa: impulso na carreira esta semana", (2) Sistemas de alerta – "Vênus entrando na sua 7ª casa amanhã: ótimo para romance", (3) Rastreamento de trânsitos importantes – Retorno de Saturno, Retorno de Júpiter, Oposição de Urano aos 42 anos.
Para implementar: obtenha o mapa natal do usuário (posições natais) uma vez e armazene-o.
Depois, chame nossa API diariamente/horarymente para posições atuais.
Compare as posições atuais com as natais: conjunção (0°), oposição (180°), trígono (120°), quadratura (90°), sextil (60°).
Gere previsões baseadas nos aspectos.
O plano profissional ($37/mês) inclui endpoint de cálculo de trânsitos que faz a comparação automaticamente – basta enviar os dados natais + data atual e receber todos os trânsitos ativos com interpretações.
Muito mais fácil do que programar a detecção de aspectos manualmente.
A resposta inclui orbe (quão exato é o aspecto), aplicando/separando (se o aspecto está se fortalecendo ou enfraquecendo), data de pico (quando o aspecto está exato).
Essencial para previsões baseadas em temporização.
A integração é simples: 3 passos.
(1) Obtenha a chave da API – o plano gratuito inclui 50 {{requests}}/mês, sem necessidade de.
(2) Faça uma requisição POST com data/hora e localização (localização necessária para posições das casas, opcional para posições básicas dos planetas).
(3) Analise a resposta JSON com os dados dos planetas.
Código de exemplo: const response = await fetch(API_URL, {method: "POST", headers: {Authorization: "Bearer API_KEY"}, body: JSON.stringify({year: 2025, month: 1, day: 5, hour: 15, minute: 42, latitude: 40.7, longitude: -74.0})}); const planets = await response.json(); console.log(planets.sun.longitude); – pronto! A resposta inclui para cada planeta: longitude (posição em graus), signo (Aries/Taurus/etc), grau dentro do signo, status de retrogradação, velocidade (movimento diário), declinação, distância da Terra.
Casos de uso: (1) widget "Planets Today" – exibe todas as posições atuais, (2) rastreador de retrogradação – filtra planetas com is_retrograde: true, (3) alertas de mudança de signo – compara o signo de ontem com o de hoje, (4) gerador de mapa natal – armazena posições no momento do nascimento.
Fornecemos SDKs para JavaScript, Python, PHP com funções auxiliares.
Integração leva 2-3 horas, contra 3-6 meses para desenvolver cálculos astronômicos internamente.
Foque nos recursos exclusivos do seu app, deixe a matemática complexa conosco.
Veja como nos comparamos
Tudo sobre a API de Posições Planetárias
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