API de Shadbala
Shadbala —literalmente «fuerza séxtuple»— es la forma clásica de cuantificar cuánto puede realmente cumplir un planeta con sus promesas en una carta. Este endpoint calcula la fuerza total de cada graha como la suma de sus seis balas constituyentes, devolviendo una puntuación por planeta en rupas para que puedas clasificar los planetas según con qué fuerza están posicionados para actuar.
API de Shadbala
A partir de la fecha, hora, desfase UTC y lugar de nacimiento, el endpoint deriva la carta sidérea mediante Swiss Ephemeris bajo el ayanamsa Lahiri, y luego calcula los seis componentes de fuerza para cada uno de los grahas clásicos. Sthana bala mide la fuerza posicional a partir de la ubicación por signo y divisional; Dig bala mide la fuerza direccional por la distancia del planeta a su ángulo ideal; Kala bala mide la fuerza temporal a partir de la hora de nacimiento; Cheshta bala mide la fuerza de movimiento a partir de la velocidad aparente y el estado retrógrado del planeta; Naisargika bala es la fuerza natural fija que cada planeta porta; y Drik bala mide la fuerza aspectual neta de los aspectos que recibe. Estas seis se suman en el Shadbala total, y la respuesta devuelve las cifras por planeta bajo data.items, cada una acompañada de su unidad para que las puntuaciones en rupas no sean ambiguas.
POST/v1/vedic/shadbala/full
curl -X POST https://api.astroway.info/v1/vedic/shadbala/full \
-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
}'{
"ok": true,
"data": {
"type": "shadbala",
"unit": "rupa",
"items": [
{
"planet": "Sun",
"total": 6.42,
"components": {
"sthana": 1.1,
"dig": 0.9,
"kala": 1.5,
"cheshta": 0.8,
"naisargika": 1,
"drik": 1.1
}
}
]
}
}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). |
Cuándo usarlo
Usa este endpoint siempre que una funcionalidad necesite ponderar un planeta frente a otro en lugar de solo localizarlo: evaluación de yogas, elección del planeta más fuerte para enfatizar en una lectura, o juzgar si un señor de dasha es lo bastante fuerte para cumplir los temas de su período. Se combina de forma natural con los endpoints de dasha y varga: extrae el planeta regente del período activo, y luego pregunta a Shadbala cuán capaz es realmente ese planeta. Como los seis componentes se calculan juntos en una sola llamada, obtienes el desglose completo de fuerza sin tener que coser búsquedas posicionales, direccionales y temporales por separado.
Notas
La respuesta reporta la fuerza en rupas (la unidad clásica, donde un rupa equivale a sesenta unidades shashtiamsha) y etiqueta cada valor con su unidad. El cálculo sigue el método estándar Graha-bala de la tradición de Parashara tal como se expone en el Bṛhat Parāśara Horā Śāstra, evaluado sobre la carta sidérea con el ayanamsa Lahiri. Las seis balas —Sthana, Dig, Kala, Cheshta, Naisargika y Drik— se devuelven sumadas en el total por planeta.
Prueba la API de Shadbala
Consigue una clave y haz tu primera llamada en menos de un minuto.