API de revolución solar

Solicitud

Una solicitud real: la revolución de la carta de demostración en 2027, en el lugar de nacimiento.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

Respuesta

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

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

Qué devuelve

• exactMomentUtc: el momento en que el Sol vuelve a alcanzar su longitud natal, en UTC.
• location: dónde se levanta la carta; el lugar de nacimiento, salvo que envíes otro.
• natalSun: la longitud del Sol natal desde la que se mide la revolución.
• chart: la carta completa de ese momento y ese lugar, con la misma estructura que el endpoint de la carta natal.

Límites

• Solo con API Pro. Con la clave gratis, el endpoint responde con un 403 y un enlace para mejorar el plan.
• La hora de nacimiento es obligatoria.
• Zodiaco tropical y casas Placidus, los mismos ajustes que la carta natal.
• 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 la herramienta solar_return e interpretan el año por delante a partir de una carta calculada.

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