Metodologia

As posições dos planetas são calculadas a partir das efemérides da NASA JPL, com o conjunto completo de 105 MB (e não uma versão reduzida), 735 estrelas fixas e cobertura de 500 a 2999 d.C. Nada é interpolado de uma tabela de almanaque pronta, e não há resultado em cache: cada resposta é calculada para o instante e as coordenadas exatos da requisição.

Esse período faz diferença em dois casos reais: mapas históricos e varreduras longas de dasha e de trânsitos, que avançam décadas além de hoje. Uma biblioteca restrita à era moderna perde precisão nas pontas sem avisar.

O mesmo motor de cálculo roda o Yoga Panchang, nosso site gratuito de panchang e Jyotish, então os números que os leitores dele veem todo dia vêm do código descrito aqui.

A maior fonte de diferença entre dois cálculos védicos não é a aritmética, e sim o ayanamsa. As tradições indianas realmente discordam sobre ele, e um grau de diferença faz um planeta cruzar o limite de um nakshatra.

Por isso oferecemos 48 ayanamsas: a família Surya Siddhanta, Citra verdadeiro, Revati verdadeiro, Pushya verdadeiro, Raman, KP, Yukteshwar e outros, e você pode corrigir qualquer um em graus, minutos e segundos. Não entregamos um só e dizemos que ele é o certo. Se o nosso resultado não bater com outra fonte, a primeira coisa a conferir é se as duas usam o mesmo ayanamsa.

Esta é a parte que a maioria das documentações de API não pode afirmar. Nossa referência não é escrita à mão: ela é gerada a partir dos próprios serializers pelo build_api_catalogue e depois comprovada em um servidor rodando pelo verify_api_catalogue, que envia cada requisição de exemplo documentada e confere se ela retorna 2xx.

O resultado é o que importa: 255 das 299 páginas de endpoint mostram uma resposta real capturada, e não inventada, e as outras aparecem marcadas como ainda não verificadas, em vez de passarem por funcionando. Nenhum campo some da documentação sem ninguém perceber, como acontece numa planilha mantida à mão. Se um serializer muda e a documentação não é gerada de novo, a verificação falha, em vez de publicar uma mentira.

O mesmo catálogo gera a especificação OpenAPI, a coleção do Postman e o llms.txt, então os quatro descrevem obrigatoriamente a mesma API.

O backend tem 1.783 funções de teste em 87 módulos. O foco maior está na medição de consumo, porque é ali que um erro tira dinheiro de alguém. Os testes garantem que uma chamada bem-sucedida desconta exatamente o custo do endpoint, que um 4xx e um 5xx não descontam nada, que duas requisições disputando o último crédito ao mesmo tempo não deixam o saldo negativo e que o livro-razão fecha com o saldo depois de uma sequência aleatória de créditos concedidos e gastos.

Publicamos mediana de 62 ms e 76% abaixo de 100 ms. Esses números vêm de chamar 254 exemplos publicados em 22 de outubro de 2026, cada um com a sua própria requisição de exemplo, numa execução local da API — uma vez para aquecer e depois uma vez cronometrada —, e não de cronometrar um endpoint rápido e arredondar. O chat com IA fica de fora: o tempo dele é o do modelo de linguagem.

Por isso também dizemos o seguinte: alguns endpoints são bem mais lentos, e a documentação deixa isso claro. Um varshaphal completo ou um ano de raasi dasha leva segundos, não milissegundos, porque é uma varredura e não uma consulta simples. A mediana esconde isso; publicar a distribuição ao lado dela, não.

mediana  62 ms      metade dos endpoints responde mais rápido
<100 ms  76%        a maioria das consultas comuns
lentos   segundos    varreduras pesadas — indicadas na referência

Duas coisas que gostaríamos de publicar e ainda não publicamos. Dizemos isso às claras, em vez de deixar você presumir:

• Um benchmark independente de posições. Calculamos a partir das efemérides do JPL, mas ainda não publicamos uma comparação dos nossos resultados com o JPL Horizons em várias datas e corpos celestes, com os desvios e o código para reproduzir tudo. Até lá, entenda a promessa de precisão como “calculado a partir desta fonte”, e não como “verificado dentro desta tolerância”.
• Disponibilidade de longo prazo. A disponibilidade só é publicada na página de status desde outubro de 2026, então ainda não há um histórico longo para citar. Veja em transparência o que nós de fato garantimos.

As duas estão na lista. Nenhuma é difícil; são trabalhos que preferimos fazer direito em vez de entregar uma aproximação.

O Playground faz chamadas reais com a sua chave, e uma chamada que falha não custa nada, então você pode comparar nossos resultados com a fonte em que já confia. Se encontrar uma diferença que o ayanamsa não explica, queremos saber.