La API de NatalChart.AI es el motor de cálculo de la aplicación NatalChart.AI, abierto a los desarrolladores. Envía una fecha, una hora y unas coordenadas de nacimiento y recibe la carta: sin archivos de efemérides que alojar, sin tablas de zonas horarias que mantener, sin una biblioteca de astrología que tener al día.
Qué puedes crear
Páginas de carta astral
Sol, Luna y signo ascendente, cada planeta en su signo y su casa, los aspectos con sus orbes y el equilibrio de elementos, para cualquier nacimiento de 1800 a 2399. /v1/chart/full, /v1/chart/short
Horóscopos diarios a partir del cielo real
Los tránsitos del día sobre la carta de una persona, cada uno con su orbe y si va ganando o perdiendo fuerza, además de la fase de la Luna y los eventos en el cielo de la semana. /v1/horoscope/daily, /v1/sky
Compatibilidad para servicios de citas
Dos cartas comparadas: todos los aspectos entre ellas, en qué casas de la otra persona caen los planetas de cada una y una puntuación para cada esfera de la vida. /v1/synastry
Previsiones y el año por delante
Cada tránsito exacto en un periodo de hasta 92 días y la carta de revolución solar de cualquier año, en el lugar de nacimiento o donde vaya a estar la persona. /v1/transits, /v1/solar-return
Mejores días
Cada día de un periodo, puntuado para una actividad (negocios, amor, viajes, salud y más), con los tránsitos a favor y en contra. /v1/timing
Astrocartografía y relocalización
Una ciudad puntuada frente a una carta, o las grandes ciudades del mundo ordenadas para ella, por esfera de la vida y por región. /v1/locations/score, /v1/locations/rank
Empieza en un minuto
Crea una clave (gratis, sin tarjeta) y después envía unos datos de nacimiento:
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 los endpoints, campos y errores están en la documentación de la API, y el documento OpenAPI los describe para los generadores de código.
Una precisión que puedes comprobar
Zodiaco tropical, casas Placidus, los cinco aspectos mayores, nodo lunar verdadero, posiciones con cuatro decimales de grado. La zona horaria se obtiene a partir de las coordenadas con las reglas de horario de verano de la fecha de nacimiento, y si la hora de nacimiento se desconoce, las casas y los ángulos se omiten en lugar de adivinarse. El informe de precisión compara el motor con JPL Horizons de la NASA, y la carta de demostración publicada te permite comprobar una respuesta antes de escribir código.
Para asistentes de IA: el servidor MCP
Los mismos cálculos se ofrecen como servidor MCP en https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor y VS Code se conectan con la misma clave y llaman por sí mismos a las herramientas de cartas, tránsitos y compatibilidad, de modo que el asistente interpreta una carta calculada, no adivinada.
Precios
| Plan | Precio | Solicitudes | Endpoints |
|---|---|---|---|
| Gratis | $0 | 10 al día | Cartas y sus partes, horóscopo diario, cielo, uso |
| API Pro | $6.99 al mes | 1000 al día | Todo: tránsitos, sinastría, revoluciones solares, mejores días, lugares |
El cupo es por cuenta y se renueva a las 00:00 UTC. Una solicitud rechazada por no ser válida no se cuenta, y los datos de nacimiento nunca se guardan: el registro conserva solo el endpoint, el estado y el tiempo.
Preguntas
¿Hay una API de astrología gratis?
Sí. Una clave de NatalChart.AI es gratis y da 10 solicitudes al día: cartas natales completas o por partes, el cielo del día con los tránsitos sobre una carta y las posiciones planetarias de cualquier fecha. No hace falta tarjeta. API Pro ($6.99 al mes) amplía el cupo a 1000 al día y desbloquea los tránsitos de un periodo, la sinastría, las revoluciones solares, los mejores días y la astrocartografía.
¿Qué precisión tienen los cálculos?
Las posiciones salen de Swiss Ephemeris, el estándar del software astrológico profesional, con sus archivos de datos y el indicador de velocidad activado. El mismo motor dibuja cada carta de la aplicación NatalChart.AI, y el informe de precisión compara sus resultados con JPL Horizons de la NASA.
¿Puedo crear sobre ella una aplicación de horóscopos o de compatibilidad?
Sí, para eso está: páginas de carta astral, horóscopos diarios a partir de tránsitos reales, puntuaciones de compatibilidad para servicios de citas, selectores de mejores días y mapas de relocalización. El uso comercial está permitido en los dos planes; guarda la clave en tu servidor.
¿Devuelve interpretaciones escritas?
No. La API calcula y devuelve números: signos, grados, casas, aspectos con sus orbes, puntuaciones por esfera de la vida. No hay llamadas a IA, así que los mismos datos de entrada dan siempre el mismo resultado, y las palabras siguen siendo tuyas o de tu modelo.
¿Con qué lenguajes y frameworks funciona?
Con cualquier cosa que pueda enviar una solicitud HTTPS con un cuerpo JSON: JavaScript, Python, PHP, Swift, Kotlin, herramientas sin código. La documentación tiene ejemplos para copiar y pegar, y un documento OpenAPI describe cada endpoint para los generadores de código.
¿Pueden usarla los asistentes de IA?
Sí, a través del servidor MCP: Claude, ChatGPT, Cursor y VS Code se conectan a él con la misma clave y llaman a los cálculos como herramientas.