Lançamento da API AstroWay: pilha completa de cálculos astrológicos com precisão Swiss Ephemeris

Hoje, estamos a anunciar a AstroWay API — um backend computacional para desenvolvedores que criam aplicativos astrológicos, produtos de horóscopo, funções de compatibilidade para namoro e agentes de IA que precisam raciocinar sobre cartas de nascimento.

Neste artigo — o que realmente está dentro da API, quais soluções incomuns adotamos, o que deixamos de fora e como chegamos aqui. Sem rodeios.

🕓 Registro de 2026-04-22, atualizado em 2026-05-09. Alguns números estão desatualizados. Estado atual: 723 endpoints (e não 87 no lançamento), 818 testes de snapshot CI (e não 183), servidor MCP @astroway/mcp + SDK TypeScript @astroway/sdk + SDK Python astroway + SDK PHP astroway/sdk agora todos vivem em registros públicos. Status atual — em /faq e changelog.

API REST baseada em Swiss Ephemeris (LGPL), compilada em WASM e implantada como um serviço Node.js — agora com interpretações de IA (cadeia de failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) sobre cálculos reais. O mesmo motor que astrólogos profissionais usam há 30+ anos em Solar Fire, Kepler, Astro Gold e Janus — precisão de até uma fração de segundo de arco, verificada com a efeméride da NASA JPL e o swetest de referência oficial do Astrodienst (Astro.com).

Números:

• 723 endpoint — astrologia natal ocidental, sinastria, trânsitos, progressões, direções, retornos, harmônicas, estrelas fixas, pontos árabes, astrocartografia mais um conjunto completo de Human Design
• 183 testes de snapshot em CI contra a saída real do swetest CGI e o catálogo de eclipses da NASA — executados em cada PR
• p50 < 100 ms, p95 < 500 ms para endpoints de cálculo típicos
• Servidor MCP @astroway/mcp + três SDKs em registros públicos: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — a mesma API em três linguagens
• Servidor MCP: @astroway/mcp — fornece a API como ferramentas para Claude, GPT, Cursor e outros agentes LLM
• Preços baseados em créditos: plano gratuito (10.000 créditos/mês, sem cartão), planos pagos — a partir de $5/mês

Documentação completa: api.astroway.info/docs/api/. Status ao vivo: api.astroway.info/status.

Três anos atrás, começamos a construir aplicativos astrológicos de consumo. A camada de cálculo provou ser a parte mais difícil — muito mais difícil do que a interface do usuário ou o conteúdo. Os serviços existentes ou:

1. Tinham cobertura superficial (10-30 endpoints, principalmente apenas natal)
2. Eram caros em escala ($0,02-$0,10 por solicitação sem descontos em volume)
3. Usavam motores fechados, cuja precisão não pode ser verificada
4. Estavam orientados para a astrologia védica, com a astrologia ocidental como secundária

Então, nós mesmos implementamos o Swiss Ephemeris e escrevemos nossa própria camada de cálculo — primeiro para o produto de consumo app.astroway.info, então para o site de marketing astroway.info, que fornece horóscopos diários para centenas de milhares de visitantes por mês.

Ao longo de três anos de funcionamento desse código em produção, chegamos a duas conclusões:

1. O mesmo motor de cálculo deve estar disponível para outros desenvolvedores — não porque eles não possam escrevê-lo sozinhos, mas porque a pilha biblioteca + WASM + cache + CI de precisão — é meio ano de trabalho, que ninguém deve repetir.
2. Nossa cobertura de Human Design (12 endpoints — carta, tipo, autoridade, perfil, portas, canais, contornos, ativações planetárias, cruz de encarnação, definição) — é realmente única. Nenhum concorrente oferece o conjunto completo de HD por meio de uma API.

Aqui está o lançamento.

Temos /nakshatras, /ashtakavarga e endpoints para cartas divisionais, mas não há Dasha, Panchang, Ashtakoota, KP. A razão: na astrologia védica, há desacordos não resolvidos entre escolas (guerras de ayanamsha, disputas sobre cuspidores KP, escolha da escola de dasha). Uma parte védica feita às pressas contra Prokerala e VedicAstroAPI simplesmente receberia críticas.

A solução é fixa: o pacote védico é uma fase 3, após a confirmação inicial da demanda (veja acima)

Uma chamada /chart custa ~50 vezes menos cálculos do que um /forecast-calendar de 365 dias. Um preço plano por solicitação ou cortaria os usuários leves, ou subsidiaria os pesados. Os créditos mapeiam o custo para o trabalho real — veja a tabela por endpoint na página de preços.

As respostas no plano gratuito contêm um campo _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — obtenha sua própria chave em api.astroway.info"
}

Isso não nos custa nada, e dá aos usuários gratuitos um pequeno incentivo para atualizar. No plano Hobby+, é removido nas configurações da chave. O padrão foi emprestado do Zapier e do RevenueCat.

/rectification (seleção de tempo de nascimento com base em eventos de vida por meio de uma grade de busca de probabilidade) — é caro em termos computacionais: uma chamada leva 10-60 segundos e faz dezenas de milhares de cálculos intermediários do Swiss Ephemeris. Limitamos isso ao plano Pro ($59/mês) e definimos um alto preço de crédito, porque o abuso sobrecarregaria a infraestrutura compartilhada para todos os outros.

Os endpoints /interpret/* são roteados por meio de nosso gateway de IA privado, que está por cima dos melhores modelos de mercado (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) com failover automático. Não te trancamos em nossos prompts — cada resposta com interpretação contém os cálculos originais, então você pode solicitar novamente com sua própria LLM, se a nossa voz não for do seu agrado. Registramos os prompts e saídas completos em uma tabela de auditoria para conformidade B2B (armazenamento de 90 dias).

• Pacote védico — fase 3, após a confirmação inicial da demanda (veja acima)
• Webhooks de limiar — implementados, mas a interface do usuário é bruta; estamos aprimorando
• Widgets públicos (<script src="api.astroway.info/widget/natal.js">) — fase 7
• Plug-in para o site de marketing principal — projeto separado, planejado no âmbito da ecossistema astroway.info

1. Leia a documentação se quiser entender o “porquê”: api.astroway.info/overview
2. Início rápido em 5 minutos com código: Início rápido da API de Astrologia
3. Preços, incluindo a tabela de créditos por endpoint: api.astroway.info/pricing
4. Registre-se — gratuitamente, sem cartão: api.astroway.info/dashboard/sign-up

Se você construir algo com base na API — ou encontrar um bug, ou quiser um endpoint que ainda não temos — nos avise. Preferimos ouvir cem desenvolvedores pedindo algo a lançar recursos que ninguém usa.

Perguntas, solicitações, casos de bordo estranhos: hello@astroway.info.

Roadmap público — PRODUCT-PLAN.md — o que foi feito, o que vem a seguir, o que foi adiado e por quê.

Bem-vindo.