Divine API
Copy page
Copy page as Markdown for LLMs
Planetary Positions
Explore the current celestial layout with Composite Planetary Positions, understanding the astrological influence of each planet.
Step by Step Planetary Positions API Postman Testing Integration
Supported Languages
| 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. Pass lan in the body with one of the codes above.
API Endpoint
POST https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions
Returns Planetary Positions in response.
Headers
| Name | Type | Description |
|---|---|---|
| Authorization* | String | your API Access Tokeneg: Bearer {token} |
Request Body
| Name | Type | Description |
|---|---|---|
| api_key* | String | your API key |
| p1_full_name* | String | P1's Full Name, ex: Rahul Kumar |
| p1_day* | Integer | P1's date of birth, eg: 24 |
| p1_month* | Integer | P1's month of birth, eg: 05 |
| p1_year* | Integer | P1's year of birth, eg: 1998 |
| p1_hour* | Integer | P1's hour, eg: 14 |
| p1_min * | Integer | P1's minute, eg: 40 |
| p1_sec* | Integer | P1's second, eg: 43 |
| p1_gender* | String | P1's gender, ex: male |
| p1_place* | String | P1's birth place, ex: New Delhi |
| p1_lat* | Float | P1's latitude, eg: 28.7041 |
| p1_lon* | Float | P1's longitude, eg: 77.1025 |
| p1_tzone* | Float | P1's timezone, eg: 5.5 Timezone List |
| p2_full_name* | String | P2's Full Name, ex: Simran Kumari |
| p2_day* | Integer | P2's date of birth, eg: 24 |
| p2_month* | Integer | P2's month of birth, eg: 05 |
| p2_year* | Integer | P2's year of birth, eg: 1998 |
| p2_hour* | Integer | P2's hour, eg: 14 |
| p2_min* | Integer | P2's minute, eg: 40 |
| p2_sec* | Integer | P2's second, eg: 43 |
| p2_gender* | String | P2's gender, ex: male |
| p2_place* | String | P2's birth place, ex: New Delhi |
| p2_lon* | Float | P2's longitude, eg: 77.1025 |
| p2_lat* | Float | P2's latitude, eg: 28.7041 |
| p2_tzone* | Float | P2's timezone, eg: 5.5 Timezone List |
| lan | String | Language en/hi, default en |
| house_system | String | House system code, default - P (Placidus) |
200: OK Planetary Positions fetched successfully
{
"status": "success",
"code": 200,
"message": "Request successful",
"data": {
"p1_planetary_positions": [
{
"name": "Ascendant",
"full_degree": "257.078873",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "17:4:44",
"speed": "315.638254",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Sun",
"full_degree": "63.229475",
"sign": "Gemini",
"sign_no": 3,
"longitude": "3:13:46",
"speed": "0.9612737",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "46.5203485",
"sign": "Taurus",
"sign_no": 2,
"longitude": "16:31:13",
"speed": "14.9223376",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Mars",
"full_degree": "60.3256278",
"sign": "Gemini",
"sign_no": 3,
"longitude": "0:19:32",
"speed": "0.7118503",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Mercury",
"full_degree": "45.2234284",
"sign": "Taurus",
"sign_no": 2,
"longitude": "15:13:24",
"speed": "1.7743321",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "23.7709035",
"sign": "Aries",
"sign_no": 1,
"longitude": "23:46:15",
"speed": "1.1572865",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Jupiter",
"full_degree": "353.6317691",
"sign": "Pisces",
"sign_no": 12,
"longitude": "23:37:54",
"speed": "0.1513475",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 3,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Saturn",
"full_degree": "28.3512193",
"sign": "Aries",
"sign_no": 1,
"longitude": "28:21:4",
"speed": "0.1117894",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "North node",
"full_degree": "156.1201678",
"sign": "Virgo",
"sign_no": 6,
"longitude": "6:7:13",
"speed": "-0.0529476",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "South node",
"full_degree": "336.1201678",
"sign": "Pisces",
"sign_no": 12,
"longitude": "6:7:13",
"speed": "-0.0529476",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 3,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Uranus",
"full_degree": "312.723067",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "12:43:23",
"speed": "-0.0057148",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "302.0552088",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:3:19",
"speed": "-0.0105204",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Pluto",
"full_degree": "246.7932892",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "6:47:36",
"speed": "-0.0272822",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 12,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "MC",
"full_degree": "179.2100153",
"sign": "Virgo",
"sign_no": 6,
"longitude": "29:12:36",
"speed": "393.4340076",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "Vertex",
"full_degree": "125.5578055",
"sign": "Leo",
"sign_no": 5,
"longitude": "5:33:28",
"speed": "217.0398238",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "Chiron",
"full_degree": "224.2683994",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "14:16:6",
"speed": "-0.0686369",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Lilith",
"full_degree": "197.8546388",
"sign": "Libra",
"sign_no": 7,
"longitude": "17:51:17",
"speed": "0.1113347",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Air",
"modality": "Cardinal"
}
],
"p2_planetary_positions": [
{
"name": "Ascendant",
"full_degree": "110.7290016",
"sign": "Cancer",
"sign_no": 4,
"longitude": "20:43:44",
"speed": "310.2181542",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Sun",
"full_degree": "258.0680076",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "18:4:5",
"speed": "1.01653",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "286.7625766",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "16:45:45",
"speed": "11.8464768",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "Mars",
"full_degree": "310.9955031",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "10:59:44",
"speed": "0.7722369",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Mercury",
"full_degree": "239.3237776",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "29:19:26",
"speed": "1.3575734",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "215.4311882",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "5:25:52",
"speed": "1.1736463",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Jupiter",
"full_degree": "25.1852047",
"sign": "Aries",
"sign_no": 1,
"longitude": "25:11:7",
"speed": "-0.0349108",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Saturn",
"full_degree": "41.2415504",
"sign": "Taurus",
"sign_no": 2,
"longitude": "11:14:30",
"speed": "-0.0557535",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "North node",
"full_degree": "126.2004688",
"sign": "Leo",
"sign_no": 5,
"longitude": "6:12:2",
"speed": "-0.0529262",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "South node",
"full_degree": "306.2004688",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "6:12:2",
"speed": "-0.0529262",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Uranus",
"full_degree": "313.8286059",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "13:49:43",
"speed": "0.0384014",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "302.4772616",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:28:38",
"speed": "0.0291835",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Pluto",
"full_degree": "250.637871",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "10:38:16",
"speed": "0.0387696",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "MC",
"full_degree": "10.5951484",
"sign": "Aries",
"sign_no": 1,
"longitude": "10:35:43",
"speed": "391.3431827",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Vertex",
"full_degree": "239.9060513",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "29:54:22",
"speed": "221.0533711",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Chiron",
"full_degree": "248.9918254",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "8:59:31",
"speed": "0.1239693",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Lilith",
"full_degree": "261.0245069",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "21:1:28",
"speed": "0.1114365",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Fire",
"modality": "Mutable"
}
],
"composite_planetary_positions": [
{
"name": "Ascendant",
"full_degree": "183.9039373",
"sign": "Libra",
"sign_no": 7,
"longitude": "3:54:14",
"house": 1,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Sun",
"full_degree": "340.6487413",
"sign": "Pisces",
"sign_no": 12,
"longitude": "10:38:55",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Moon",
"full_degree": "346.6414625",
"sign": "Pisces",
"sign_no": 12,
"longitude": "16:38:29",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Mars",
"full_degree": "5.6605654",
"sign": "Aries",
"sign_no": 1,
"longitude": "5:39:38",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Mercury",
"full_degree": "322.2736030",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "22:16:24",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "299.6010458",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "29:36:03",
"house": 4,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "Jupiter",
"full_degree": "9.4084869",
"sign": "Aries",
"sign_no": 1,
"longitude": "9:24:30",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Saturn",
"full_degree": "34.7963849",
"sign": "Taurus",
"sign_no": 2,
"longitude": "4:47:46",
"house": 8,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "North node",
"full_degree": "141.1603183",
"sign": "Leo",
"sign_no": 5,
"longitude": "21:09:37",
"house": 11,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "South node",
"full_degree": "321.1603183",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "21:09:37",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Uranus",
"full_degree": "313.2758365",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "13:16:33",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "302.2662352",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "2:15:58",
"house": 4,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Pluto",
"full_degree": "248.7155801",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "8:42:56",
"house": 3,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "MC",
"full_degree": "94.9025819",
"sign": "Cancer",
"sign_no": 4,
"longitude": "4:54:09",
"house": 9,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Vertex",
"full_degree": "182.7319284",
"sign": "Libra",
"sign_no": 7,
"longitude": "2:43:54",
"house": 12,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Chiron",
"full_degree": "236.6301124",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "26:37:48",
"house": 2,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Lilith",
"full_degree": "229.4395728",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "19:26:22",
"house": 2,
"element": "Water",
"modality": "Fixed"
}
]
}
}Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions' \
--header 'Authorization: Bearer {Your Auth Token}' \
--form 'api_key="{Your API Key}"' \
--form 'p1_full_name="Rahul Kumar"' \
--form 'p1_day="24"' \
--form 'p1_month="05"' \
--form 'p1_year="1998"' \
--form 'p1_hour="14"' \
--form 'p1_min="40"' \
--form 'p1_sec="43"' \
--form 'p1_gender="male"' \
--form 'p1_place="New Delhi"' \
--form 'p1_lat="28.7041"' \
--form 'p1_lon="77.1025"' \
--form 'p1_tzone="5.5"' \
--form 'p2_full_name="Simran Kumari"' \
--form 'p2_day="24"' \
--form 'p2_month="05"' \
--form 'p2_year="1998"' \
--form 'p2_hour="14"' \
--form 'p2_min="40"' \
--form 'p2_sec="43"' \
--form 'p2_gender="female"' \
--form 'p2_place="New Delhi"' \
--form 'p2_lat="28.7041"' \
--form 'p2_lon="77.1025"' \
--form 'p2_tzone="5.5"' \
--form 'lan="en"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-8.divineapi.com/western-api/v1/composite/planetary-positions',
'headers': {
'Authorization': 'Bearer {Your Auth Token}'
},
formData: {
'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_gender': 'male',
'p1_place': 'New Delhi',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p2_full_name': 'Simran Kumari',
'p2_day': '24',
'p2_month': '05',
'p2_year': '1998',
'p2_hour': '14',
'p2_min': '40',
'p2_sec': '43',
'p2_gender': 'female',
'p2_place': 'New Delhi',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_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("p1_full_name", "Rahul Kumar");
form.append("p1_day", "24");
form.append("p1_month", "05");
form.append("p1_year", "1998");
form.append("p1_hour", "14");
form.append("p1_min", "40");
form.append("p1_sec", "43");
form.append("p1_gender", "male");
form.append("p1_place", "New Delhi");
form.append("p1_lat", "28.7041");
form.append("p1_lon", "77.1025");
form.append("p1_tzone", "5.5");
form.append("p2_full_name", "Simran Kumari");
form.append("p2_day", "24");
form.append("p2_month", "05");
form.append("p2_year", "1998");
form.append("p2_hour", "14");
form.append("p2_min", "40");
form.append("p2_sec", "43");
form.append("p2_gender", "female");
form.append("p2_place", "New Delhi");
form.append("p2_lat", "28.7041");
form.append("p2_lon", "77.1025");
form.append("p2_tzone", "5.5");
form.append("lan", "en");
var settings = {
"url": "https://astroapi-8.divineapi.com/western-api/v1/composite/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-8.divineapi.com/western-api/v1/composite/planetary-positions"
payload = {'api_key': '{Your API Key}',
'p1_full_name': 'Rahul Kumar',
'p1_day': '24',
'p1_month': '05',
'p1_year': '1998',
'p1_hour': '14',
'p1_min': '40',
'p1_sec': '43',
'p1_gender': 'male',
'p1_place': 'New Delhi',
'p1_lat': '28.7041',
'p1_lon': '77.1025',
'p1_tzone': '5.5',
'p2_full_name': 'Simran Kumari',
'p2_day': '24',
'p2_month': '05',
'p2_year': '1998',
'p2_hour': '14',
'p2_min': '40',
'p2_sec': '43',
'p2_gender': 'female',
'p2_place': 'New Delhi',
'p2_lat': '28.7041',
'p2_lon': '77.1025',
'p2_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
This composite endpoint requires both P1 and P2 birth details; ensure all mandatory fields for each person are provided before calling.
Coordinates must be decimal floats (lat, lon) and timezone in decimal hours (tzone, e.g., 5.5); invalid formats will lead to parsing errors or empty composites.
The response includes extended bodies (e.g., Chiron, Lilith, Nodes, MC, Vertex) and some boolean-like values as strings ("is_retro": "true"|"false"); normalize types in your client if needed.
Defaults: lan=en, house_system=P (Placidus); override house_system only if your application explicitly supports alternative systems.