// astrology api
Astrology API by technique
AstroWay endpoints grouped by astrological technique: each page ships a runnable request, a parameters table, and the real credit cost.
POST /v1/chart
API de mapa natal
Transforme um único momento de nascimento num mapa natal completo e estruturado - planetas, cúspides das casas, aspetos e dados angulares - num só POST. Zodíaco tropical, treze sistemas de casas, precisão do Swiss Ephemeris, saída em JSON.
POST /v1/synastry
API de sinastria
Compare dois mapas natais numa só chamada e obtenha a grelha de aspetos cruzados que move toda a funcionalidade de compatibilidade - quem aspeta quem, com que ângulo, com que orbe, em que direção. Dois mapas à entrada, a relação entre eles à saída.
POST /v1/transits
API de trânsitos
Capture o céu numa data-alvo qualquer e sobreponha-o à estrutura de casas natais de uma pessoa num só POST. Planetas em trânsito, as cúspides natais em que caem, a grelha de aspetos entre os corpos em trânsito, mais paralelos e antiscia - precisão do Swiss Ephemeris, saída em JSON.
POST /v1/composite
API de mapa composto
Funda dois mapas natais num só. O composto por ponto médio toma cada par planetário e os dois conjuntos de ângulos, encontra o ponto médio de cada um e devolve um único mapa derivado que modela a relação como entidade própria. Dois mapas à entrada, um composto à saída, em JSON.
POST /v1/progressions
API de progressões secundárias
Avance o mapa natal de forma simbólica: um dia de efeméride de movimento planetário equivale a um ano de vida. Forneça um mapa natal e uma data-alvo e receba o mapa progredido - planetas, casas, aspetos - para essa idade. Precisão do Swiss Ephemeris, saída em JSON.
POST /v1/symbolic-directions
API de Direções de Arco Solar
O arco solar move todo o mapa avançando um número: a distância que o Sol percorreu na progressão secundária. Cada planeta, cada cúspide e ambos os ângulos deslocam-se pelo mesmo arco, assim um aspecto natal que estava a dois graus da exatidão chega a exato cerca de dois anos depois. Este endpoint devolve o mapa dirigido e o arco que o produziu.
POST /v1/profections
API de Profecções Anuais
As profecções anuais são a técnica de cronometragem mais simples do conjunto helenístico e uma das mais usadas: o mapa avança uma casa por cada ano de vida, e o regente do signo nessa casa torna-se o senhor do ano. Um número entra, um planeta sai, e todo o ano tem uma assinatura.
POST /v1/harmonics
API de Cartas Harmónicas
Uma carta harmónica multiplica cada longitude planetária por um número inteiro e volta a envolver o resultado no círculo. A aritmética é trivial e o efeito não: aspetos difíceis de ver na carta natal tornam-se conjunções no harmónico, por isso o padrão que tentavas vislumbrar aparece como uma pilha.
POST /v1/almuten
Almuten Figuris API
O almuten figuris é a resposta tradicional a uma pergunta que o mapa moderno evita: qual planeta único tem a reivindicação mais forte sobre esta natividade. É decidido contando a dignidade nos lugares chave do mapa e escolhendo o vencedor, e o endpoint retorna tanto o vencedor quanto a contagem total.
POST /v1/hd/hologenetic
API de Perfil Hologenético Gene Keys
O perfil hologenético organiza onze esferas em três sequências, cada esfera com uma porta e uma linha derivadas de uma posição planetária no nascimento ou no momento do desenho. Este endpoint devolve o perfil completo numa única chamada: Ativação, Vénus e Pérola, com a porta e a linha de cada esfera.
POST /v1/solar-return
API de revolução solar
Levante o mapa para o instante exato em que o Sol regressa ao seu grau natal num ano escolhido - o aniversário astrológico. Passe um mapa natal e um ano e obtenha o mapa da revolução solar desse ciclo. Tropical, Sol-ao-Sol-natal, precisão do Swiss Ephemeris, saída em JSON.
POST /v1/lunar-return
API de revolução lunar
Encontre o próximo momento em que a Lua regressa à sua longitude natal na data escolhida ou depois dela - aproximadamente a cada 27,3 dias - e levante o mapa para ele numa localização à sua escolha. Passe dados natais e uma data de início e obtenha o mapa da revolução lunar. Precisão do Swiss Ephemeris, saída em JSON.
POST /v1/draconic
API de mapa dracônico
Reancore todo o zodíaco no Nodo Norte da Lua. Desloque 0° de Carneiro para o Nodo Norte natal e cada planeta passa a ser lido em longitude nodal - "dracônica". Passe um mapa natal e obtenha planetas, casas e aspetos expressos na estrutura dracônica. Precisão do Swiss Ephemeris, saída em JSON.
POST /v1/heliocentric
API de mapa heliocêntrico
Mova o observador para o Sol. Em vez do habitual céu centrado na Terra, isto devolve o sistema solar tal como visto do Sol - a Terra torna-se um corpo, a Lua e o Ascendente desaparecem, e cada planeta é dado em longitude heliocêntrica. Passe um momento e obtenha o mapa heliocêntrico. Precisão do Swiss Ephemeris, saída em JSON.
POST /v1/relocation
API de relocalização
Mantenha os planetas, mude o mapa. Um mapa de relocalização conserva cada longitude planetária natal exatamente como nasceu, mas reconstrói a estrutura de casas - Ascendente, Meio-Céu, cúspides - para um novo lugar. Passe dados natais e uma localização-alvo e obtenha ambos os mapas mais o delta angular. Precisão do Swiss Ephemeris, saída em JSON.
POST /v1/astrocartography
API de astrocartografia
A astrocartografia toma um único momento de nascimento e projeta-o sobre todo o planeta: em vez de perguntar onde estavam os planetas no céu, pergunta onde na Terra cada planeta estava angular. O endpoint devolve a geometria de linhas que se traça num mapa-múndi para ver que longitudes ativam que energia planetária.
POST /v1/parans
Parans API
Um paran é o ponto onde duas linhas de astrocartografia se cruzam: um local onde dois planetas estavam simultaneamente angulares. Este endpoint devolve todos os cruzamentos para um momento de nascimento, com as coordenadas de cada um, para que possas marcar no mapa os pontos onde dois temas planetários se fundem em vez de simplesmente correr lado a lado.
POST /v1/parans/star
API de parans estrela-planeta
Uma estrela e um planeta estão em paran quando ambos estão angulares no mesmo momento, e se isso pode acontecer depende apenas da latitude. Por isso, um paran é uma latitude, que é como Bernadette Brady o tabula, e este endpoint devolve latitudes em vez de pontos. Estão disponíveis 953 estrelas, 36 no conjunto predefinido.
POST /v1/acg/best-places
API de melhores lugares
Classifica cidades reais em relação às linhas de astrocartografia de um mapa, para uma de dezanove áreas da vida. 34 028 lugares do GeoNames, pontuados pela proximidade a cada linha que compõe essa área, com o lado favorável e o lado desafiante reportados em separado.
POST /v1/reports/gemstone
PDF do relatório de pedras preciosas (ratna)
A prescrição de gemas Jyotish como um documento que o cliente guarda. Cada pedra recomendada tem uma página: o que o seu graha significa classicamente, a base na regência das casas, o mineral e os substitutos, o peso em ratti com conversões para gramas e quilates, o dia da semana, o dedo, o metal, o mantra e o próximo dia auspicioso para a usar pela primeira vez.
POST /v1/reports/relocation
PDF do relatório de relocação
Até cinco locais comparados para um mapa natal, como um PDF de várias páginas que podes guardar. Por local: os ângulos relocados com o seu deslocamento desde o nascimento, os planetas que mudaram de casa, todas as linhas de astrocartografia dentro de 300 km com a sua interpretação, e pontuações de apoio e desafio nos dezenove domínios da vida.
POST /v1/local-space
API de astrologia Local Space
O Local Space faz uma pergunta diferente da astrocartografia: não onde na Terra um planeta estava angular, mas em que direção da bússola ele estava a partir do local de nascimento. O endpoint devolve um azimuth e uma altitude para cada corpo, mais o caminho great-circle que essa direção traça ao redor do globo.
POST /v1/geodetic
API de carta equivalente geodésica
Uma carta geodésica deriva os quatro ângulos apenas da geografia. O zero grau de Carneiro está fixado ao meridiano de Greenwich, cada grau de longitude torna-se um grau do zodíaco, e qualquer lugar na Terra adquire um Meio-do-Céu e um Ascendente sem que seja necessária qualquer hora de nascimento.
POST /v1/solar-acg
API de astrocartografia de revolução solar
A astrocartografia natal responde onde um mapa funciona. A astrocartografia de revolução solar responde onde funciona este ano. O endpoint calcula o momento exato em que o Sol regressa à sua longitude natal no ano que indicares, e depois mapeia esse mapa por todo o globo como o seu próprio conjunto de linhas angulares.
POST /v1/acg/by-category
API de interpretação de astrocartografia
A geometria das linhas por si só não diz a ti onde te mudar. Este endpoint recebe uma área da vida, escolhe as linhas de astrocartografia que realmente a regem, classifica-as pela força e proximidade da aplicação e devolve o texto de interpretação de cada uma. Uma única chamada substitui o mapeamento planeta-tema que cada produto de relocação teria de inventar internamente.
POST /v1/essential-dignities
API de dignidades essenciais
As dignidades essenciais medem o quão confortavelmente cada planeta se encontra no signo e grau que ocupa. Este endpoint passa cada corpo pelo esquema tradicional quíntuplo - regência, exaltação, triplicidade, termo e face - juntamente com as duas debilidades, e devolve tanto uma análise por planeta como um único total ponderado.
POST /v1/fixed-stars
API de estrelas fixas
Para além dos planetas em movimento, a camada mais antiga da astrologia lê as estrelas fixas - Régulo, Spica, Algol, Aldebarã e os seus pares. Este endpoint varre um mapa natal em busca de conjunções apertadas a essas estrelas maiores e devolve cada contacto com o seu orbe, para que possa incorporar o reputado carácter de uma estrela numa leitura.
POST /v1/arabic-parts
API de partes árabes
As Partes Árabes, ou Lotes Helenísticos, são pontos calculados derivados por aritmética sobre o mapa em vez de lidos diretamente do céu. Este endpoint calcula a Parte da Fortuna, do Espírito, de Eros e as restantes a partir de fórmulas sobre o Ascendente e dois planetas, tratando da inversão entre nascimento diurno e noturno que a prática real dos Lotes exige.
POST /v1/midpoint-trees
API de árvores de pontos médios
A cosmobiologia lê um mapa através dos pontos médios: o grau exatamente a meio caminho entre dois planetas, e qualquer terceiro planeta que aí caia. Este endpoint calcula a estrutura de pontos médios de um mapa, monta a árvore de pontos médios de cada planeta e assinala as simetrias que a tradição do disco de 90° trata como os pontos mais ativos do mapa.
POST /v1/parallel-aspects
API de aspetos de declinação
A maior parte do trabalho com aspetos acontece ao longo da eclíptica, em longitude, mas dois corpos podem também relacionar-se por declinação - a sua distância a norte ou a sul do equador celeste. Este endpoint trabalha nessa segunda dimensão, encontrando paralelos e contraparalelos, os análogos em declinação da conjunção e da oposição, e assinalando quando um corpo fica fora dos limites.
POST /v1/vedic/dashas/vimshottari/maha
API de Vimshottari Mahadasha
Vimshottari é o ciclo de períodos planetários de 120 anos que ancora a temporização védica. Este endpoint lê a posição da Lua sideral ao nascimento, localiza o nakshatra que ela ocupa e, a partir desse único ponto, desenrola a cadeia ordenada de Mahadashas - os grandes períodos da vida, cada um governado por um dos nove grahas - com as datas de calendário exatas que os delimitam.
POST /v1/vedic-divisional
API de mapas divisionais
Os mapas Varga são as lentes de aumento do Jyotish: cada um subdivide cada signo numa harmónica escolhida e remapeia os planetas numa grelha mais fina que fala de um domínio da vida. Este endpoint recebe um momento de nascimento e uma divisão pedida - D1 a D60 - e devolve onde cai cada planeta nesse varga.
POST /v1/vedic/varshaphal
Gráfico anual Tajika (Varshaphal)
O gráfico védico para um ano de vida, calculado no momento em que o Sol sideral retorna ao seu longitude de nascimento. Retorna a entrada do ano ao segundo, o gráfico anual, o muntha com sua casa e senhor, força quádrupla para todos os sete grahas, os cinco candidatos de onde o senhor do ano é escolhido, e o próprio senhor do ano sob ambas as leituras que as fontes suportam.
POST /v1/vedic/shadbala/full
API de Shadbala
Shadbala - literalmente "força sêxtupla" - é a forma clássica de quantificar quanto um planeta consegue realmente cumprir as suas promessas num mapa. Este endpoint calcula a força total de cada graha como a soma das suas seis balas constituintes, devolvendo uma pontuação por planeta em rupas para que possa classificar os planetas pela força com que estão posicionados para agir.
POST /v1/numerology/pythagorean/life-path
API de numerologia
Este endpoint calcula o número do Caminho de Vida pitagórico - o dígito único que condensa uma data de nascimento na sua assinatura numerológica essencial. É um cálculo dentro de um conjunto mais amplo que abrange quatro sistemas e cerca de dez cálculos cada, e corre como aritmética pura, sem efeméride e sem astrologia envolvida.
POST /v1/tarot/rider-waite/draw/three-card
API de tarô
Este endpoint realiza uma tiragem com semente e reprodutível a partir do baralho Rider-Waite-Smith de 78 cartas para a tiragem de três cartas. Devolve os metadados da tiragem, a semente inteira que governou o embaralhamento e as cartas tiradas com as suas posições, orientações e significados - para que qualquer leitura possa ser repetida exatamente passando de volta a semente.
POST /v1/bazi/chart
API BaZi (Quatro Pilares)
Um momento de nascimento em todo o aparelho clássico: quatro pilares, os troncos que cada ramo abriga, o na yin, as doze fases da vida, o equilíbrio dos elementos em todos os oito caracteres, um veredito de força da estrutura nomeada, as estrelas simbólicas, e as interações entre ramos e troncos. Uma chamada, JSON de saída, 21 idiomas.
POST /v1/human-design
API de Human Design
Este endpoint calcula o bodygraph do Human Design a partir de um único evento de nascimento. Combina o mapa de Personalidade natal com o mapa de Design - tomado cerca de 88° de arco solar antes do nascimento, cerca de três meses antes - e deriva os elementos mecânicos do bodygraph: Tipo, Estratégia, Autoridade, Perfil, Centros, Canais, Portões e a Cruz de Encarnação.
POST /v1/horoscope/daily
API de horóscopo com AI
Este endpoint gera um horóscopo diário escrito para um signo do zodíaco numa dada data, chamando o nosso gateway de LLM. Devolve o texto do horóscopo, um aviso legal, o modelo que o produziu e o idioma da saída. Ao contrário dos endpoints de cálculo, é orientação gerada em vez de um resultado determinístico.
POST /v1/chinese/zodiac/compatibility
API de compatibilidade do zodíaco chinês
Duas datas de nascimento entram, uma correspondência pontuada sai, construída sobre a geometria dos doze ramos em vez de uma tabela de opiniões. O animal do ano é resolvido no instante exato de Li Chun, então um nascimento em fevereiro cai no animal a que realmente pertence.
POST /v1/chinese/feng-shui/flying-star
API de feng shui das estrelas voadoras (Xuan Kong)
Uma direção de frente e um período de construção produzem o gráfico completo das nove palavras das estrelas voadoras: a estrela do período, a estrela da montanha e a estrela da frente em cada um dos nove setores, com o elemento, a natureza e o significado de cada uma.
POST /v1/chinese/tong-shu/select
API de seleção de datas Tong Shu
Analisa uma janela de dias e devolve apenas os que o almanaque aprova para uma tarefa específica, com a razão de cada sobrevivente ter sobrevivido e a contagem do que foi descartado e porquê.
POST /v1/chinese/true-solar-time
API de Tempo Solar Verdadeiro
O relógio na parede e o sol sobre o local de nascimento são dois tempos diferentes, e numa zona horária extensa eles se afastam por horas. Este endpoint devolve o segundo, decomposto para que possas ver de onde vem cada minuto.
POST /v1/ziwei/chart
Zi Wei Dou Shu (Estrela Púrpura) API
Uma data de nascimento, uma hora e um sexo geram o gráfico completo: doze palácios com os seus troncos, todas as catorze estrelas principais, as auxiliares, trinta e uma estrelas menores, as doze fases da vida, os limites de década e as quatro transformações marcadas nas estrelas que as carregam.