Find Chandrabalam and Tarabalam API

The Find Chandrabalam and Tarabalam API helps identify favorable and unfavorable lunar and stellar influences for specific days based on Indian astrology.
It provides insights into Chandrabalam (Moon Strength) and Tarabalam (Star Strength) to determine auspicious times for initiating important actions, rituals, or events.

Step-by-Step Find Chandrabalam and Tarabalam API Postman Testing Integration

For a detailed walkthrough on how to test this API using Postman, refer to the official support guide:

Step by Step Find Chandrabalam and Tarabalam API Postman Testing Integration
https://support.divineapi.com/indian-astrology-apis/testing-panchang-api-find-chandrabalam-and-tarabalam-api-using-postman

Supported Language Codes

You can receive the API response in multiple Indian languages by using the lan parameter in your request body.

Reference Article:
https://support.divineapi.com/general-api-support/translating-an-indian-vedic-apis-into-a-different-language

Code	Language
en	English
hi	Hindi
bn	Bengali
ma	Marathi
tm	Tamil
tl	Telugu
ml	Malayalam
kn	Kannada

Guide:
If the lan parameter is not specified, the default response language is English (en).

API Endpoint

POST https://astroapi-2.divineapi.com/indian-api/v2/find-chandrabalam-and-tarabalam

This endpoint returns current and upcoming Chandrabalam and Tarabalam periods for the given date and location.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `Bearer {token}`

Request Body

Name	Type	Required	Description
api_key	String	Yes	Your Divine API key.
day	Integer	Yes	Day of the Panchang. Example: `24`.
month	Integer	Yes	Month of the Panchang. Example: `05`.
year	Integer	Yes	Year of the Panchang. Example: `2023`.
place	String	No	Place name. Example: `New Delhi`.
lat	Float	Yes	Latitude of the place. Example: `28.6139`.
lon	Float	Yes	Longitude of the place. Example: `77.2090`.
tzone	Float	Yes	Timezone offset. Example: `5.5`. Refer to Timezone Guide.
lan	String	No	Language code as per the table above. Default is `en`.

200: OK Chandrabalm and Tarabalam fetched successfully

{
    "success": 1,
    "data": {
        "chandrabalams": {
            "current": [
                "Aries",
                "Gemini",
                "Leo",
                "Virgo",
                "Sagittarius",
                "Capricorn"
            ],
            "upto": "01:30 AM, Jul 24",
            "next": [
                "Taurus",
                "Cancer",
                "Virgo",
                "Libra",
                "Capricorn",
                "Aquarius"
            ]
        },
        "tarabalams": {
            "current": [
                "Ashwini",
                "Krittika",
                "Mrigashira",
                "Punarvasu",
                "Pushya",
                "Magha",
                "Uttara Phalguni",
                "Chitra",
                "Vishakha",
                "Anuradha",
                "Moola",
                "Uttara Ashada",
                "Dhanishta",
                "Purva Bhadrapada",
                "Uttara Bhadrapada"
            ],
            "upto": "08:25 AM, Jul 23",
            "next": [
                "Bharani",
                "Rohini",
                "Ardhra",
                "Pushya",
                "Ashlesha",
                "Purva Phalguni",
                "Hasta",
                "Swati",
                "Anuradha",
                "Jyeshtha",
                "Purva Ashada",
                "Shravan",
                "Satabhisha",
                "Uttara Bhadrapada",
                "Revati"
            ]
        }
    }
}

Response Field Description

success
Indicates whether the API request was successful. 1 means success.

data.chandrabalams
Contains current and next Moon Strength (Chandrabalam) information.

current: List of zodiac signs that currently have favorable lunar influence.

upto: The date and time until the current Chandrabalam remains effective.

next: List of zodiac signs that will be favorable in the upcoming lunar phase.

data.tarabalams
Contains current and next Star Strength (Tarabalam) information.

current: List of Nakshatras currently under favorable stellar influence.

upto: The date and time until the current Tarabalam remains effective.

next: List of Nakshatras that will be favorable in the next period.

Interpretation Guide

Chandrabalam (Moon Strength):
Represents the strength and auspiciousness derived from the Moon’s position relative to the individual’s zodiac sign. Favorable Chandrabalam indicates mental stability, success, and harmony in activities.

Tarabalam (Star Strength):
Denotes auspiciousness based on the individual’s birth Nakshatra (star). A favorable Tarabalam supports success, luck, and favorable outcomes for planned events.

Use Case:
This API can be used to power Panchang-based astrology applications, daily muhurta tools, or custom dashboards showing favorable lunar and stellar influences.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-2.divineapi.com/indian-api/v2/find-chandrabalam-and-tarabalam' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'place="New Delhi"' \
--form 'lat="28.6139"' \
--form 'lon="77.2090"' \
--form 'tzone="5.5"' \
--form 'lan="en"'

Node.js

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-2.divineapi.com/indian-api/v2/find-chandrabalam-and-tarabalam',
  'headers': {
    'Authorization': 'Bearer {Your Auth Token}'
  },
  formData: {
    'api_key': '{Your API Key}',
    'day': '24',
    'month': '05',
    'year': '2023',
    'Place': 'New Delhi',
    'lat': '28.6139',
    'lon': '77.2090',
    'tzone': '5.5',
    'lan': 'en'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

JavaScript (jQuery AJAX)

var form = new FormData();
form.append("api_key", "{Your API Key}");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("Place", "New Delhi");
form.append("lat", "28.6139");
form.append("lon", "77.2090");
form.append("tzone", "5.5");
form.append("lan", "en");

var settings = {
  "url": "https://astroapi-2.divineapi.com/indian-api/v2/find-chandrabalam-and-tarabalam",
  "method": "POST",
  "timeout": 0,
  "headers": {
    "Authorization": "Bearer {Your Auth Token}"
  },
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Python

import requests

url = "https://astroapi-2.divineapi.com/indian-api/v2/find-chandrabalam-and-tarabalam"

payload = {'api_key': '{Your API Key}',
'day': '24',
'month': '05',
'year': '2023',
'Place': 'New Delhi',
'lat': '28.6139',
'lon': '77.2090',
'tzone': '5.5',
'lan': 'en'}

headers = {
  'Authorization': 'Bearer {Your Auth Token}'
}

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

print(response.text)

Implementation Notes

Both Authorization (Bearer token) and api_key are mandatory.

Accurate lat, lon, and tzone values are essential for correct results.

Use this API for muhurta analysis, horoscope planning, and auspicious day recommendations.

The results change daily based on the Moon’s position and Nakshatra transitions.

Combine this API with other Panchang-based APIs for comprehensive astrological calculations.