API de sinastría

Solicitud

Una solicitud real para dos personas ficticias: el nacimiento de demostración en Kiev y un segundo nacimiento en Nueva York.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

Respuesta

Parte de la respuesta a esa solicitud: los campos principales, con cada lista recortada a sus tres primeros elementos.

{
  "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
  }
}

Qué devuelve

• aspects: cada aspecto mayor entre un cuerpo de una carta y un cuerpo de la otra, con su ángulo y su orbe.
• overlays: en qué casas de la carta de la otra persona caen los planetas de cada una, en los dos sentidos. Uno de los lados es null cuando se desconoce la hora de nacimiento de la otra persona, porque las casas dependen de ella.
• sphereScores: Identidad, Amor, Cuerpo, Dinero, Hogar y Mente, cada una de 0 a 100, a partir de los aspectos entre las cartas (60 %) y de las superposiciones de casas (40 %).
• scoring: la regla que hay detrás de las puntuaciones, indicada en la propia respuesta. Describe la geometría de dos cartas, no el futuro de una relación.

Límites

• Solo con API Pro. Con la clave gratis, el endpoint responde con un 403 y un enlace para mejorar el plan.
• Nacimientos de 1800 a 2399. Zodiaco tropical, casas Placidus, los cinco aspectos mayores.
• Sin geocodificación: envía coordenadas. La zona horaria se obtiene a partir de ellas, con las reglas de horario de verano de la fecha de nacimiento.
• Los datos de nacimiento se leen, se usan y se olvidan: el cuerpo de las solicitudes nunca se guarda.

En un asistente de IA

El servidor MCP de https://www.natalchart.ai/mcp ofrece el mismo cálculo como herramienta synastry, para que Claude, ChatGPT o Cursor puedan comparar dos cartas antes de hablar de compatibilidad.

El resto de la API

La misma clave da acceso a toda la API de astrología: cartas natales, tránsitos diarios, sinastría, tránsitos de un periodo, revoluciones solares, mejores días y astrocartografía. Todos los endpoints, campos y errores están en la documentación, y la página de precios explica qué cuenta como solicitud.

Preguntas