Shad Bala Summary - Free Astrology API

Overview

The Shadbala Summary API is designed to provide a summarized view of planetary strength according to the traditional Vedic astrology Shadbala system. Shadbala evaluates planetary strength through six components: 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).

A Shadbala summary helps developers present planetary strength information in a concise and accessible format within astrology applications. It can support birth chart analysis, planetary strength comparisons, and interfaces that explain how different strength components contribute to a planet's overall Shadbala assessment.

Use the birth date, time, geographical coordinates, and other parameters specified in the endpoint documentation to request a Shadbala summary. The API returns structured JSON data that can be integrated into websites, mobile applications, and Vedic astrology software.

Request Parameters

Parameter	Type	Required	Description	Example
`year`	integer	Yes	Year number, eg: 2023	2023
`month`	integer	Yes	Month number,with no leading zero	7
`date`	integer	Yes	Day number,with no leading zero	5
`hours`	integer	Yes	Hours number,with no leading zero	1
`minutes`	integer	Yes	Minutes number,with no leading zero	1
`seconds`	integer	Yes	Seconds number, with no leading zero	0
`latitude`	float	Yes	Latitude number, in the range from -90 to 90	12.86
`longitude`	float	Yes	Longitude number, in the range from -180 to 180	123.5
`timezone`	float	Yes	Timezone of birth location, eg: 5.5	5.5
📦 `config`	object	No	Contains optional configuration values
`ayanamsha`	string	No	Either "tropical" or "sayana" or "lahiri"	Either "tropical" or "sayana" or "lahiri"
`observation_point`	string	No	Geocentric positions are calculated with respect to the center of Earth. Topocentric positions are calculated with respect to the actual given place	Either "topocentric" or "geocentric"

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.

Response

{
    "statusCode": 200,
    "output": {
        "Sun": {
            "Shadbala": 385.767,
            "rupas": 6.429,
            "percentage_strength": 128.589,
            "ishta_phala": 8.741,
            "kashta_phala": 46.237
        },
        "Moon": {
            "Shadbala": 503.00756999999993,
            "rupas": 8.383,
            "percentage_strength": 139.724,
            "ishta_phala": 21.767,
            "kashta_phala": 36.33
        },
        "Mars": {
            "Shadbala": 339.70986,
            "rupas": 5.662,
            "percentage_strength": 113.237,
            "ishta_phala": 27.821,
            "kashta_phala": 30.401
        },
        "Mercury": {
            "Shadbala": 517.65929,
            "rupas": 8.628,
            "percentage_strength": 123.252,
            "ishta_phala": 36.016,
            "kashta_phala": 15.397
        },
        "Jupiter": {
            "Shadbala": 401.68171,
            "rupas": 6.695,
            "percentage_strength": 102.995,
            "ishta_phala": 38.846,
            "kashta_phala": 15.607
        },
        "Venus": {
            "Shadbala": 380.49514000000005,
            "rupas": 6.342,
            "percentage_strength": 115.302,
            "ishta_phala": 41.364,
            "kashta_phala": 16.801
        },
        "Saturn": {
            "Shadbala": 382.634429,
            "rupas": 6.377,
            "percentage_strength": 127.545,
            "ishta_phala": 37.131,
            "kashta_phala": 22.701
        }
    }
}

Code Examples

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

PHP Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/shadbala/summary',
  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;

Python Code

import requests
import json

url = "https://json.freeastrologyapi.com/shadbala/summary"

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)

Node JS Code

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/shadbala/summary',
  '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);
});