Planetary Positions

Explore the current celestial layout with Planetary Positions, understanding the astrological influence of each planet.

Step by Step Planetary Positions 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

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 "lan" in the body with the corresponding value of the language.

House System Codes

Support Article URL:
https://support.divineapi.com/western-astrology-apis/how-to-change-the-house-system-code-in-natal-astrology

Code	Description
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-4.divineapi.com/western-api/v1/planetary-positions

Returns Planetary Positions in response.

Headers

Name	Type	Description
Authorization*	String	Your API Access Token. Example: `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, e.g., 14
min*	Integer	Minute, e.g., 40
sec*	Integer	Second, e.g., 43
gender*	String	Gender, e.g., male
place*	String	Place of birth, e.g., New Delhi
lat*	Float	Latitude, e.g., 28.7041
lon*	Float	Longitude, e.g., 77.1025
tzone*	Float	Timezone, e.g., 5.5 (Timezone List)
lan	String	Language (default: en)
house_system	String	House system code (default: P - Placidus)

Example Response: 200 OK – Planets Positions Fetched Successfully

{
    "success": 1,
    "data": [
        {
            "name": "Ascendant",
            "full_degree": "58.9993544",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "28:59:58",
            "speed": "379.3437328",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 1,
            "element": "Earth",
            "modality": "Fixed"
        },
        {
            "name": "Sun",
            "full_degree": "257.2375629",
            "sign": "Sagittarius",
            "sign_no": 9,
            "longitude": "17:14:15",
            "speed": "1.0161489",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 7,
            "element": "Fire",
            "modality": "Mutable"
        },
        {
            "name": "Moon",
            "full_degree": "215.6951372",
            "sign": "Scorpio",
            "sign_no": 8,
            "longitude": "5:41:42",
            "speed": "12.6900018",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 6,
            "element": "Water",
            "modality": "Fixed"
        },
        {
            "name": "Mars",
            "full_degree": "250.8916331",
            "sign": "Sagittarius",
            "sign_no": 9,
            "longitude": "10:53:30",
            "speed": "0.7241894",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 7,
            "element": "Fire",
            "modality": "Mutable"
        },
        {
            "name": "Mercury",
            "full_degree": "277.3974655",
            "sign": "Capricorn",
            "sign_no": 10,
            "longitude": "7:23:51",
            "speed": "0.5581587",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 8,
            "element": "Earth",
            "modality": "Cardinal"
        },
        {
            "name": "Venus",
            "full_degree": "215.6839880",
            "sign": "Scorpio",
            "sign_no": 8,
            "longitude": "5:41:2",
            "speed": "1.1852668",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 6,
            "element": "Water",
            "modality": "Fixed"
        },
        {
            "name": "Jupiter",
            "full_degree": "36.3737458",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "6:22:25",
            "speed": "-0.0724541",
            "is_retro": "true",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 12,
            "element": "Earth",
            "modality": "Fixed"
        },
        {
            "name": "Saturn",
            "full_degree": "331.5775299",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "1:34:39",
            "speed": "0.0588062",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 10,
            "element": "Water",
            "modality": "Mutable"
        },
        {
            "name": "North node",
            "full_degree": "22.0625037",
            "sign": "Aries",
            "sign_no": 1,
            "longitude": "22:3:45",
            "speed": "-0.0529509",
            "is_retro": "true",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 11,
            "element": "Fire",
            "modality": "Cardinal"
        },
        {
            "name": "South node",
            "full_degree": "202.0625037",
            "sign": "Libra",
            "sign_no": 7,
            "longitude": "22:3:45",
            "speed": "-0.0529509",
            "is_retro": "true",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 5,
            "element": "Air",
            "modality": "Cardinal"
        },
        {
            "name": "Uranus",
            "full_degree": "50.0389490",
            "sign": "Taurus",
            "sign_no": 2,
            "longitude": "20:2:20",
            "speed": "-0.0355893",
            "is_retro": "true",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 12,
            "element": "Earth",
            "modality": "Fixed"
        },
        {
            "name": "Neptune",
            "full_degree": "354.8909141",
            "sign": "Pisces",
            "sign_no": 12,
            "longitude": "24:53:27",
            "speed": "0.0017843",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 11,
            "element": "Water",
            "modality": "Mutable"
        },
        {
            "name": "Pluto",
            "full_degree": "298.7140370",
            "sign": "Capricorn",
            "sign_no": 10,
            "longitude": "28:42:51",
            "speed": "0.0258093",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 9,
            "element": "Earth",
            "modality": "Cardinal"
        },
        {
            "name": "MC",
            "full_degree": "317.0730215",
            "sign": "Aquarius",
            "sign_no": 11,
            "longitude": "17:4:23",
            "speed": "364.5752791",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 9,
            "element": "Air",
            "modality": "Fixed"
        },
        {
            "name": "Chiron",
            "full_degree": "15.5932923",
            "sign": "Aries",
            "sign_no": 1,
            "longitude": "15:35:36",
            "speed": "-0.0159938",
            "is_retro": "true",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 11,
            "element": "Fire",
            "modality": "Cardinal"
        },
        {
            "name": "Part of fortune",
            "full_degree": "17.4569287",
            "sign": "Aries",
            "sign_no": 1,
            "longitude": "17:27:24",
            "speed": "--",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 11,
            "element": "Fire",
            "modality": "Cardinal"
        },
        {
            "name": "Lilith",
            "full_degree": "157.4785861",
            "sign": "Virgo",
            "sign_no": 6,
            "longitude": "7:28:43",
            "speed": "0.1113971",
            "is_retro": "false",
            "is_rising": "false",
            "is_setting": "false",
            "in_midheaven": "false",
            "house": 4,
            "element": "Earth",
            "modality": "Mutable"
        }
    ]
}

Example Code Implementations

Below are example implementations in various programming environments.

cURL

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/planetary-positions' \
--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-4.divineapi.com/western-api/v1/planetary-positions',
  '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-4.divineapi.com/western-api/v1/planetary-positions",
  "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-4.divineapi.com/western-api/v1/planetary-positions"

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)