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.
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.
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"
}' {
"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
}
}
} Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | UTC offset in effect at the birth moment. Decimal allowed for half-hour zones. |
| latitude | number | sí | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sí | Birth-place longitude, decimal degrees (east positive). |
| targetDate | string (YYYY-MM-DD) | sí | 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. |
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.
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.