API de tránsitos

Solicitud

Una solicitud real con la carta de demostración, para un periodo de un mes:

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

Respuesta

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

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

Qué devuelve

• window: las fechas que pediste.
• events: hasta 60 aspectos exactos de los cuerpos en tránsito con los natales, ingresos en signos y estaciones, en orden cronológico, cada uno con su momento en UTC, su posición y las casas implicadas. Cuando un periodo tiene más, se conservan los más importantes.
• activeOnFirstDay: los tránsitos que ya están dentro de orbe el primer día, con los orbes utilizados.
• Cada evento indica su importancia (alta, media o baja), que depende de los cuerpos implicados.

Límites

• Solo con API Pro, con un máximo de 92 días y 60 eventos por solicitud. Con la clave gratis, el endpoint responde con un 403 y un enlace para mejorar el plan.
• Nacimientos de 1800 a 2399. Las casas de un tránsito necesitan la hora de nacimiento; sin ella, se omiten.
• Cada momento exacto se busca con Swiss Ephemeris y se da en UTC.
• 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 transits para un periodo y a daily_transits para un solo día, y leen tránsitos reales en lugar de adivinarlos.

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