Ir para o conteúdo
299 endpoints · MCP nativo · erros nunca são cobrados


Astrologia védica e ocidental, numerologia, astrocartografia e human design em uma só API REST. Precisão da NASA JPL, 48 ayanamsas, de Lahiri a Surya Siddhanta, resposta mediana de 62 ms e um crédito por chamada, não importa quanto você peça.

Pegue sua chave de API grátisTeste no Playground150créditos grátis para começarSem cartão
299
Védica, ocidental, numerologia e mais
330
Cálculos diferentes, um crédito por chamada
62 ms
Tempo mediano no servidor · 76% abaixo de 100 ms
48
Ayanamsas clássicos e modernos
01Para desenvolvedores

Todas as requisições e respostas abaixo foram copiadas do catálogo publicado, que é gerado com chamadas ao servidor real. Cole o curl e você recebe o JSON que aparece à direita.

POST /api/astro/sunrise/
Testar →
{
  "date_time": "2026-09-01T06:00:00+05:30",
  "timezone_as_float": 5.5,
  "latitude": 26.9124,
  "longitude": 75.7873
}
200 OK
{
  "data": {
    "sunrise": "2026-09-01T06:09:56+05:30",
    "sunset":  "2026-09-01T18:43:30+05:30",
    "day_length_seconds": 45214.0
  },
  "status": 200,
  "is_error": false
}

Segue a convenção hindu para o nascer do sol, por isso bate com o dia do panchanga ao segundo.

O mesmo envelope JSON em todas as rotas. Requisições que falham nunca são cobradas. Os erros trazem um código estável para máquinas, e não um texto que muda a cada versão.

Ou nem use o curl

TypeScript

O SDK oficial tem tipos para os 299 endpoints e para cada campo que eles aceitam, com a documentação ao passar o mouse. Zero dependências.

npm install occult-api
Conheça o SDK
02Diferenciais

Desempenho

Rápida onde importa, transparente no resto

A resposta mediana leva 62 ms de tempo de servidor, e 76% dos endpoints respondem em menos de 100 ms. A medição cobre todos os exemplos publicados, não um escolhido a dedo. Algumas varreduras pesadas, como um varshaphal completo ou um ano de raasi dasha, levam segundos, e a documentação diz isso. Você sabe o que vai receber antes de integrar, e não depois.

Precisão

Clássico e moderno, lado a lado

As posições vêm das efemérides da NASA JPL, com o conjunto completo de 105 MB e 735 estrelas fixas, testadas de 500 a 2999 d.C. Enquanto a concorrência entrega Lahiri e para por aí, aqui você tem 48 ayanamsas, incluindo a família Surya Siddhanta, Citra verdadeiro, Revati verdadeiro e Pushya verdadeiro. Assim você oferece aos seus usuários exatamente a tradição que eles pedem, e não a que era mais fácil de implementar.

Pronta para IA

Feita para a era do MCP

Com um servidor Model Context Protocol publicado, um assistente de IA consegue pesquisar a API inteira, ler o schema da requisição e fazer uma chamada, sem que você escreva um wrapper de ferramenta para cada endpoint. Cinco ferramentas cobrem todos os endpoints. Pesquisar e ler a documentação é grátis, então o agente pode explorar a API antes de gastar um crédito.

Cobertura

Uma API no lugar de cinco

Jyotisha a fundo (mapas divisionais, ashtakavarga, sistemas de dasha, panchanga, muhurta, upagrahas) ao lado de astrologia natal ocidental, numerologia em quatro sistemas, astrocartografia, human design, eclipses e trânsitos mundanos. Uma só forma de autenticação, um só envelope de resposta, uma só fatura.

03Cobertura

299 endpoints e 330 cálculos diferentes. A lista completa está na referência.

Védica a fundo

  • Mapas divisionais D2–D60, cada um com sua rota
  • Ashtakavarga: sarva, bhinna e os pindas
  • Panchang, muhurta, choghadiya, hora, vrats e festivais
  • Dashas, tarabala, chandrabala, upagrahas

Outros sistemas

  • Mapas natais ocidentais, planetas e cúspides das casas
  • Numerologia védica, caldeia, pitagórica e chinesa
  • Linhas de astrocartografia, parans e relocação
  • Mapas de human design, propriedades e conexões

Mundana e eventos

  • Eclipses solares e lunares, com as circunstâncias locais
  • Ingressos, estações e lunações
  • Trânsitos globais
  • Calendários regionais: tâmil, bengali, telugo, malaiala, nepalês

Para desenvolvedores

  • O mesmo envelope JSON em todas as rotas
  • Um corpo de requisição pronto para rodar em cada endpoint
  • Playground interativo: envie uma requisição real pelo navegador
  • Servidor MCP no npm para agentes de IA
04O que dá para construir

Telas feitas com estes endpoints. Todas são interfaces reais, rodando na mesma API que você vai chamar, e o endpoint que gera cada uma aparece logo abaixo dela.

05Panchang

Uma chamada para o dia inteiro ou um endpoint só para o elemento que está faltando. Nos dois casos, o mesmo crédito.

59
Endpoints de panchang

Elementos, horários, calendários e festivais

57
Cálculos em uma chamada

Peça todos e pague um crédito

15
Endpoints de muhurta e horários

Rahu kaal, choghadiya, hora, abhijit

1
Crédito por chamada

Um elemento ou todos, pelo mesmo preço

O panchang inteiro em uma requisição

/api/astro/panchanga/ recebe data, local e fuso horário e devolve até 57 cálculos diferentes: os elementos com os timestamps exatos de início e fim, nascer e pôr do sol, os períodos auspiciosos e inauspiciosos do dia e o mês lunar nas duas contagens, amanta e purnimanta.

