A API do NatalChart.AI é o motor de cálculo do app NatalChart.AI, aberto a desenvolvedores. Envie a data, a hora e as coordenadas de nascimento e receba o mapa de volta: sem arquivos de efemérides para hospedar, sem tabelas de fusos horários para manter, sem biblioteca de astrologia para manter atualizada.
O que você pode criar
Páginas de mapa astral
Sol, Lua e signo ascendente, cada planeta em seu signo e sua casa, os aspectos com orbes e o equilíbrio de elementos, para qualquer nascimento de 1800 a 2399. /v1/chart/full, /v1/chart/short
Horóscopos diários a partir do céu real
Os trânsitos do dia sobre o mapa de uma pessoa, cada um com seu orbe e a indicação de se está ganhando ou perdendo força, além da fase da Lua e dos eventos do céu da semana. /v1/horoscope/daily, /v1/sky
Compatibilidade para apps de relacionamento
Dois mapas comparados: cada aspecto entre eles, em que casas da outra pessoa caem os planetas de cada uma e uma pontuação para cada esfera da vida. /v1/synastry
Previsões e o ano à frente
Cada trânsito exato num período de até 92 dias e o mapa da revolução solar de qualquer ano, no local de nascimento ou onde a pessoa estiver. /v1/transits, /v1/solar-return
Melhores dias
Cada dia de um período pontuado para uma atividade (negócios, romance, viagens, saúde e outras), com os trânsitos a favor e contra. /v1/timing
Astrocartografia e relocação
Uma cidade pontuada em relação a um mapa, ou as grandes cidades do mundo classificadas para ele, por esfera da vida e por região. /v1/locations/score, /v1/locations/rank
Comece em um minuto
Crie uma chave (grátis, sem cartão) e envie os dados de um nascimento:
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'Todos os endpoints, campos e erros estão na documentação da API, e o documento OpenAPI os descreve para geradores de código.
Precisão que você pode conferir
Zodíaco tropical, casas Placidus, os cinco aspectos maiores, nodo lunar verdadeiro, posições com quatro casas decimais de grau. O fuso horário é determinado a partir das coordenadas, com as regras de horário de verão da data de nascimento, e uma hora de nascimento desconhecida deixa de fora as casas e os ângulos em vez de adivinhá-los. O relatório de precisão compara o motor com o NASA JPL Horizons, e o mapa de demonstração publicado permite conferir uma resposta antes de escrever qualquer código.
Para assistentes de IA: o servidor MCP
Os mesmos cálculos estão disponíveis como servidor MCP em https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor e VS Code se conectam com a mesma chave e chamam por conta própria as ferramentas de mapa, de trânsitos e de compatibilidade, de modo que o assistente lê um mapa calculado, não adivinhado.
Preços
| Plano | Preço | Requisições | Endpoints |
|---|---|---|---|
| Grátis | $0 | 10 por dia | Mapas e suas partes, horóscopo diário, céu, uso |
| API Pro | $6.99 por mês | 1.000 por dia | Tudo: trânsitos, sinastria, revoluções solares, melhores dias, lugares |
A cota é por conta e se renova às 00:00 UTC. Uma requisição rejeitada por ser inválida não é contada, e os dados de nascimento nunca são armazenados: o registro guarda apenas o endpoint, o status e o horário.
Perguntas
Existe uma API de astrologia grátis?
Sim. Uma chave do NatalChart.AI é grátis e dá 10 requisições por dia: mapas natais completos ou em partes, o céu do dia com os trânsitos sobre um mapa e as posições planetárias de qualquer data. Não é preciso cartão. O API Pro ($6.99 por mês) aumenta a cota para 1.000 por dia e libera trânsitos de um período, sinastria, revoluções solares, melhores dias e astrocartografia.
Quão precisos são os cálculos?
As posições vêm do Swiss Ephemeris, o padrão dos softwares profissionais de astrologia, com seus arquivos de dados e o indicador de velocidade ativado. O mesmo motor desenha cada mapa no app NatalChart.AI, e o relatório de precisão compara os resultados dele com o NASA JPL Horizons.
Posso criar um app de horóscopo ou de compatibilidade com ela?
Sim, é para isso que ela existe: páginas de mapa astral, horóscopos diários a partir de trânsitos reais, pontuações de compatibilidade para apps de relacionamento, seletores de melhores dias e mapas de relocação. O uso comercial é permitido nos dois planos; mantenha a chave no seu servidor.
Ela retorna interpretações escritas?
Não. A API calcula e retorna números: signos, graus, casas, aspectos com orbes, pontuações por esfera da vida. Não há chamadas de IA, então a mesma entrada sempre gera a mesma saída, e as palavras ficam por sua conta ou do seu modelo.
Com quais linguagens e frameworks ela funciona?
Com qualquer coisa que consiga enviar uma requisição HTTPS com corpo JSON: JavaScript, Python, PHP, Swift, Kotlin, ferramentas no-code. A documentação tem exemplos para copiar e colar, e um documento OpenAPI descreve cada endpoint para geradores de código.
Assistentes de IA podem usá-la?
Sim, pelo servidor MCP: Claude, ChatGPT, Cursor e VS Code se conectam a ele com a mesma chave e chamam os cálculos como ferramentas.