Sthana Bala part in Shad Bala - Free Astrology API

Overview

The Sthana Bala API focuses on positional strength, one of the six components of the traditional Vedic astrology Shadbala system. Sthana Bala evaluates a planet's strength based on its position in the birth chart, considering factors such as exaltation, divisional chart placement, and other positional relationships according to the calculation method used.

Sthana Bala is an important component of planetary strength analysis and can help developers present how planetary positions contribute to a planet's overall Shadbala assessment. This information can be incorporated into planetary strength tables, horoscope interpretation tools, and detailed Vedic astrology reports.

Use the birth details and configuration parameters specified in the endpoint documentation to request Sthana Bala calculations. The API returns structured JSON data for integration 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": {
            "sthana_bala": 167.17000000000002,
            "uchcha": 17.17,
            "saptaVargaja": 120.0,
            "ojaYugmaRasymsa": 15,
            "kendra": 15,
            "drekkana": 0,
            "rupas": 2.79
        },
        "Moon": {
            "sthana_bala": 206.21,
            "uchcha": 48.71,
            "saptaVargaja": 52.5,
            "ojaYugmaRasymsa": 30,
            "kendra": 60,
            "drekkana": 15,
            "rupas": 3.44
        },
        "Mars": {
            "sthana_bala": 145.31,
            "uchcha": 17.81,
            "saptaVargaja": 67.5,
            "ojaYugmaRasymsa": 0,
            "kendra": 60,
            "drekkana": 0,
            "rupas": 2.42
        },
        "Mercury": {
            "sthana_bala": 161.9,
            "uchcha": 53.15,
            "saptaVargaja": 78.75,
            "ojaYugmaRasymsa": 15,
            "kendra": 15,
            "drekkana": 0,
            "rupas": 2.7
        },
        "Jupiter": {
            "sthana_bala": 158.04,
            "uchcha": 34.29,
            "saptaVargaja": 63.75,
            "ojaYugmaRasymsa": 0,
            "kendra": 60,
            "drekkana": 0,
            "rupas": 2.63
        },
        "Venus": {
            "sthana_bala": 141.815,
            "uchcha": 23.69,
            "saptaVargaja": 58.125,
            "ojaYugmaRasymsa": 30,
            "kendra": 30,
            "drekkana": 0,
            "rupas": 2.36
        },
        "Saturn": {
            "sthana_bala": 243.49,
            "uchcha": 25.99,
            "saptaVargaja": 172.5,
            "ojaYugmaRasymsa": 30,
            "kendra": 15,
            "drekkana": 0,
            "rupas": 4.06
        }
    }
}

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/sthana-bala',
  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": 1993,
  "month": 9,
  "date": 5,
  "hours": 0,
  "minutes": 30,
  "seconds": 0,
  "latitude": 17.3833333,
  "longitude": 78.46666,
  "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/sthana-bala"

payload = json.dumps({
  "year": 1993,
  "month": 9,
  "date": 5,
  "hours": 0,
  "minutes": 30,
  "seconds": 0,
  "latitude": 17.3833333,
  "longitude": 78.46666,
  "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/sthana-bala',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 1993,
    "month": 9,
    "date": 5,
    "hours": 0,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.3833333,
    "longitude": 78.46666,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "lahiri"
    }
  })

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