Fixed Stars

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.

Step by Step Fixed Stars API Postman Testing Integration

https://support.divineapi.com/western-astrology-apis/testing-western-api-planetary-positions-api-using-postman

Supported Language Codes

Support Article URL:
https://support.divineapi.com/general-api-support/translating-a-natal-apis-into-a-different-language

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

Note: The default house system used is P – Placidus.

API Endpoint

POST https://astroapi-8.divineapi.com/western-api/v1/fixed-stars

Returns fixed star positions in response.

Headers

Request Body

200: OK Fixed Stars List 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.

Usage Flow

Call Fixed Stars List endpoint to get the list of supported star names.

Choose the stars you need and pass them as star_list to this Fixed Stars endpoint.

Use the returned sign/house data in your frontend or reporting layer.

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-8.divineapi.com/western-api/v1/fixed-stars' \
--header 'Authorization: Bearer {Your Auth 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"'

NodeJS

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://astroapi-8.divineapi.com/western-api/v1/fixed-stars',
  'headers': {
    'Authorization': 'Bearer {Your Auth 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'
  }
};
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");

var settings = {
  "url": "https://astroapi-8.divineapi.com/western-api/v1/fixed-stars",
  "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-8.divineapi.com/western-api/v1/fixed-stars"

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'}

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

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

print(response.text)