AstroWay/api v2.201.6 · es
todos los sistemas funcionando con normalidad
// astrology api · POST /v1/symbolic-directions

API de Direcciones de Arco Solar

El arco solar mueve todo el gráfico hacia adelante en un número: la distancia que el Sol ha recorrido por progresión secundaria. Cada planeta, cada cúspide y ambos ángulos se desplazan por ese mismo arco, por lo que un aspecto natal que estaba a dos grados de exacto llega a ser exacto unos dos años después. Este endpoint devuelve el gráfico dirigido y el arco que lo produjo.

Endpoint
POST /v1/symbolic-directions
Coste
50 créditos
Latencia
~50 ms
Nivel
Tier 3
// 01 / Qué calcula

API de Direcciones de Arco Solar

A partir de los datos de nacimiento y una fecha objetivo, el endpoint primero progrede el gráfico día por año, mide cuánto se ha movido el Sol progresado desde su posición natal y toma esa distancia como el arco. Luego suma el arco a cada longitud natal a la vez: todos los planetas, todas las cúspides de casas, el ascendente y el MC. La respuesta lleva las posiciones dirigidas bajo data.planets y data.houses, el arco mismo en grados bajo data.arc, y la clave que lo produjo bajo data.key. Como un solo arco se aplica uniformemente, la geometría del gráfico natal se conserva y solo cambia su relación con los grados natales, lo que hace que la técnica sea tan económica de leer: un número te dice el estado de todo el gráfico en una edad determinada. Hay otras dos claves disponibles en el mismo endpoint. Establece key en naibod para la tasa solar media de 59'08.3" por año, o omítela para el grado simple por año. Enviando converse true se dirige hacia atrás desde el momento del nacimiento en lugar de hacia adelante, invirtiendo el signo del arco.

// 02 / Solicitud en vivo

POST/v1/symbolic-directions

curl -X POST https://api.astroway.info/v1/symbolic-directions \
  -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,
  "targetDate": "2026-05-15",
  "key": "solar_arc"
}'
Respuesta (fragmento)
{
  "ok": true,
  "data": {
    "arc": 34.5083,
    "key": "solar_arc",
    "planets": [
      {
        "id": 0,
        "name": "Sun",
        "longitude": 88.8843,
        "isRetrograde": false
      }
    ],
    "houses": {
      "system": "P",
      "ascendant": 204.4763,
      "mc": 111.5826
    }
  }
}
// 03 / Parámetros

Parámetros

nametypeObligatorio
date string (YYYY-MM-DD) Birth date.
time string (HH:MM:SS) Local clock time at birth.
timezoneOffset number (hours) UTC offset in effect at the birth moment. Decimal allowed for half-hour zones.
latitude number Birth-place latitude, decimal degrees (north positive).
longitude number Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) The date the chart is directed to.
key string no Directional key: solar_arc (the arc of the progressed Sun), naibod (59'08.3" per year), or one_degree (the default, 1° per year).
converse boolean no Direct backwards from the birth moment instead of forwards. Reverses the sign of the arc.
// 04 / Cuándo usarlo

Cuándo usarlo

Recurre a las direcciones de arco solar cuando necesitas un timing simbólico en lugar de astronómico, y cuando quieres que esté en una forma que un lector pueda seguir. Como todo se mueve a una misma tasa, un contacto dirigido cae en un año específico en lugar de una ventana, lo que se adapta a una línea de vida, un informe de hitos por edad, o una narrativa de IA que tiene que decir de qué trata un año determinado. Se empareja naturalmente con las progresiones secundarias, ya que el arco se deriva del mismo Sol progresado: las progresiones te dan el gráfico interno en movimiento, las direcciones de arco solar te dan todo el gráfico traducido hacia adelante. Compara las tres claves cuando la precisión importa para tu audiencia. Las direcciones de arco solar siguen el Sol real y por eso varían ligeramente según la fecha de nacimiento, Naibod usa la tasa media, y un grado por año es la convención de número redondo. Para un nacimiento a mediados de mayo las tres salen en aproximadamente 34.5, 35.5 y 36.0 grados en 36 años, lo suficientemente cerca para acordar la década y lo suficientemente separadas para nombrar años diferentes.

// 05 / Notas

Notas

El arco es la distancia recorrida por el Sol progresado secundariamente, día por año, que es la definición estándar; la clave Naibod usa el movimiento diario medio del Sol, 59'08.3" por año. Para las direcciones de arco solar el gráfico progresado se calcula hacia adelante y la dirección del viaje se aplica una sola vez, por lo que las direcciones inversas devuelven el arco negado en lugar de duplicado. Las posiciones vienen del motor Swiss Ephemeris en el zodiaco tropical, en los mismos cuerpos y sistema de casas que los endpoints natales.

Prueba la API de Direcciones de Arco Solar

Consigue una clave y haz tu primera llamada en menos de un minuto.

99.9% SLA · planes de pago · 30 días estado →