Kaala Bala part in Shad Bala
Calculate Kaala Bala (temporal strength), one of the six components of Shadbala in Vedic astrology. Retrieve the total Kaala Bala and its individual components for the seven classical planets to build detailed planetary strength analysis and horoscope interpretation features.
Overview
The Kaala Bala API calculates the temporal strength of the seven classical planets as part of the traditional Vedic astrology Shadbala system. Kaala Bala evaluates planetary strength based on time-related factors, including Natonnata Bala, Paksha Bala, Tribhaga Bala, Abda Bala, Maasa Bala, Vaara Bala, Hora Bala, Aayana Bala, and Yuddha Bala.
The API returns the total Kaala Bala for each planet, along with its individual components and the corresponding strength in Rupas. The response includes results for the Sun, Moon, Mars, Mercury, Jupiter, Venus, and Saturn. Developers can use this data to display detailed planetary strength breakdowns and integrate temporal strength calculations into Vedic astrology applications.
To calculate Kaala Bala, provide the birth year, month, date, time, latitude, longitude, and timezone. Optional configuration settings allow you to select an Ayanamsha, such as Lahiri or Sayana, and choose a geocentric or topocentric observation point. 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.
{
"statusCode": 200,
"output": {
"Sun": {
"kaala_bala": 124.78699999999999,
"natonnata": 56.507,
"paksha": 58.352,
"triBhaga": 0,
"abda": 0,
"maasa": 0,
"vaara": 0,
"hora": 0,
"aayana": 9.928,
"yuddha": 0,
"rupas": 2.08
},
"Moon": {
"kaala_bala": 176.53799999999998,
"natonnata": 3.493,
"paksha": 116.704,
"triBhaga": 0,
"abda": 0,
"maasa": 0,
"vaara": 0,
"hora": 0,
"aayana": 56.341,
"yuddha": 0,
"rupas": 2.94
},
"Mars": {
"kaala_bala": 180.949,
"natonnata": 3.493,
"paksha": 58.352,
"triBhaga": 0,
"abda": 0,
"maasa": 0,
"vaara": 0,
"hora": 60,
"aayana": 59.104,
"yuddha": 0,
"rupas": 3.02
},
"Mercury": {
"kaala_bala": 248.676,
"natonnata": 60,
"paksha": 58.352,
"triBhaga": 60,
"abda": 15,
"maasa": 0,
"vaara": 0,
"hora": 0,
"aayana": 55.324,
"yuddha": 0,
"rupas": 4.14
},
"Jupiter": {
"kaala_bala": 140.804,
"natonnata": 56.507,
"paksha": 1.648,
"triBhaga": 60,
"abda": 0,
"maasa": 0,
"vaara": 0,
"hora": 0,
"aayana": 22.649,
"yuddha": 0,
"rupas": 2.35
},
"Venus": {
"kaala_bala": 157.798,
"natonnata": 56.507,
"paksha": 1.648,
"triBhaga": 0,
"abda": 0,
"maasa": 30,
"vaara": 45,
"hora": 0,
"aayana": 24.643,
"yuddha": 0,
"rupas": 2.63
},
"Saturn": {
"kaala_bala": 111.16,
"natonnata": 3.493,
"paksha": 58.352,
"triBhaga": 0,
"abda": 0,
"maasa": 0,
"vaara": 0,
"hora": 0,
"aayana": 49.315,
"yuddha": 0,
"rupas": 1.85
}
}
}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/kaala-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": 1,
"date": 22,
"hours": 13,
"minutes": 20,
"seconds": 0,
"latitude": 30.37,
"longitude": 75.86,
"timezone": 5.5,
"config": {
"observation_point": "geocentric",
"ayanamsha": "sayana"
}
}',
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/kaala-bala"
payload = json.dumps({
"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"
}
})
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/kaala-bala',
'headers': {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY_HERE'
},
body: JSON.stringify({
"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"
}
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});