API de revolución solar
Levanta la carta para el instante exacto en que el Sol vuelve a su grado natal en un año elegido: el cumpleaños astrológico. Pasa una carta natal y un año, obtén la carta de revolución solar de ese ciclo. Tropical, Sol-a-Sol-natal, precisión de Swiss Ephemeris, salida en JSON.
API de revolución solar
El endpoint solar-return primero lee la longitud zodiacal exacta del Sol natal a partir de los datos de nacimiento suministrados, y luego busca en el año dado el momento preciso en que el Sol en tránsito vuelve a esa misma longitud, típicamente dentro de un día más o menos respecto al cumpleaños del calendario. Resuelve ese instante de retorno a un día juliano, extrae las posiciones y velocidades geocéntricas del motor Swiss Ephemeris y levanta una carta completa para él: los planetas del retorno con signos y posiciones por casa, las cúspides de casas y la malla completa de aspectos con indicadores de aplicación y separación y orbes exactos. La coincidencia es tropical y Sol-a-Sol-natal, no corregida por precesión de forma predeterminada, de modo que el Sol del retorno se sitúa sobre el grado tropical del Sol natal. La carta resultante se lee como el mapa temático dominante del año que va de un cumpleaños al siguiente.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-return \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}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 (e.g. 3 for Kyiv summer time). 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). |
| year | number | sí | Required integer year in which to find the Sun's return to its natal longitude. |
Cuándo usarlo
Usa la revolución solar para la previsión anual: un informe de «el año que viene», una funcionalidad de carta de cumpleaños, o un flujo de IA que construya una perspectiva de doce meses a partir de una única carta fechada. Es el caballo de batalla de la predicción basada en retornos: los ángulos, la casa en la que cae el Sol del retorno y los aspectos más ajustados se leen como los temas principales de ese año solar. Combínala con tránsitos y progresiones para mayor profundidad, pero la revolución solar por sí sola ofrece una instantánea anual limpia y autocontenida, anclada al propio cumpleaños de la persona en lugar de al calendario. Como solo pasas datos natales más un año, encaja perfectamente en disparadores por aniversario y en correos anuales programados: recalcula cada año para hacer avanzar la previsión.
Notas
El retorno se ajusta tropicalmente, Sol a Sol natal, y no está corregido por precesión de forma predeterminada, de modo que refleja la revolución solar occidental convencional en lugar de la variante corregida sidéreamente. Se levanta para la ubicación natal suministrada; las revoluciones solares relocalizadas requerirían levantarla en un lugar distinto. Zodíaco tropical y Swiss Ephemeris en todo momento.
Prueba la API de Revolución solar
Consigue una clave y haz tu primera llamada en menos de un minuto.