Shadbala (a força sêxtupla dos planetas)

Shadbala (षड्बल, “seis forças”) é a métrica védica clássica para “quão forte é um planeta num mapa concreto”. A força calcula-se como a soma de seis componentes. As componentes e totalVirupa vêm em virupa, e ao lado devolvemos totalRupa (1 rupa = 60 virupa). O resultado é um número objetivo para comparar planetas, ordenar os regentes das dashas e avaliar a qualidade dos yogas. A AstroWay expõe as 6 componentes em separado + ambos os totais.

O que calculamos

As seis forças segundo o Brihat Parashara Hora Shastra (BPHS), capítulo 27, “Grahabala-adhyaya”:

• Sthana Bala (sthāna, “posicional”): força pela posição no signo, na navamsha e nas vargas, composta por 5 subcomponentes (Uchcha Bala, Saptavargaja Bala, Ojha-Yugma Bala, Kendradi Bala, Drekkana Bala).
• Dig Bala (“direcional”): Júpiter/Mercúrio são fortes a leste, Lua/Vénus a norte, Saturno a oeste, Sol/Marte a sul.
• Kala Bala (“temporal”): 9 subcomponentes: Nathonnatha, Paksha, Tribhaga, Abda/Masa/Vara/Hora, Ayana, Yuddha. Depende da hora do dia, do dia da semana, do mês, do ano e da guerra planetária.
• Cheshta Bala (“de movimento”): a velocidade do planeta vs a velocidade média. Os planetas retrógrados recebem o máximo; os muito lentos (estações) também pontuam alto.
• Naisargika Bala (“natural”): uma escala fixa: Sol 60, Lua 51.43, Vénus 42.85, Júpiter 34.28, Mercúrio 25.71, Marte 17.14, Saturno 8.57 virupa.
• Drik Bala (“de aspeto”): a soma dos aspetos recebidos/dados por outros planetas, ponderada pela orbe e pela natureza.

O total: Total Bala = Sthana + Dig + Kala + Cheshta + Naisargika + Drik. É comparado com a Required Bala (o limiar mínimo de força, per BPHS Table 27.1): um planeta é “suficientemente forte” se Total ≥ Required.

Endpoints

Endpoint	Créditos	O que devolve
/v1/vedic/shadbala/sthana	20	Sthana Bala + 5 subcomponentes para 7 planetas
/v1/vedic/shadbala/dig	20	Dig Bala (força direcional)
/v1/vedic/shadbala/kala	20	Kala Bala + 9 subcomponentes
/v1/vedic/shadbala/cheshta	20	Cheshta Bala (com velocidade e estado retrógrado)
/v1/vedic/shadbala/naisargika	20	Naisargika (tabela fixa)
/v1/vedic/shadbala/drik	20	Drik Bala (soma de aspetos)
/v1/vedic/shadbala/full	20	Todas as 6 + total + rácio face à Required Bala

Exemplo

cURL

curl -X POST https://api.astroway.info/v1/vedic/shadbala/full \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "ayanamsa": "lahiri"
  }'

Node.js

const r = await fetch('https://api.astroway.info/v1/vedic/shadbala/full', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
    latitude: 50.45, longitude: 30.52, ayanamsa: 'lahiri',
  }),
});
const { data } = await r.json();
const strongest = data.items.reduce((a, b) => (b.totalRupa > a.totalRupa ? b : a));
console.log(`Strongest planet: ${strongest.planetName} (${strongest.totalRupa.toFixed(2)} rupa)`);

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/shadbala/full',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14', 'time': '14:30:00', 'timezoneOffset': 3,
        'latitude': 50.45, 'longitude': 30.52, 'ayanamsa': 'lahiri',
    },
)
data = r.json()['data']
for p in sorted(data['items'], key=lambda x: -x['totalRupa']):
    print(f"{p['planetName']:8s} {p['totalRupa']:6.2f} rupa  ({p['totalVirupa']:8.2f} virupa)")

Exemplo de resposta

{
  "type": "shadbala-summary",
  "unit": "virupa",
  "items": [
    {
      "planet": 0,
      "planetName": "Sun",
      "sthana": 135.235432,
      "dig": 53.046192,
      "kala": 248.856213,
      "cheshta": 0,
      "naisargika": 60,
      "drik": -15,
      "totalVirupa": 482.137837,
      "totalRupa": 8.035631
    },
    {
      "planet": 1,
      "planetName": "Moon",
      "sthana": 209.110876, "dig": 41.190833, "kala": 100.903909, "cheshta": 0,
      "naisargika": 51.43, "drik": 0, "totalVirupa": 402.635619, "totalRupa": 6.710594
    }
  ]
}

Precisão e fontes

• Texto canónico: Brihat Parashara Hora Shastra (BPHS), capítulo 27: as fórmulas das seis balas e as tabelas de Required Bala.
• Reference implementation: PyJHora (Apache 2.0), módulo shadbala.py. Os nossos números coincidem com o PyJHora dentro de ±0.05 rupa em todas as componentes exceto a Drik Bala (aí usam-se orbes de aspeto ligeiramente diferentes: nós usamos a variante completa do BPHS, o PyJHora uma simplificada).
• Status: GREEN para Sthana/Dig/Kala/Cheshta/Naisargika, YELLOW para Drik (por causa da diferença nas orbes). Detalhes em /accuracy/.
• Ayanamsa: as mesmas 9 opções que nos restantes cálculos védicos (Lahiri por omissão).
• A Kala Bala é complexa. As 9 subcomponentes exigem a hora exata de sunrise/sunset para a localização dada; confirma que latitude/longitude/timezoneOffset estão corretos.

Cuidado

A Shadbala não é um oráculo. Uma força elevada não significa “bons acontecimentos”, significa “o planeta vai manifestar-se ativamente”. Um planeta fraco com um yoga pode dar melhores frutos do que um forte sem ele. Usa a Shadbala como um dos dados de entrada da análise, não como o único preditor.

Relacionado

• Dashas: a Shadbala é fundamental para avaliar o regente da dasha atual
• Panchang: o momento de cálculo da Kala Bala depende de tithi/vara
• Vargas: a Saptavargaja Bala (subcomponente da Sthana) baseia-se em 7 divisional charts
• Precisão: auditoria detalhada das componentes e do desvio vs PyJHora
• Créditos: tabela completa de preços
• Autenticação: como obter uma chave aw_live_*