Shad Bala Break-up

Overview

The Shadbala Break-up API calculates the six components of planetary strength for the seven classical planets in a birth chart: Sun, Moon, Mars, Mercury, Jupiter, Venus, and Saturn. In Vedic astrology, Shadbala is a traditional system for assessing planetary strength using six measures: Sthana Bala (positional strength), Dig Bala (directional strength), Kala Bala (temporal strength), Chesta Bala (motional strength), Naisargika Bala (natural strength), and Drik Bala (aspectual strength).

The API returns a separate breakdown for each of the seven planets, with numerical values for all six strength components. These values are expressed in Shadbala units called Rupas or related strength measures, as represented by the API response. Developers can use the results to build planetary strength tables, comparison charts, and detailed Vedic horoscope analysis interfaces.

To calculate the Shadbala breakdown, provide the birth year, month, date, time, latitude, longitude, and timezone. Optional configuration settings allow you to choose an Ayanamsha, such as Lahiri, Sayana, or Tropical, and select a geocentric or topocentric observation point. The API returns the results in JSON format for integration into websites, mobile applications, and Vedic astrology software.

Request Parameters

Request Example

{
  "year": 1993,
  "month": 1,
  "date": 22,
  "hours": 13,
  "minutes": 20,
  "seconds": 0,
  "latitude": 30.37,
  "longitude": 75.86,
  "timezone": 5.5,
  "config": {
    "observation_point": "geocentric",
    "ayanamsha": "sayana"
  }
}
    

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "output": {
        "Sun": {
            "sthana": 205.95,
            "kaala": 74.799,
            "dig_balam": 27.296,
            "chesta": 3.442,
            "drik_balam": 14.28,
            "naisargika": 60
        },
        "Moon": {
            "sthana": 135.22,
            "kaala": 255.397,
            "dig_balam": 48.383,
            "chesta": 15.679,
            "drik_balam": -3.1,
            "naisargika": 51.429
        },
        "Mars": {
            "sthana": 185.99,
            "kaala": 77.528,
            "dig_balam": 37.513,
            "chesta": 21.506,
            "drik_balam": 0.03,
            "naisargika": 17.143
        },
        "Mercury": {
            "sthana": 123.685,
            "kaala": 252.349,
            "dig_balam": 52.143,
            "chesta": 53.358,
            "drik_balam": 10.41,
            "naisargika": 25.714
        },
        "Jupiter": {
            "sthana": 207.785,
            "kaala": 164.29,
            "dig_balam": 0.991,
            "chesta": 28.93,
            "drik_balam": -34.6,
            "naisargika": 34.286
        },
        "Venus": {
            "sthana": 188.94,
            "kaala": 50.931,
            "dig_balam": 41.355,
            "chesta": 48.622,
            "drik_balam": 7.79,
            "naisargika": 42.857
        },
        "Saturn": {
            "sthana": 187.495,
            "kaala": 134.126,
            "dig_balam": 4.463,
            "chesta": 35.019,
            "drik_balam": 12.96,
            "naisargika": 8.571
        }
    }
}

Code Examples

Use the following examples to integrate this API into your application.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/shadbala/break-up',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 1990,
    "month": 1,
    "date": 1,
    "hours": 6,
    "minutes": 0,
    "seconds": 0,
    "latitude": 13.08333,
    "longitude": 80.283333,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric",
        "ayanamsha": "lahiri"
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "https://json.freeastrologyapi.com/shadbala/break-up"

payload = json.dumps({
  "year": 1990,
  "month": 1,
  "date": 1,
  "hours": 6,
  "minutes": 0,
  "seconds": 0,
  "latitude": 13.08333,
  "longitude": 80.283333,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "lahiri"
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/shadbala/break-up',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1990,
    "month": 1,
    "date": 1,
    "hours": 6,
    "minutes": 0,
    "seconds": 0,
    "latitude": 13.08333,
    "longitude": 80.283333,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "lahiri"
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});