API de tránsitos

El endpoint transits toma los datos natales de una persona —fecha de nacimiento, hora, desfase UTC, latitud, longitud y sistema de casas— y un momento objetivo separado. Resuelve esa fecha objetivo y hora del reloj a un día juliano, solicita al motor Swiss Ephemeris la longitud, latitud y velocidad geocéntricas de cada cuerpo en tránsito, y luego proyecta esas posiciones en las casas derivadas de la ubicación natal. La respuesta lleva los planetas en tránsito con sus signos y posiciones por casa, las cúspides de casas natales, y la malla completa de aspectos calculada entre los propios cuerpos en tránsito, cada uno con indicadores de aplicación o separación y orbes exactos. También devuelve aspectos de paralelo y antiscia (punto espejo) para el trabajo de declinación y de eje solsticial. El movimiento retrógrado se señala a partir de la velocidad del cuerpo, de modo que puedas ver qué tránsitos están directos, estacionarios o moviéndose hacia atrás en el momento solicitado.

curl -X POST https://api.astroway.info/v1/transits \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "transitDate": "2026-06-15",
  "transitTime": "12:00:00",
  "transitTzOffset": 3
}'

{
  "ok": true,
  "data": {
    "input": {},
    "julianDay": 2461206.875,
    "planets": [
      {
        "name": "Sun",
        "longitude": 84.29,
        "sign": "Gemini",
        "house": 11
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      {
        "planet1": "Sun",
        "planet2": "Moon",
        "type": "conjunction",
        "orb": 1.2,
        "applying": true
      }
    ],
    "parallelAspects": [
      "…"
    ],
    "antiscia": [
      "…"
    ]
  }
}

Usa esto cuando quieras todo el cielo tal como se sitúa sobre la carta de alguien en un día dado: un widget de tránsitos diarios, un panel tipo «meteorología» de «qué hay sobre nuestras cabezas ahora», o el marco en bruto que un agente de IA lee antes de describir el clima astrológico actual. Como devuelve la carta de tránsitos sobre el marco de casas natales en lugar de una lista curada de contactos tránsito-a-natal, es la llamada correcta cuando necesitas la instantánea estructural en sí. Si en cambio quieres impactos tránsito-a-natal con fechas, barridos a lo largo de un rango de fechas —fechas exactas, ingresos, puntos estacionarios—, recurre al endpoint /transit-calendar, que está construido para esa tarea de cómputo de fechas. Combina ambos: este endpoint para la carta del momento puntual, el calendario para la lista de eventos a futuro.

Sé preciso con el alcance: esto devuelve la carta de tránsitos superpuesta sobre el marco de casas natales, no una lista prefiltrada de aspectos tránsito-a-natal. La malla de aspectos se calcula entre los cuerpos en tránsito, no entre los puntos en tránsito y los natales. Para el cómputo de fechas a-natal a lo largo de un rango de fechas, usa /transit-calendar. Las casas siguen el sistema natal que elijas; zodíaco tropical y Swiss Ephemeris en todo momento.