AstroWay/api v2.95.1 · astrology-api
all systems operational
// astrology api · POST /v1/vedic/shadbala/full

Shadbala API

Shadbala — literally 'six-fold strength' — is the classical way to quantify how much a planet can actually deliver on its promises in a chart. This endpoint computes each graha's total strength as the sum of its six constituent balas, returning a per-planet score in rupas so you can rank the planets by how strongly they are positioned to act.

Endpoint
POST /v1/vedic/shadbala/full
Cost
50 credits
Latency
~72 ms
Tier
Tier 3
// 01 / What it computes

Shadbala API

From the birth date, time, UTC offset, and place, the endpoint derives the sidereal chart via the Swiss Ephemeris under the Lahiri ayanamsa, then computes the six strength components for each of the classical grahas. Sthana bala measures positional strength from sign and divisional placement; Dig bala measures directional strength by the planet's distance from its ideal angle; Kala bala measures temporal strength from the time of birth; Cheshta bala measures motional strength from the planet's apparent speed and retrograde state; Naisargika bala is the fixed natural strength each planet carries; and Drik bala measures the net aspectual strength from the aspects it receives. These six are summed into the total Shadbala, and the response returns the per-planet figures under data.items, each accompanied by its unit so the rupa scores are unambiguous.

// 02 / Live request

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
}'
Response (excerpt)
{
  "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
        }
      }
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
// 04 / When to use it

When to use it

Use this endpoint whenever a feature needs to weigh one planet against another rather than just locate it — yoga assessment, choosing the strongest planet to emphasize in a reading, or judging whether a dasha lord is strong enough to deliver its period's themes. It pairs naturally with the dasha and varga endpoints: pull the active period's ruling planet, then ask Shadbala how capable that planet actually is. Because the six components are computed together in one call, you get the full strength breakdown without stitching together separate positional, directional, and temporal lookups.

// 05 / Notes

Notes

The response reports strength in rupas (the classical unit, where one rupa equals sixty shashtiamsha units) and labels each value with its unit. The computation follows the standard Graha-bala method from the Parashara tradition as set out in the Bṛhat Parāśara Horā Śāstra, evaluated on the sidereal chart with the Lahiri ayanamsa. All six balas — Sthana, Dig, Kala, Cheshta, Naisargika, and Drik — are returned summed into the per-planet total.

Try the Shadbala API

Grab a key and make your first call in under a minute.

99.9% SLA · paid plans · 30d status →