Visão geral
AstroWay API — uma API REST profissional para cálculos astrológicos como serviço.
723 endpoints baseados no Swiss Ephemeris (WASM), com cobertura de técnicas que não existem em nenhuma concorrente: harmónicas, cartas draconianas, CCG, setores de Gauquelin, Human Design completo, retificação.
Para quem é isto
Seção intitulada “Para quem é isto”- Desenvolvedores de aplicações astrológicas (web, mobile) que precisam de cálculos precisos e variados sem infraestrutura própria.
- Empresas de IA que integram funcionalidades astrológicas — existe um servidor MCP nativo para Claude, ChatGPT e outros agentes.
- Astrólogos profissionais que constroem as suas próprias ferramentas ou scripts para clientes.
- Investigadores que necessitam de acesso programático a cálculos para estudos estatísticos.
- Plataformas de conteúdo que adicionam funcionalidades astrológicas sobre produtos existentes.
Para quem não é
Seção intitulada “Para quem não é”- Widgets horoscópicos de “signo de hoje” sem controlo — as interpretações e horóscopos (
/interpret/*,/horoscope/*) existem, mas são projetados como API para desenvolvedores, não como widgets prontos. - Astrologia védica como especialização principal — para projetos Vedic-first (sistemas Dasha, Panchang, KP), Prokerala e VedicAstroAPI são mais fortes. Para astrologia ocidental + Human Design + técnicas raras (retificação, harmónicas, CCG), o AstroWay supera-as. Consulta /compare/.
- Tarot/numerologia — apenas astrologia e Human Design. I-Ching está disponível como endpoint bónus.
O que torna o AstroWay único
Seção intitulada “O que torna o AstroWay único”1. Técnicas raras em formato de API
Seção intitulada “1. Técnicas raras em formato de API”| Técnica | Para que serve |
|---|---|
| Cartas harmónicas (H2–H180) | Astrologia de investigação (método de John Addey) |
| Carta draconiana | Astrologia cármica/da alma |
| CCG (Cyclo-Carto-Graphy) | Astrocartografia progressiva — técnica premium de Jim Lewis |
| Setores de Gauquelin | Astrologia estatística, uso académico |
| Progressões terciárias | Terceiro tipo de progressões — nicho, mas valorizado |
| Antíscias / contra-antíscias | Técnica clássica helenística — renascimento de escolas tradicionais |
| Aspetos paralelos | Aspetos por declinação — práticas avançadas |
| Retificação via API | Correção do tempo de nascimento — valor altíssimo |
| Ciclos planetários (conjunções) | Astrologia mundana — eventos mundiais |
| Índice cíclico de Barbault | Astrologia mundana |
| Mínimo de Algol | Tempos de estrelas fixas — astrologia eletiva |
| Linhas de espaço local | Astrologia direcional semelhante ao Feng Shui |
| Cadeias de disposição | Grafos de controlo — técnica clássica |
| Almutem figuris | Técnica medieval — renascimento tradicional |
2. Precisão do Swiss Ephemeris — o mesmo motor usado no Solar Fire ($495), Kepler ($995), Astro Gold
Seção intitulada “2. Precisão do Swiss Ephemeris — o mesmo motor usado no Solar Fire ($495), Kepler ($995), Astro Gold”O mesmo Swiss Ephemeris (LGPL) usado por astrólogos profissionais no Solar Fire, Kepler, Astro Gold e Janus há mais de 30 anos — só que em compilação WASM e como REST API, sem margem de revenda intermédia. Precisão:
- Posições planetárias: ±1 segundo de arco vs. efemérides NASA JPL
- Cúspides de casas: ±1 minuto de arco
- Validação contra Zet 9, Solar Fire (efemérides proprietárias), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — discrepâncias dentro dos limites do método (≤0.1″).
3. 723 endpoints — cobertura profunda das técnicas ocidentais
Seção intitulada “3. endpoints — cobertura profunda das técnicas ocidentais”176 endpoints de cálculo de astrologia ocidental (4 escolas: helenística, psicológica moderna, evolutiva, cosmobiologia) + interpretações por IA + Human Design completo. Profundidade em vez de dispersão por dezenas de direções.
Arquitetura
Seção intitulada “Arquitetura”A tua aplicação ↓ HTTPS + X-Api-Keyapi.astroway.info/v1/* ↓Node.js + Express + Swiss Ephemeris (WASM) ↓Cálculo e retorno em JSON- Os cálculos são executados no servidor — nenhum blob WASM no frontend da tua aplicação, nenhum problema de licenciamento do Swiss Ephemeris.
- O estado é mantido no servidor — cada pedido é autossuficiente. Nenhum vazamento de dados dos clientes.
- As chaves API estão vinculadas ao plano, com limite de rate e saldo diário de créditos. Monitorização através do dashboard.
Próximos passos
Seção intitulada “Próximos passos”- Primeiros passos — faz o teu primeiro pedido em 5 minutos
- Autenticação — como obter e guardar a chave
- Créditos e limites — como funciona a faturação
- Documentação da API — todos os endpoints com playground interativo
Útil?
Obrigado pelo feedback.