Planetary Positions

Access the Planetary Positions API from Divine API to get precise planetary alignments and positions for natal astrology charts. Ideal for creating custom astrology tools.

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

Step by Step Planetary Positions API Postman Testing Integration

Supported Language Codes:

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

en For English

hi For Hindi

pt For Portuguese

fr For French

de For German

ja For Japanese

tr For turkish

ru For Russian

it For Italian

es For Spanish

nl For Dutch

pl For Polish

Guide: These languages are supported by this API. You can use by passing "lan" in body with a value of the language.

House system codes:

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

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

POST  https://astroapi-4.divineapi.com/western-api/v1/planetary-positions

Returns Planets Positions in response

Headers

Name	Type	Description
Authorization*	String	your API Access Token eg: Bearer {token}

Request Body

Name	Type	Description
api_key*	String	your API key
full_name*	String	full name, ex: Rahul Kumar
day*	Integer	date of birth, eg: 24
month*	Integer	month of birth, eg: 05
year*	Integer	year of birth, eg: 2023
hour*	Integer	hour, eg: 14
min *	Integer	minute, eg: 40
sec*	Integer	second, eg 43
gender*	String	gender, ex: male
place*	String	place, ex: New Delhi
lat*	Float	latitude, eg: 28.7041
lon*	Float	longitude, eg: 77.1025
tzone*	Float	timezone, eg: 5.5 Timezone List
lan	String	Language en/hi, default en
house_system	String	House system code, default - P (Placidus)

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"
        }
    ]
}

Take a look at how you might call this method via cURL, NodeJS or JavaScript jQuery AJAX and Python :

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)