URL base: https://api.natalchart.ai. Cada solicitud lleva una clave de API, cada respuesta está en JSON y cada longitud se da con cuatro decimales de grado antes de convertirse en un signo. La clave es gratis: inicia sesión con una cuenta de NatalChart.AI y crea una en la pestaña API & MCP de los ajustes de la aplicación.
Inicio rápido
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}}'La respuesta, para el nacimiento de demostración que se usa en todo el sitio (1991-09-06, 18:30, Kiev). Se muestran cinco de los cuerpos:
{
"sun": {
"sign": "Virgo",
"degreeInSign": 13.55,
"house": 7
},
"moon": {
"sign": "Leo",
"degreeInSign": 19.02,
"house": 7
},
"ascendant": {
"sign": "Aquarius",
"degreeInSign": 14.9898
},
"signs": {
"Sun": "Virgo",
"Moon": "Leo",
"Mercury": "Leo",
"Venus": "Leo",
"Mars": "Libra"
},
"retrograde": [
"Venus",
"Saturn",
"Uranus",
"Neptune",
"TrueNode",
"Lilith",
"Juno"
]
}Ejemplos de código
La misma solicitud en JavaScript, Python y PHP. Sirve cualquier cliente HTTP, y el documento OpenAPI permite que un generador de código escriba el cliente por ti.
JavaScript
const res = await fetch("https://api.natalchart.ai/v1/chart/short", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.NATALCHART_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ birth: { date: "1991-09-06", time: "18:30", latitude: 50.4501, longitude: 30.5234 } }),
});
const chart = await res.json();Python
import os, requests
res = requests.post(
"https://api.natalchart.ai/v1/chart/short",
headers={"Authorization": f"Bearer {os.environ['NATALCHART_API_KEY']}"},
json={"birth": {"date": "1991-09-06", "time": "18:30", "latitude": 50.4501, "longitude": 30.5234}},
)
chart = res.json()PHP
$ch = curl_init("https://api.natalchart.ai/v1/chart/short");
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("NATALCHART_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode(["birth" => ["date" => "1991-09-06", "time" => "18:30", "latitude" => 50.4501, "longitude" => 30.5234]]),
]);
$chart = json_decode(curl_exec($ch), true);Servidor MCP para asistentes de IA
Los mismos cálculos se ofrecen como servidor MCP en https://www.natalchart.ai/mcp, para Claude, ChatGPT, Cursor y VS Code. Usa la misma clave y gasta el mismo cupo diario, una solicitud por cada llamada a una herramienta. La configuración de cada cliente: Servidor MCP para asistentes de IA.
Autenticación
Envía la clave como Authorization: Bearer nc_live_... (también sirve el encabezado X-API-Key). La clave completa se muestra una sola vez, al crearla; nosotros solo guardamos su hash. Una cuenta puede tener hasta cinco claves activas y revocar cualquiera de ellas al instante. Guarda las claves en un servidor: una clave incluida en el código de un navegador o de una aplicación la puede leer cualquiera.
Datos de nacimiento
Los endpoints que calculan una carta reciben un objeto:
{
"birth": {
"date": "1991-09-06",
"time": "18:30",
"latitude": 50.4501,
"longitude": 30.5234,
"timezone": "Europe/Kyiv"
}
}| Campo | Obligatorio | Significado |
|---|---|---|
date | sí | Fecha de nacimiento, YYYY-MM-DD, de 1800 a 2399. |
time | no | Hora local, HH:mm, en formato de 24 horas. null si se desconoce. |
latitude, longitude | sí | Grados decimales, positivos al norte y al este. |
timezone | no | Zona horaria IANA. Si se omite, se obtiene a partir de las coordenadas con las reglas de horario de verano de esa fecha. |
Endpoints
| Endpoint | Plan | Devuelve |
|---|---|---|
POST /v1/chart/short | Gratis | La carta resumida: Sol, Luna y Ascendente con sus grados, el signo de cada cuerpo, los cuerpos retrógrados, y el elemento y la modalidad dominantes. |
POST /v1/chart/full | Gratis | La carta completa: cada cuerpo con longitud, signo, grado, velocidad, indicador de retrogradación y casa; los ángulos; las doce cúspides Placidus; los aspectos con sus orbes; el equilibrio de elementos y modalidades; los contactos con estrellas fijas. |
POST /v1/chart/planets | Gratis | Solo los cuerpos: longitud, signo, grado dentro del signo, velocidad diaria, indicador de retrogradación, casa. |
POST /v1/chart/angles | Gratis | Ascendente, Medio Cielo, Vértex y Parte de la Fortuna. |
POST /v1/chart/houses | Gratis | Las doce cúspides de las casas Placidus. |
POST /v1/chart/aspects | Gratis | Los cinco aspectos mayores entre los cuerpos, cada uno con su ángulo y su orbe, y la tabla de orbes utilizada. |
POST /v1/chart/elements | Gratis | El equilibrio de elementos y modalidades, con el elemento y la modalidad dominantes. |
POST /v1/chart/fixed-stars | Gratis | Conjunciones de estrellas fijas con los cuerpos natales a menos de 1,5 grados. |
POST /v1/horoscope/daily | Gratis | El día calculado: el cielo al mediodía UTC, la fase de la Luna, los eventos en el cielo de los próximos siete días y, con datos de nacimiento, cada tránsito sobre la carta natal con su orbe. Sin texto generado. |
GET /v1/sky | Gratis | Posiciones planetarias, fase lunar y los eventos en el cielo de los próximos siete días para una fecha (?date=YYYY-MM-DD, hoy por defecto). Funciona sin clave. |
GET /v1/usage | Gratis | Tu plan, el recuento de hoy y cuándo se renueva el cupo. No cuesta nada. |
POST /v1/transits | Premium y MAX | Hasta 60 eventos de tránsito en un periodo de hasta 92 días (los más importantes, si hay más): aspectos exactos de tránsito sobre la carta natal por fecha, ingresos en signos y estaciones. |
POST /v1/synastry | Premium y MAX | Dos cartas comparadas: aspectos entre las cartas con sus orbes, superposiciones de casas en los dos sentidos y una puntuación por esfera de la vida. |
POST /v1/solar-return | Premium y MAX | La carta de revolución solar de un año, levantada para el lugar de nacimiento o para otro lugar. |
POST /v1/timing | Premium y MAX | Cada día de un periodo de hasta 62 días, puntuado para una actividad (general, business, romance, health, creative, travel, home, clarity): los tránsitos que ayudan y los que dificultan, la fase y el signo de la Luna y si está vacía de curso. Primero, los cinco mejores días. |
POST /v1/locations/score | Premium y MAX | Un lugar frente a una carta: los ángulos relocalizados, los planetas sobre ellos con sus orbes, una puntuación para cada esfera de la vida y una puntuación global. |
POST /v1/locations/rank | Premium y MAX | El catálogo de grandes ciudades ordenado para una carta, en conjunto o por las esferas de la vida elegidas, en todo el mundo o en una región. |
La carta completa
POST /v1/chart/full devuelve el cálculo completo con la estructura del archivo de demostración publicado, así que puedes comprobar una respuesta con una carta fija antes de escribir código. Aquí aparece recortado a dos cuerpos, dos cúspides y los dos aspectos más exactos:
{
"input": {
"date": "1991-09-06",
"time": "18:30",
"latitude": 50.4501,
"longitude": 30.5234,
"timeKnown": true
},
"time": {
"timezone": "Europe/Kyiv",
"offsetHours": 3,
"julianDayUT": 2448506.1458333335
},
"planets": [
{
"name": "Sun",
"longitude": 163.5457,
"sign": "Virgo",
"degreeInSign": 13.55,
"speed": 0.9704,
"retrograde": false,
"house": 7
},
{
"name": "Moon",
"longitude": 139.0225,
"sign": "Leo",
"degreeInSign": 19.02,
"speed": 14.5955,
"retrograde": false,
"house": 7
}
],
"angles": {
"ascendant": {
"longitude": 314.9898,
"sign": "Aquarius"
},
"midheaven": {
"longitude": 249.8956,
"sign": "Sagittarius"
}
},
"houses": [
{
"number": 1,
"cusp": 314.9898,
"sign": "Aquarius"
},
{
"number": 2,
"cusp": 13.7492,
"sign": "Aries"
}
],
"aspects": [
{
"planet1": "Pallas",
"planet2": "Juno",
"aspect": "Square",
"angle": 89.79,
"orb": 0.21,
"phase": "separating"
},
{
"planet1": "Pluto",
"planet2": "TrueNode",
"aspect": "Sextile",
"angle": 59.57,
"orb": 0.43,
"phase": "separating"
}
],
"elements": {
"Fire": 7,
"Earth": 6,
"Air": 4,
"Water": 2
},
"qualities": {
"Cardinal": 6,
"Fixed": 11,
"Mutable": 2
}
}Los endpoints de segmento (planets, angles, houses, aspects, elements, fixed-stars) devuelven cada uno una parte del mismo objeto, para quien solo necesite esa parte.
El horóscopo diario
POST /v1/horoscope/daily es la mitad calculada de un horóscopo diario: el cielo al mediodía UTC, la fase y el signo de la Luna, los eventos en el cielo de los próximos siete días y, cuando envías birth, cada tránsito sobre esa carta con su aspecto, su orbe, si es aplicativo o separativo, el momento en que es o fue exacto y la casa natal en la que está el cuerpo en tránsito. Los orbes de tránsito son de 2° para la Luna, el Sol, Mercurio, Venus y Marte, y de 3° para los cuerpos más lentos. Dos campos son reglas fijas y no astronomía, y la respuesta lo indica: tone (supportive para el trígono y el sextil, challenging para la cuadratura y la oposición, intensifying para la conjunción) y focus, los tres contactos mejor clasificados por velocidad del planeta y exactitud. No hay texto escrito; esa parte es tuya.
Una respuesta real para la carta de demostración el 2026-09-18, con las listas recortadas a dos elementos:
{
"date": "2026-09-18",
"computedFor": "2026-09-18T12:00:00.000Z",
"moon": {
"phase": "First Quarter",
"illumination": 46.5,
"elongation": 86.04,
"sign": "Sagittarius",
"longitude": 261.6344,
"degreeInSign": 21.63,
"theme": "Decision + Action",
"nextNewMoon": {
"utc": "2026-10-10T15:50:05.436Z",
"sign": "Libra",
"degreeInSign": 17.36,
"absoluteDegree": 197.36
},
"nextFullMoon": {
"utc": "2026-09-26T16:49:02.781Z",
"sign": "Aries",
"degreeInSign": 3.62,
"absoluteDegree": 3.62
}
},
"positions": [
{
"name": "Sun",
"longitude": 175.5994,
"sign": "Virgo",
"degreeInSign": 25.6,
"speed": 0.9761,
"retrograde": false
},
{
"name": "Moon",
"longitude": 261.6344,
"sign": "Sagittarius",
"degreeInSign": 21.63,
"speed": 11.8869,
"retrograde": false
}
],
"events": [
{
"kind": "ingress",
"at": "2026-09-23T00:05:13.524Z",
"planet": "sun",
"sign": "Libra",
"degreeInSign": 0.01
},
{
"kind": "equinox",
"at": "2026-09-23T00:05:13.524Z",
"planet": "sun",
"sign": "Libra",
"degreeInSign": 0.01
}
],
"transits": [
{
"transit": "Vesta",
"natal": "Mercury",
"aspect": "Trine",
"angle": 119.93,
"orb": 0.07,
"phase": "applying",
"exactAt": "2026-09-18T21:43:39.997Z",
"tone": "supportive",
"transitHouse": 2,
"houseTheme": "Money & Possessions"
},
{
"transit": "Uranus",
"natal": "Lilith",
"aspect": "Trine",
"angle": 119.86,
"orb": 0.14,
"phase": "separating",
"exactAt": null,
"tone": "supportive",
"transitHouse": 3,
"houseTheme": "Communication & Learning"
}
],
"focus": [
{
"transit": "Pluto",
"natal": "Mars",
"aspect": "Trine",
"angle": 119.78,
"orb": 0.22,
"phase": "separating",
"exactAt": "2026-09-03T17:58:04.996Z",
"tone": "supportive",
"transitHouse": 12,
"houseTheme": "Spirituality & Subconscious"
},
{
"transit": "Neptune",
"natal": "Mars",
"aspect": "Opposition",
"angle": 179.74,
"orb": 0.26,
"phase": "separating",
"exactAt": "2026-09-09T00:24:29.005Z",
"tone": "challenging",
"transitHouse": 1,
"houseTheme": "Identity & Self"
},
{
"transit": "Jupiter",
"natal": "Moon",
"aspect": "Conjunction",
"angle": 1.77,
"orb": 1.77,
"phase": "applying",
"exactAt": "2026-09-27T20:40:07.004Z",
"tone": "intensifying",
"transitHouse": 7,
"houseTheme": "Partnerships & Marriage"
}
]
}Endpoints de Premium y MAX
Seis endpoints que, juntos, son todo lo que calcula la aplicación. Cada ejemplo de abajo es una respuesta real para la carta de demostración, recortada; "..." en una solicitud representa el objeto de datos de nacimiento que aparece arriba.
Tránsitos de un periodo
POST /v1/transits recibe birth, from y to (como máximo, 92 días) y devuelve hasta 60 eventos del periodo (los más importantes, si hay más): aspectos exactos de tránsito sobre la carta natal por fecha, ingresos en signos y estaciones, en orden cronológico. También da los contactos activos el primer día, con su fase y el momento en que son exactos.
{
"window": {
"from": "2026-09-18",
"to": "2026-10-18"
},
"events": [
{
"kind": "aspect",
"at": "2026-09-19T10:10:33.151Z",
"date": "2026-09-19",
"position": "14°06′ Libra",
"house": 8,
"body": "Mercury",
"target": "Neptune",
"aspect": "Square",
"exactness": 0,
"targetPosition": "14°06′ Capricorn",
"targetHouse": 11,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-22T09:53:49.800Z",
"date": "2026-09-22",
"position": "18°00′ Leo",
"house": 7,
"body": "Jupiter",
"target": "Pluto",
"aspect": "Square",
"exactness": 0,
"targetPosition": "18°00′ Scorpio",
"targetHouse": 8,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-23T20:47:58.234Z",
"date": "2026-09-23",
"position": "0°51′ Libra",
"house": 7,
"body": "Sun",
"target": "Saturn",
"aspect": "Trine",
"exactness": 0,
"targetPosition": "0°51′ Aquarius",
"targetHouse": 12,
"significance": "low"
},
{
"kind": "aspect",
"at": "2026-09-26T12:58:36.996Z",
"date": "2026-09-26",
"position": "3°28′ Libra",
"house": 7,
"body": "Sun",
"target": "Mars",
"aspect": "Conjunction",
"exactness": 0,
"targetPosition": "3°28′ Libra",
"targetHouse": 7,
"significance": "low"
}
]
}Sinastría
POST /v1/synastry recibe personA y personB y devuelve los aspectos entre las cartas con sus orbes, en qué casas de la otra persona caen los planetas de cada una y una puntuación para cada una de las seis esferas de la vida. Aquí la segunda persona también es ficticia (1989-03-14, 07:45, Nueva York).
{
"aspects": [
{
"personA": "Neptune",
"personB": "Lilith",
"aspect": "Trine",
"angle": 120.08,
"orb": 0.08
},
{
"personA": "Saturn",
"personB": "Jupiter",
"aspect": "Trine",
"angle": 119.66,
"orb": 0.34
},
{
"personA": "Mercury",
"personB": "Moon",
"aspect": "Sextile",
"angle": 60.38,
"orb": 0.38
}
],
"sphereScores": {
"identity": 89,
"love": 81,
"body": 86,
"money": 76,
"home": 83,
"mind": 66
}
}Revolución solar
POST /v1/solar-return recibe birth, year y location (opcional), y devuelve el momento exacto en que el Sol vuelve a su longitud natal, con la carta completa levantada para ese momento. Necesita la hora de nacimiento: sin ella, el Sol natal tiene una incertidumbre de medio grado, lo que desplaza la revolución unas doce horas.
{
"year": 2027,
"exactMomentUtc": "2027-09-06T08:29:55Z",
"location": {
"latitude": 50.4501,
"longitude": 30.5234
},
"chart": "the full chart of that moment, in the shape of /v1/chart/full"
}Mejores días para una actividad
POST /v1/timing recibe birth, activity (general, business, romance, health, creative, travel, home o clarity), from y to (como máximo, 62 días) y timezone (opcional), que marca el inicio de cada día. Cada día se puntúa de 0 a 100 a partir de la geometría exacta de los tránsitos, ponderada según los planetas que importan para la actividad, y los cinco mejores días van primero. Describe el cielo; no promete cómo será un día.
{
"activity": "business",
"best": [
{
"date": "2026-10-12",
"score": 69.5,
"rating": "good",
"moonPhase": "New Moon",
"moonSign": "Scorpio",
"voidOfCourse": false,
"favorableAspects": [
"Transit Sun Sextile Moon (0.2°)",
"Transit Mercury Sextile Sun (0.3°)",
"Transit Mercury Sextile Neptune (0.2°)"
],
"challengingAspects": [
"Transit Saturn Square Uranus (0.8°)"
]
},
{
"date": "2026-10-14",
"score": 63.5,
"rating": "good",
"moonPhase": "Waxing Crescent",
"moonSign": "Sagittarius",
"voidOfCourse": false,
"favorableAspects": [
"Transit Sun Sextile Venus (1.1°)",
"Transit Moon Sextile Saturn (0.7°)",
"Transit Jupiter Conjunction Venus (0.1°)"
],
"challengingAspects": [
"Transit Saturn Square Uranus (0.7°)",
"Transit Saturn Square Uranus (0.6°)"
]
}
]
}Un lugar frente a una carta
POST /v1/locations/score recibe birth y location con coordenadas. La carta se relocaliza allí, y la respuesta da los ángulos relocalizados, los planetas sobre ellos con sus orbes, una puntuación de 0 a 10 para cada esfera de la vida (5 es neutral) y la intensidad con la que la carta reacciona al lugar: fuerte cuando un planeta principal está a menos de 2° de un ángulo, moderada a menos de 4° y débil en los demás casos.
{
"relocated": {
"ascendant": {
"longitude": 277.7847,
"sign": "Capricorn"
},
"midheaven": {
"longitude": 210.708,
"sign": "Scorpio"
}
},
"angularPlanets": [
{
"planet": "Uranus",
"angle": "ASC",
"orb": 2.12,
"weight": "major",
"strength": "strong"
},
{
"planet": "Neptune",
"angle": "ASC",
"orb": 6.31,
"weight": "major",
"strength": "weak"
}
],
"spheres": {
"identity": {
"score10": 1,
"verdict": "challenging"
},
"love": {
"score10": 6.1,
"verdict": "slightly supportive"
},
"body": {
"score10": 3.2,
"verdict": "challenging"
},
"money": {
"score10": 2.2,
"verdict": "challenging"
},
"home": {
"score10": 1.7,
"verdict": "challenging"
},
"mind": {
"score10": 4.9,
"verdict": "neutral"
}
},
"overall10": 2.2,
"strength": "moderate"
}Las mejores ciudades para una carta
POST /v1/locations/rank recibe birth, focus (opcional, cualquiera de identity, love, body, money, home, mind), region (opcional) y limit, de 3 a 12, y ordena un catálogo de 61 grandes ciudades. No se comparan todas las ciudades de la Tierra; cualquier otro lugar se puede puntuar con el endpoint anterior.
{
"comparedCities": 61,
"top": [
{
"city": "New York",
"country": "United States",
"overall10": 7.4,
"focus10": 8.3,
"strength": "strong",
"contacts": [
"Venus MC 0.6°",
"Moon MC 2.3°"
]
},
{
"city": "Tbilisi",
"country": "Georgia",
"overall10": 7.4,
"focus10": 8.2,
"strength": "moderate",
"contacts": [
"Sun DSC 3.3°"
]
},
{
"city": "Montreal",
"country": "Canada",
"overall10": 7.4,
"focus10": 8.1,
"strength": "strong",
"contacts": [
"Venus MC 0.1°",
"Moon MC 2.8°",
"Mercury MC 3.8°"
]
}
]
}Límites y precios
| Plan | Precio | Solicitudes | Endpoints |
|---|---|---|---|
| Gratis | $0 | 10 al día | Cartas, segmentos, horóscopo diario, cielo |
| Premium | $9.99 al mes o $79 al año | 100 al día | Todo: tránsitos, sinastría, revoluciones solares, mejores días, lugares |
| MAX | $19.99 al mes o $179 al año | Sin límite diario | Todo: tránsitos, sinastría, revoluciones solares, mejores días, lugares |
Las solicitudes se cuentan por cuenta, sumando todas sus claves, y el cupo se renueva a las 00:00 UTC. Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Una solicitud rechazada por no ser válida no se cuenta, un cálculo que falla por nuestra parte se devuelve al cupo y GET /v1/usage siempre es gratis. Premium y MAX son los propios planes de la aplicación: una sola suscripción cubre la aplicación, la API y el servidor MCP, y se cancela como cualquier plan de la aplicación, desde Gestionar suscripción. Los cupos siguen siendo independientes: la aplicación cuenta las respuestas de IA por semana, esta API cuenta los cálculos por día UTC, y ninguno consume el otro.
Errores
Todos los errores tienen la misma estructura: { "error": { "code", "message", "details"?, "docs", "upgrade_url"? } }.
| Estado | Código | Cuándo |
|---|---|---|
| 400 | invalid_request | El cuerpo no es válido. details enumera todos los problemas. No se cuenta. |
| 401 | missing_api_key, invalid_api_key | No hay clave, o la clave es desconocida o está revocada. |
| 403 | plan_required | Un endpoint de Premium y MAX llamado con el plan gratuito. |
| 429 | daily_limit_reached | El cupo del día está agotado. Se renueva a las 00:00 UTC. |
| 500 | internal_error | Un fallo por nuestra parte. La solicitud no se cuenta. |
Ajustes de cálculo
Son fijos y son los ajustes de la propia aplicación, descritos en detalle en la página Verifica tu carta y comparados con JPL Horizons de la NASA sobre una carta de prueba publicada en el informe de precisión. Archivos de datos de Swiss Ephemeris con el indicador de velocidad activado. Zodiaco tropical, posiciones geocéntricas y aparentes. Casas Placidus. Nodo lunar verdadero. Lilith como apogeo lunar osculador. Parte de la Fortuna como ASC + Luna − Sol, igual en las cartas diurnas y nocturnas. Solo los cinco aspectos mayores: conjunción 8°, sextil 6°, cuadratura 8°, trígono 8°, oposición 8°. Cada aspecto natal y de tránsito indica si es aplicativo o separativo, a partir de las velocidades de los dos cuerpos, incluido el movimiento retrógrado.
En producción
En los últimos 30 días (del 19 de septiembre de 2026 al 16 de octubre de 2026), el servidor respondió a un cálculo en 280 ms de mediana y en 526 ms en el percentil 95, medidos desde que llega la solicitud hasta que sale la respuesta. El informe de precisión compara los números de una carta de prueba publicada con JPL Horizons de la NASA.
Privacidad
Los datos de nacimiento son datos personales. La API los lee, calcula, responde y los olvida: no se guarda ningún cuerpo de solicitud y nada de lo que envías se usa para otra cosa que no sea la respuesta. De cada solicitud guardamos el endpoint, el código de estado y la latencia. Consulta la política de privacidad.
Registro de cambios
- 2 de noviembre de 2026: La API y el servidor MCP pasan a incluirse en los planes de la aplicación NatalChart.AI: todos los endpoints con Premium, a 100 solicitudes al día, y con MAX, sin límite diario. Las claves se trasladan a la aplicación, a la pestaña API & MCP de los ajustes.
- 16 de octubre de 2026: Las respuestas 429 y 403 indican el precio e incluyen un campo
upgrade_urlcon el enlace para cambiar de plan. - 3 de octubre de 2026: Las puntuaciones de lugares usan el mismo modelo que la aplicación NatalChart.AI, y
/v1/locations/scoreañadeoverall10. - 2 de octubre de 2026: El servidor MCP se lanza en https://www.natalchart.ai/mcp y figura en el MCP Registry oficial.
- 22 de septiembre de 2026: Las claves se aceptan sin prefijo, entre comillas o con un Bearer duplicado, y cada 401 indica qué salió mal.
- 19 de septiembre de 2026: Los mejores días y los dos endpoints de lugares se suman a la API: diecisiete endpoints en total.
- 18 de septiembre de 2026: Se lanza la API: cartas natales, el horóscopo diario y el cielo con una clave gratis; tránsitos, sinastría y revoluciones solares con un plan de pago.
Preguntas
¿La API usa IA?
No. Cada endpoint es un cálculo: posiciones planetarias de Swiss Ephemeris, cúspides de las casas, aspectos, tránsitos. No se genera texto ni se llama a ningún modelo de lenguaje, y por eso los mismos datos de entrada devuelven siempre los mismos números.
¿Puedo elegir el sistema de casas o un zodiaco sideral?
No. Todas las cartas son tropicales con casas Placidus, los mismos ajustes que usa la aplicación NatalChart.AI. Si necesitas Signos Enteros, Koch o un zodiaco sideral, esta no es la API adecuada.
¿Qué pasa si no se conoce la hora de nacimiento?
Envía time como null. Las posiciones se calculan para una hora supuesta de las 12:00, hora local, que la respuesta indica como assumedLocalTime, y lo que necesita la hora exacta se omite en lugar de adivinarse: los ángulos (Ascendente, Medio Cielo, Vértex, Parte de la Fortuna) y las cúspides de las casas llegan como null, y los cuerpos no llevan casa. Un aviso indica que la Luna puede desviarse hasta unos 7,5 grados y estar en el signo vecino; un cuerpo o un aspecto cerca del límite de un signo o de un orbe también puede ser distinto a la hora real.
¿Se geocodifican los nombres de lugares?
No. Envía la latitud y la longitud. La zona horaria se obtiene a partir de las coordenadas, con las reglas históricas de horario de verano de esa fecha, salvo que indiques tú una zona horaria IANA.
¿Se guardan los datos de nacimiento que envío?
No. El cuerpo de las solicitudes nunca se escribe en ningún sitio. El registro de solicitudes guarda el endpoint, el código de estado y la latencia, que es lo que necesita el contador de uso.
¿Qué cuenta como solicitud?
Una llamada completada con éxito a un endpoint de cálculo. Una solicitud rechazada por no ser válida no cuesta nada, un fallo por nuestra parte se devuelve al cupo y /v1/usage es gratis. El cupo es por cuenta, no por clave, y se renueva a las 00:00 UTC: 10 al día en el plan gratuito, 100 al día en Premium y sin límite diario en MAX.
¿Puedo usarla en un producto comercial?
Sí, con cualquier plan. Guarda tu clave en un servidor: una clave en el código de un navegador o de una aplicación la puede copiar cualquiera que lo abra.