Diga quais chaves você quer e deixe o resto de fora. Pedir uma custa o mesmo crédito que pedir todas, então uma tela de panchang diário é uma chamada, e não quarenta.

Ou só o elemento de que você precisa

Cada elemento também tem o próprio endpoint, com a resposta documentada. É útil quando você só quer acrescentar uma linha a uma tela que já existe, e não montar uma página de panchang.

Todos recebem o mesmo corpo de requisição (data, latitude, longitude e fuso horário), então trocar de um para outro é só mudar a URL.

Horários, muhurtas e o resto do dia

Cada um devolve timestamps reais de início e fim para as suas coordenadas, e não um horário fixo copiado de almanaque.

São 59 endpoints na família panchang. Veja todos na referência ou teste um no Playground antes de escrever qualquer código.

06Calendários

Onze calendários regionais, cinco tradições e 9.933 datas de festivais. Cada região é calculada do jeito que ela mesma calcula, e a lista continua crescendo com novas regiões.

9.933
Datas de festivais

Pré-calculadas, uma consulta indexada por ano

18
Endpoints

Calendários, festivais, vrats e sankranti

11
Calendários regionais

Cada um com seu endpoint

5
Tradições

Hindu, sikh, jainista, cristã, ekadashis

Onze calendários regionais, cada um com seu endpoint

Não é uma lista única de festivais com um seletor de idioma. Cada região usa a contagem que realmente adota e recebe datas baseadas em tithi, com timestamps exatos de início e fim para o ano todo.

  • Bengali
  • Tâmil
  • Malaiala
  • Telugo
  • Canarês
  • Marati
  • Guzerate
  • Nepalês
  • Assamês
  • Oriá
  • ISKCON

E mais: festivais de toda a Índia calculados do zero para a sua localização, dezoito tipos de vrat e upavas, datas de sankranti, anos samvat e o gabinete do samvatsara. São dezoito endpoints no total, e a lista cresce conforme novas regiões entram.

07Comparativo

Como a Occult API se sai frente às alternativas nos pontos que um produto de Jyotish realmente encontra pela frente.

Occult API comparada com outras APIs de astrologia
RecursoOccult APIRecomendadoastrology-api.ioAstrologyAPIVedicAstroAPIVedAstroVedikaRoxyAPIDivineAPIProkerala
Tempo mediano de respostaMedido em todos os exemplos publicados, e não um número redondo de marketing.62 ms~300 msNão divulgaNão divulga<500 ms em média200–800 msNão divulgaA partir de 72 ms (melhor caso)Não divulga
Ayanamsas com correção manualEscolha uma tradição e corrija em graus, minutos e segundos.48, com correção12, lista fixa6, lista fixaNão divulga~46, lista fixa4, lista fixa4, ou um valor personalizadoNão divulga4, lista fixa

Em toda conta da Occult API

Sem níveis, sem adicionais, sem gasto mínimo. Isto já vem por padrão.

48
Ayanamsas

Com correção manual até o segundo de arco

11
Calendários regionais

Cada um com seu endpoint

9.933
Datas de festivais

Em onze calendários regionais

35
Endpoints de dasha

Trinta sistemas, com níveis de detalhe

Todos os 299
Em todos os planos

Nenhum nível esconde endpoints

SVG
Mapas desenhados para você

Com a geometria do layout

0
Chamadas com falha cobradas

Um 400 não custa nada

Todos os números da Occult API são medidos na API em funcionamento e republicados a cada deploy. Os números das outras plataformas foram tirados das páginas públicas de preços e documentação delas entre 15 de setembro de 2026 e 22 de outubro de 2026, e podem ter mudado desde então. Quando uma célula diz não divulga, é porque a plataforma não publica nenhum número no site, então não há com o que comparar até você se cadastrar e medir por conta própria. Isso não quer dizer que o recurso não exista, e não colocamos um número ali em nome delas.

08Confira

Preferimos que você não acredite nesta página só porque estamos dizendo. Abra uma das opções abaixo e a pergunta já vem escrita: o assistente pesquisa, lê a referência pública e a coleção do Postman e traz um relatório. Se exageramos em alguma coisa, é ali que vai aparecer.

Abre em uma nova aba com a pergunta preenchida. Nada é enviado para nós.

Ou pule a leitura. Conecte um assistente compatível com MCP ao nosso servidor MCP: ele pesquisa os endpoints, lê o schema da requisição, faz uma chamada real e julga a resposta em si, e não a nossa descrição dela. Pesquisar e ler a documentação não consome créditos.

09Quanto custa

Planos com cota mensal, e não uma tabela de preços por endpoint. Todo plano chama todos os endpoints, e ninguém precisa falar com vendas para aumentar um limite.

Um crédito por chamada, não importa quanto você peça

Pedir um cálculo ou quarenta custa o mesmo. /api/astro/panchanga/ traz 57 cálculos, então pedir tudo de que você precisa em uma só chamada é o caminho mais barato, e não o mais caro. As exceções são os relatórios em PDF e o chat com IA, que custam 25 créditos por chamada.

Requisições que falham nunca são cobradas

O crédito é reservado antes do cálculo e devolvido se ele não terminar sem erro. Um 4xx, um 5xx ou um timeout não custa nada: você paga por respostas, não por tentativas.

Sem cobrança por usuário, cancele quando quiser

Um plano cobre a equipe inteira: não há cobrança por desenvolvedor. Cancele quando quiser: o período que você pagou continua valendo até terminar.

Planos mensais ou anuais, um crédito por chamada bem-sucedida, sem preço por usuário. Crie uma chave e faça a primeira requisição no navegador antes de escrever qualquer código.