API de Proyecciones Anuales
Las proyecciones anuales son la técnica de temporización más simple del conjunto helenístico y una de las más usadas: la carta avanza una casa por cada año de vida, y el gobernante del signo en esa casa se vuelve el señor del año. Un número entra, un planeta sale, y todo el año tiene una firma.
API de Proyecciones Anuales
El endpoint recibe los datos de nacimiento y una fecha objetivo, cuenta los años completados desde el momento del nacimiento y avanza un signo completo desde el ascendente por cada uno de ellos. La respuesta informa la edad contada, el índice cero-basado del signo en el que cae el año, y el planeta que rige ese signo como lordOfYear, junto con el ascendente natal, MC, Sun y Moon para que puedas representar el año en la carta sin una segunda llamada. El número de casa se deduce directamente de la edad: el ciclo dura doce años, así que la casa profectada es la edad módulo doce, más uno. Con 36 años vuelve a la primera casa y, por tanto, al propio signo del ascendente, por eso la muestra de carta, con un ascendente a 169.97 grados en Virgo, reporta signIndex 5 y Mercury como el señor de ese año. Como el recuento parte del momento del nacimiento y no del calendario, el año de proyección cambia en el birthday y no el primero de enero.
POST/v1/profections
curl -X POST https://api.astroway.info/v1/profections \
-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"
}'{
"ok": true,
"data": {
"age": 36,
"signIndex": 5,
"lordOfYear": "Mercury",
"ascendant": 169.9680,
"mc": 77.0743,
"sun": 54.3760,
"moon": 296.9047
}
}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. |
| 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 whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1. |
Cuándo usarlo
Usa proyecciones cuando necesites una capa de temporización que el lector pueda seguir sin ephemeris. Cada año tiene un planeta gobernante, así que puedes crear un pronóstico anual, un informe de birthday o una AI narrative alrededor de una única afirmación clara en lugar de una tabla de transits. Se combina especialmente bien con transits y returns: encuentra aquí el lord of the year, luego mira qué le ocurre a ese planeta por transit, y tendrás la classical two-step reading en dos llamadas. También combina con el solar return, que cubre el mismo año desde otro ángulo. La técnica es deliberadamente gruesa. Te dice qué department of life se activa y quién está a cargo, no lo que ocurre en una tarde concreta, así que trátala como el frame donde cuelgas finer timing.
Notas
Proyecciones de signo completo desde el ascendant, un signo por año completado, con los gobernantes de domicilio tradicionales proporcionando el lord of the year. Las edades se cuentan desde el birth moment, así que el año cambia en el birthday. El ascendant natal, MC, Sun y Moon provienen del motor Swiss Ephemeris en el tropical zodiac y se devuelven en degrees.
Prueba la API de Proyecciones Anuales
Consigue una clave y haz tu primera llamada en menos de un minuto.