API de astrocartografía

Solicitud

Una solicitud real: la carta de demostración frente a Lisboa.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

Respuesta

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

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

Qué devuelve

• relocated: el Ascendente y el Medio Cielo que tiene la carta en ese lugar.
• angularPlanets: los planetas sobre esos ángulos, cada uno con su ángulo, su orbe y su fuerza.
• spheres: Identidad, Amor, Cuerpo, Dinero, Hogar y Mente, cada una de 0 a 10, con 5 como valor neutral; overall10 las resume.
• strength: 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. Las reglas vienen con la respuesta.
• POST /v1/locations/rank devuelve las mejores ciudades del catálogo, según las seis esferas o las que elijas, en todo el mundo o en una región.

Límites

• Solo con API Pro. Con la clave gratis, los dos endpoints responden con un 403 y un enlace para mejorar el plan.
• La hora de nacimiento es obligatoria: la relocalización mueve los ángulos, y los ángulos necesitan la hora.
• La clasificación compara 61 grandes ciudades, no todos los lugares de la Tierra; cualquier otro lugar se puede puntuar con POST /v1/locations/score.
• Los datos de nacimiento se leen, se usan y se olvidan: el cuerpo de las solicitudes nunca se guarda.

En un asistente de IA

A través del servidor MCP de https://www.natalchart.ai/mcp, los asistentes llaman a location_score para un lugar y a best_cities para las mejores ciudades.

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