Planetary Positions
The Planetary Positions API returns the natal planetary positions (at birth) and the transit planetary positions for the provided transit details and location.
API Endpoint
POST https://astroapi-8.divineapi.com/western-api/v1/transit/planetary-positionsReturns transit planetary 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 {{api_key}} |
| day* | Integer | Birth day 3 |
| month* | Integer | Birth month 11 |
| year* | Integer | Birth year 2025 |
| hour* | Integer | Birth hour (24-hour format) 4 |
| min* | Integer | Birth minutes 47 |
| sec* | Integer | Birth seconds 56 |
| place* | String | Birth place New Delhi, India |
| lat* | Float | Birth latitude 28.7041 |
| lon* | Float | Birth longitude 77.1025 |
| tzone* | Float | Birth timezone (decimal) 5.5 |
| transit_day* | Integer | Transit day 5 |
| transit_month* | Integer | Transit month 8 |
| transit_year* | Integer | Transit year 2021 |
| transit_hour* | Integer | Transit hour (24-hour format) 4 |
| transit_min* | Integer | Transit minutes 56 |
| transit_sec* | Integer | Transit seconds 45 |
| transit_place* | String | Transit place New Delhi, India |
| transit_lat* | Float | Transit latitude 28.7041 |
| transit_lon* | Float | Transit longitude 77.1025 |
| transit_tzone* | Float | Transit timezone (decimal) 5.5 |
200: OK Planetary Positions Details fetched successfully
{
"status": "success",
"code": 200,
"message": "Request successful",
"data": {
"natal_planetary_positions": [
{
"name": "Ascendant",
"full_degree": "196.7552709",
"sign": "Libra",
"sign_no": 7,
"longitude": "16:45:19",
"speed": "315.8560419",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Sun",
"full_degree": "220.7933358",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "10:47:36",
"speed": "1.0008559",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Moon",
"full_degree": "4.606031",
"sign": "Aries",
"sign_no": 1,
"longitude": "4:36:22",
"speed": "14.5390337",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Mars",
"full_degree": "238.8755045",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "28:52:32",
"speed": "0.7146721",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Water",
"modality": "Fixed"
},
{
"name": "Mercury",
"full_degree": "244.031075",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "4:1:52",
"speed": "0.7475602",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Venus",
"full_degree": "205.028194",
"sign": "Libra",
"sign_no": 7,
"longitude": "25:1:41",
"speed": "1.250553",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 1,
"element": "Air",
"modality": "Cardinal"
},
{
"name": "Jupiter",
"full_degree": "115.0270378",
"sign": "Cancer",
"sign_no": 4,
"longitude": "25:1:37",
"speed": "0.0285254",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Saturn",
"full_degree": "355.7095514",
"sign": "Pisces",
"sign_no": 12,
"longitude": "25:42:34",
"speed": "-0.0425345",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "North node",
"full_degree": "345.295776",
"sign": "Pisces",
"sign_no": 12,
"longitude": "15:17:45",
"speed": "-0.0529851",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Water",
"modality": "Mutable"
},
{
"name": "South node",
"full_degree": "165.29577599999993",
"sign": "Virgo",
"sign_no": 6,
"longitude": "15:17:45",
"speed": "-0.0529851",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "Uranus",
"full_degree": "60.2022801",
"sign": "Gemini",
"sign_no": 3,
"longitude": "0:12:8",
"speed": "-0.0387286",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Neptune",
"full_degree": "359.7532806",
"sign": "Pisces",
"sign_no": 12,
"longitude": "29:45:12",
"speed": "-0.0192271",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Pluto",
"full_degree": "301.4612859",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "1:27:41",
"speed": "0.0094648",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Air",
"modality": "Fixed"
},
{
"name": "MC",
"full_degree": "107.5931905",
"sign": "Cancer",
"sign_no": 4,
"longitude": "17:35:35",
"speed": "336.8871159",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Vertex",
"full_degree": "66.6884435",
"sign": "Gemini",
"sign_no": 3,
"longitude": "6:41:18",
"speed": "658.9334818",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "Chiron",
"full_degree": "24.1289998",
"sign": "Aries",
"sign_no": 1,
"longitude": "24:7:44",
"speed": "-0.0438075",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Lilith",
"full_degree": "234.6446259",
"sign": "Scorpio",
"sign_no": 8,
"longitude": "24:38:41",
"speed": "0.1118724",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Water",
"modality": "Fixed"
}
],
"transit_planetary_positions": [
{
"name": "Ascendant",
"full_degree": "121.6512673",
"sign": "Leo",
"sign_no": 5,
"longitude": "1:39:5",
"speed": "306.9006247",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "Sun",
"full_degree": "132.7858346",
"sign": "Leo",
"sign_no": 5,
"longitude": "12:47:9",
"speed": "0.9579148",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "Moon",
"full_degree": "91.0885469",
"sign": "Cancer",
"sign_no": 4,
"longitude": "1:5:19",
"speed": "12.0964535",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 9,
"element": "Water",
"modality": "Cardinal"
},
{
"name": "Mars",
"full_degree": "153.8470838",
"sign": "Virgo",
"sign_no": 6,
"longitude": "3:50:50",
"speed": "0.6296166",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "Mercury",
"full_degree": "136.5089907",
"sign": "Leo",
"sign_no": 5,
"longitude": "16:30:32",
"speed": "2.0245242",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 10,
"element": "Fire",
"modality": "Fixed"
},
{
"name": "Venus",
"full_degree": "166.6916454",
"sign": "Virgo",
"sign_no": 6,
"longitude": "16:41:30",
"speed": "1.1917748",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 11,
"element": "Earth",
"modality": "Mutable"
},
{
"name": "Jupiter",
"full_degree": "329.1479617",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "29:8:53",
"speed": "-0.1204375",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 5,
"element": "Air",
"modality": "Fixed"
},
{
"name": "Saturn",
"full_degree": "309.9824063",
"sign": "Aquarius",
"sign_no": 11,
"longitude": "9:58:57",
"speed": "-0.0742776",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Air",
"modality": "Fixed"
},
{
"name": "North node",
"full_degree": "67.4219059",
"sign": "Gemini",
"sign_no": 3,
"longitude": "7:25:19",
"speed": "-0.0529276",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
},
{
"name": "South node",
"full_degree": "247.4219059",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "7:25:19",
"speed": "-0.0529276",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Uranus",
"full_degree": "44.6990384",
"sign": "Taurus",
"sign_no": 2,
"longitude": "14:41:57",
"speed": "0.0124779",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Earth",
"modality": "Fixed"
},
{
"name": "Neptune",
"full_degree": "352.7873407",
"sign": "Pisces",
"sign_no": 12,
"longitude": "22:47:14",
"speed": "-0.0193813",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Water",
"modality": "Mutable"
},
{
"name": "Pluto",
"full_degree": "295.1351843",
"sign": "Capricorn",
"sign_no": 10,
"longitude": "25:8:7",
"speed": "-0.0226192",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 4,
"element": "Earth",
"modality": "Cardinal"
},
{
"name": "MC",
"full_degree": "24.3313933",
"sign": "Aries",
"sign_no": 1,
"longitude": "24:19:53",
"speed": "382.8806719",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 7,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Vertex",
"full_degree": "247.914352",
"sign": "Sagittarius",
"sign_no": 9,
"longitude": "7:54:52",
"speed": "232.2027964",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 2,
"element": "Fire",
"modality": "Mutable"
},
{
"name": "Chiron",
"full_degree": "12.7550417",
"sign": "Aries",
"sign_no": 1,
"longitude": "12:45:18",
"speed": "-0.0170688",
"is_retro": "true",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 6,
"element": "Fire",
"modality": "Cardinal"
},
{
"name": "Lilith",
"full_degree": "61.95209",
"sign": "Gemini",
"sign_no": 3,
"longitude": "1:57:8",
"speed": "0.1107793",
"is_retro": "false",
"is_rising": "false",
"is_setting": "false",
"in_midheaven": "false",
"house": 8,
"element": "Air",
"modality": "Mutable"
}
]
}
}
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-8.divineapi.com/western-api/v1/transit/planetary-positions' \
--header 'Authorization: Bearer {token}' \
--form 'api_key="Your API Key"' \
--form 'day="3"' \
--form 'month="11"' \
--form 'year="2025"' \
--form 'place="New Delhi, India"' \
--form 'lat="28.7041"' \
--form 'lon="77.1025"' \
--form 'tzone="5.5"' \
--form 'hour="4"' \
--form 'min="47"' \
--form 'sec="56"' \
--form 'transit_day="5"' \
--form 'transit_month="8"' \
--form 'transit_year="2021"' \
--form 'transit_hour="4"' \
--form 'transit_min="56"' \
--form 'transit_sec="45"' \
--form 'transit_lat="28.7041"' \
--form 'transit_lon="77.1025"' \
--form 'transit_tzone="5.5"' \
--form 'transit_place="New Delhi, India"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-8.divineapi.com/western-api/v1/transit/planetary-positions',
'headers': {
'Authorization': 'Bearer {token}'
},
formData: {
'api_key': 'Your API Key',
'day': '3',
'month': '11',
'year': '2025',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'hour': '4',
'min': '47',
'sec': '56',
'transit_day': '5',
'transit_month': '8',
'transit_year': '2021',
'transit_hour': '4',
'transit_min': '56',
'transit_sec': '45',
'transit_lat': '28.7041',
'transit_lon': '77.1025',
'transit_tzone': '5.5',
'transit_place': 'New Delhi, India'
}
};
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("day", "3");
form.append("month", "11");
form.append("year", "2025");
form.append("place", "New Delhi, India");
form.append("lat", "28.7041");
form.append("lon", "77.1025");
form.append("tzone", "5.5");
form.append("hour", "4");
form.append("min", "47");
form.append("sec", "56");
form.append("transit_day", "5");
form.append("transit_month", "8");
form.append("transit_year", "2021");
form.append("transit_hour", "4");
form.append("transit_min", "56");
form.append("transit_sec", "45");
form.append("transit_lat", "28.7041");
form.append("transit_lon", "77.1025");
form.append("transit_tzone", "5.5");
form.append("transit_place", "New Delhi, India");
var settings = {
"url": "https://astroapi-8.divineapi.com/western-api/v1/transit/planetary-positions",
"method": "POST",
"timeout": 0,
"headers": {
"Authorization": "Bearer {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/transit/planetary-positions"
payload = {'api_key': 'Your API Key',
'day': '3',
'month': '11',
'year': '2025',
'place': 'New Delhi, India',
'lat': '28.7041',
'lon': '77.1025',
'tzone': '5.5',
'hour': '4',
'min': '47',
'sec': '56',
'transit_day': '5',
'transit_month': '8',
'transit_year': '2021',
'transit_hour': '4',
'transit_min': '56',
'transit_sec': '45',
'transit_lat': '28.7041',
'transit_lon': '77.1025',
'transit_tzone': '5.5',
'transit_place': 'New Delhi, India'}
files=[
]
headers = {
'Authorization': 'Bearer {token}'
}
response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.text)
Implementation Notes
Use Authorization: Bearer {Your Auth Token} and {Your API Key} securely; never expose them in client-side code.
Provide date, time, and coordinates in correct numeric formats; use decimal timezone values (e.g., 5.5).
Check HTTP status codes, log responses, and handle 4xx/5xx errors gracefully.