Retornos Solares y Lunares
Calculad el retorno solar (carta de cumpleaños) y las cartas de retorno lunar. Las cartas de retorno muestran las posiciones planetarias en el momento exacto en que un planeta regresa a su posición natal, proporcionando perspectiva de pronóstico para el año o mes siguiente.
Retorno Solar
La carta de retorno solar se calcula para el momento exacto en que el Sol regresa a su grado natal cada año, lo cual ocurre cerca del cumpleaños. Se utiliza para pronosticar los temas del año venidero.
Módulo Requerido
Requiere el módulo solar-return:calc.
bash
curl -X POST "https://api.astroapi.cloud/api/calc/solar-return" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"birthDateTime": "1990-06-15T14:30",
"birthLocation": {
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
},
"returnYear": 2024,
"houseSystem": "placidus",
"language": "en",
"includeText": true,
"includeReadableEntities": true
}'Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
birthDateTime | string | Sí | Fecha y hora de nacimiento en formato YYYY-MM-DDTHH:mm |
birthLocation | object | Sí | Lugar de nacimiento (ver Objeto de Ubicación más abajo) |
returnYear | number | No | Año del retorno solar (por defecto: año actual) |
houseSystem | string | No | Sistema de casas (por defecto: "placidus") |
language | string | No | Código de idioma para el contenido de texto (por defecto: "en") |
includeText | boolean | No | Incluir texto de interpretación (por defecto: false) |
includeReadableEntities | boolean | No | Incluir títulos legibles para los elementos (por defecto: false) |
points | array | No | Puntos celestes a incluir en el cálculo |
orbs | object | No | Valores de orbe personalizados por tipo de aspecto |
Objeto de Ubicación
json
{
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
}Respuesta
json
{
"data": {
"returnYear": 2024,
"returnDate": "2024-06-15T08:42:17Z",
"aspects": [
{
"point1": "sun",
"point2": "moon",
"aspect": "trine",
"orb": 1.8,
"applying": false
}
],
"points": {
"sun": {
"longitude": 84.71,
"latitude": 0.0,
"sign": "gemini",
"house": 10,
"retrograde": false
},
"moon": {
"longitude": 324.15,
"latitude": -2.3,
"sign": "aquarius",
"house": 6,
"retrograde": false
}
},
"houses": {
"1": { "cusp": 195.4, "sign": "libra" },
"10": { "cusp": 84.5, "sign": "gemini" }
},
"charts": {
"solarReturn": {
"title": "Solar Return Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"biWheel": {
"title": "Solar Return / Natal Bi-wheel",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"natal": {
"title": "Natal Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
}
}
}
}Campos de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
returnYear | number | El año de este retorno solar |
returnDate | string | Momento UTC exacto del retorno solar |
aspects | array | Aspectos dentro de la carta de retorno solar |
points | object | Posiciones planetarias en la carta de retorno solar |
houses | object | Cúspides de casas para la carta de retorno solar |
charts.solarReturn | object | URL de la imagen de la carta de retorno solar |
charts.biWheel | object | Bi-rueda mostrando el retorno solar superpuesto a la carta natal |
charts.natal | object | URL de la imagen de la carta natal |
Retorno Lunar
La carta de retorno lunar se calcula para el momento exacto en que la Luna regresa a su grado natal cada mes (aproximadamente cada 27,3 días). Se utiliza para pronosticar los temas del mes venidero.
Módulo Requerido
Requiere el módulo lunar-return:calc.
bash
curl -X POST "https://api.astroapi.cloud/api/calc/lunar-return" \
-H "X-Api-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"birthDateTime": "1990-06-15T14:30",
"birthLocation": {
"longitude": -0.1278,
"latitude": 51.5074,
"timezone": "Europe/London"
},
"returnDate": "2024-06-01",
"houseSystem": "placidus",
"language": "en",
"includeText": true,
"includeReadableEntities": true
}'Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
birthDateTime | string | Sí | Fecha y hora de nacimiento en formato YYYY-MM-DDTHH:mm |
birthLocation | object | Sí | Lugar de nacimiento (longitud, latitud, zona horaria) |
returnDate | string | No | Fecha de inicio (YYYY-MM-DD) desde la que encontrar el próximo retorno lunar (por defecto: ahora) |
houseSystem | string | No | Sistema de casas (por defecto: "placidus") |
language | string | No | Código de idioma para el contenido de texto (por defecto: "en") |
includeText | boolean | No | Incluir texto de interpretación (por defecto: false) |
includeReadableEntities | boolean | No | Incluir títulos legibles para los elementos (por defecto: false) |
points | array | No | Puntos celestes a incluir en el cálculo |
orbs | object | No | Valores de orbe personalizados por tipo de aspecto |
Respuesta
json
{
"data": {
"returnDate": "2024-06-12T03:18:44Z",
"aspects": [
{
"point1": "moon",
"point2": "venus",
"aspect": "sextile",
"orb": 0.9,
"applying": true
}
],
"points": {
"moon": {
"longitude": 245.2,
"latitude": -3.1,
"sign": "sagittarius",
"house": 4,
"retrograde": false
}
},
"houses": {
"1": { "cusp": 130.8, "sign": "leo" },
"4": { "cusp": 240.5, "sign": "sagittarius" }
},
"charts": {
"lunarReturn": {
"title": "Lunar Return Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"biWheel": {
"title": "Lunar Return / Natal Bi-wheel",
"url": "https://api.astroapi.cloud/api/chart/..."
},
"natal": {
"title": "Natal Chart",
"url": "https://api.astroapi.cloud/api/chart/..."
}
}
}
}Campos de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
returnDate | string | Momento UTC exacto del retorno lunar |
aspects | array | Aspectos dentro de la carta de retorno lunar |
points | object | Posiciones planetarias en la carta de retorno lunar |
houses | object | Cúspides de casas para la carta de retorno lunar |
charts.lunarReturn | object | URL de la imagen de la carta de retorno lunar |
charts.biWheel | object | Bi-rueda mostrando el retorno lunar superpuesto a la carta natal |
charts.natal | object | URL de la imagen de la carta natal |
Sistemas de Casas
Ambos endpoints admiten los mismos sistemas de casas que los cálculos de carta natal:
| Valor | Nombre |
|---|---|
placidus | Placidus (por defecto) |
koch | Koch |
equal | Casas Iguales |
whole | Signo Completo |
campanus | Campanus |
regiomontanus | Regiomontanus |
porphyry | Porphyry |
Ubicación para las Cartas de Retorno
Muchos astrólogos utilizan la ubicación donde la persona se encuentra físicamente en el momento del retorno, en lugar del lugar de nacimiento. Pasad la residencia actual o el lugar de viaje en birthLocation si queréis cartas de retorno relativas a la ubicación actual.