Fixed Stars Details
The Fixed Stars API returns detailed positional and classification data for the fixed stars you request. Typically, you first call the Fixed Stars List API to know which star identifiers are available, and then you pass those identifiers to this endpoint to retrieve their positions within the natal chart context.
Supported Language Codes
| Code | Language |
|---|---|
| en | English |
| hi | Hindi |
| pt | Portuguese |
| fr | French |
| de | German |
| ja | Japanese |
| tr | Turkish |
| ru | Russian |
| it | Italian |
| es | Spanish |
| nl | Dutch |
| pl | Polish |
Guide: These languages are supported by this API. You can use them by passing the lan field in the request body. Default is en.
House System Codes
Support Article URL:
https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology
| Code | House System Name |
|---|---|
| P | Placidus |
| K | Koch |
| R | Regiomontanus |
| C | Campanus |
| A | Equal |
| W | Equal, Whole Sign |
| N | Whole Sign, Aries = 1st House |
| X | Axial Rotation System / Meridian Houses |
| T | Polich/Page (“Topocentric”) |
| M | Morinus |
| O | Porphyry |
| B | Alcabitius |
| D | Equal / MC |
| E | Equal = A |
| F | Carter Poli-Equatorial |
| G | 36 Gauquelin Sectors |
| H | Horizon / Azimuth |
| I | Sunshine |
| i | Sunshine (Alternative) |
| L | Pullen S-Delta |
| Q | Pullen S-Ratio |
| S | Sripati |
| U | Krusinski-Pisa-Goelzer |
| V | Equal Vehlow |
| Y | APC Houses |
Note: The default house system used is P – Placidus.
API Endpoint
POST https://astroapi-8.divineapi.com/western-api/v1/fixed-stars-details
Returns fixed star positions in response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | Your API Access Token, e.g. Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key* | String | Your API key |
| full_name* | String | Full name, e.g. Rahul Kumar |
| day* | Integer | Date of birth, e.g. 24 |
| month* | Integer | Month of birth, e.g. 05 |
| year* | Integer | Year of birth, e.g. 2023 |
| hour* | Integer | Hour of birth, e.g. 14 |
| min* | Integer | Minute of birth, e.g. 40 |
| sec* | Integer | Second of birth, e.g. 43 |
| gender* | String | Gender, e.g. male |
| place* | String | Birth place, e.g. New Delhi, India |
| lat* | Float | Latitude, e.g. 28.7041 |
| lon* | Float | Longitude, e.g. 77.1025 |
| tzone* | Float | Timezone, e.g. 5.5 (see timezone guide) |
| star_list* | String | e.g. Abhijit,Aboras,A3558, upto 5 are required |
| lan | String | Response language. Default en. |
| house_system | String | House system code. Default P. |
200: OK Fixed Stars Details fetched successfully
{
"status": "success",
"code": 200,
"message": "Request successful",
"data": [
{
"name": "Abhijit",
"full_degree": "285.6761649",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "15:0:34",
"speed": "-0.0001838",
"is_retro": "true",
"house": 1,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "Aboras",
"full_degree": "332.5612315",
"sign": "Pisces",
"sign_no": 12,
"longitude": "2:0:40",
"speed": "-0.0000825",
"is_retro": "true",
"house": 3,
"element": "Water",
"modality": "Mutable"
}
]
}
Field meanings:
name: Fixed star name as stored by the API.
full_degree: Ecliptic degree (0–360) of the star at the time and location provided.
sign and sign_no: Zodiac sign placement and its numeric index.
longitude: Degree:minute:second format of the star within that sign.
speed and is_retro: Apparent motion values (often very small/retrograde for fixed stars).
house: House placement computed using the chosen house system.
element and modality: Derived zodiacal qualities based on sign.
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-8.divineapi.com/western-api/v1/fixed-stars-details' \
--header 'Authorization: Bearer your API Access Token' \
--form 'api_key="your API Key"' \
--form 'full_name="Rahul Kumar"' \
--form 'day="24"' \
--form 'month="05"' \
--form 'year="2023"' \
--form 'hour="14"' \
--form 'min ="40"' \
--form 'sec="43"' \
--form 'gender="male"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'lan="en"' \
--form 'house_system="P"' \
--form 'star_list=""' \
--form 'star_list=""'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-8.divineapi.com/western-api/v1/fixed-stars-details',
'headers': {
'Authorization': 'Bearer your API Access Token'
},
formData: {
'api_key': 'your API Key',
'full_name': 'Rahul Kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min ': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'house_system': 'P',
'star_list': ''
}
};
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("full_name", "Rahul Kumar");
form.append("day", "24");
form.append("month", "05");
form.append("year", "2023");
form.append("hour", "14");
form.append("min ", "40");
form.append("sec", "43");
form.append("gender", "male");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("lan", "en");
form.append("house_system", "P");
form.append("star_list", "");
var settings = {
"url": "https://astroapi-8.divineapi.com/western-api/v1/fixed-stars-details",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Bearer your API Access 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-8.divineapi.com/western-api/v1/fixed-stars-details"
payload = {'api_key': 'your API Key',
'full_name': 'Rahul Kumar',
'day': '24',
'month': '05',
'year': '2023',
'hour': '14',
'min ': '40',
'sec': '43',
'gender': 'male',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'lan': 'en',
'house_system': 'P',
'star_list': ''}
files=[
]
headers = {
'Authorization': 'Bearer your API Access Token'
}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)