Aspect Patterns
The Aspect Patterns API analyzes a natal chart to detect aspect patterns (such as stelliums) and returns a detailed aspects list along with planet data.
API Endpoint
POST https://astroapi-8.divineapi.com/western-api/v1/aspect-patternsReturns Aspect Patterns 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 |
| 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, India |
| lat* | Float | Latitude, eg: 28.7041 |
| lon* | Float | Longitude, eg: 77.1025 |
| tzone* | Float | Timezone, eg: 5.5 |
200: OK Aspect Patterns fetched successfully
{
"status": "success",
"code": 200,
"message": "Request successful",
"data": {
"patterns": {
"grandTrines": [
{
"id": "Sun-Moon-Mars",
"patternType": "grandTrine",
"element": "fire",
"planets": [
"Sun",
"Moon",
"Mars"
],
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 1.2,
"aspect": "Trine"
},
{
"planetOne": "Moon",
"planetTwo": "Mars",
"orb": 0.8,
"aspect": "Trine"
},
{
"planetOne": "Sun",
"planetTwo": "Mars",
"orb": 2,
"aspect": "Trine"
}
],
"image": {
"svg": "<svg><!-- dummy grand trine --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IGdyYW5kIHRyaW5lIC0tPjwvc3ZnPg==",
"width": 260,
"height": 260
}
}
],
"tSquares": [
{
"id": "Moon-Saturn-Sun",
"patternType": "tSquare",
"planets": [
"Sun",
"Moon",
"Saturn"
],
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 0.4,
"aspect": "Opposition"
},
{
"planetOne": "Sun",
"planetTwo": "Saturn",
"orb": 1.1,
"aspect": "Square"
},
{
"planetOne": "Moon",
"planetTwo": "Saturn",
"orb": 1.7,
"aspect": "Square"
}
],
"image": {
"svg": "<svg><!-- dummy t-square --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IHQtc3F1YXJlIC0tPjwvc3ZnPg==",
"width": 260,
"height": 260
}
}
],
"yods": [
{
"id": "Jupiter-Mars-Neptune",
"patternType": "yod",
"apex": "Neptune",
"planets": [
"Jupiter",
"Mars",
"Neptune"
],
"aspects_list": [
{
"planetOne": "Jupiter",
"planetTwo": "Mars",
"orb": 1,
"aspect": "Sextile"
},
{
"planetOne": "Jupiter",
"planetTwo": "Neptune",
"orb": 1.5,
"aspect": "Quincunx"
},
{
"planetOne": "Mars",
"planetTwo": "Neptune",
"orb": 2.1,
"aspect": "Quincunx"
}
],
"image": {
"svg": "<svg><!-- dummy yod --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IHlvZCAtLT48L3N2Zz4=",
"width": 260,
"height": 260
}
}
],
"kites": [
{
"id": "Jupiter-Mars-Moon-Sun|Sun",
"patternType": "kite",
"planets": [
"Sun",
"Moon",
"Mars",
"Jupiter"
],
"grandTrinePlanets": [
"Sun",
"Moon",
"Mars"
],
"oppositionAnchor": "Sun",
"apex": "Jupiter",
"element": "air",
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 0.9,
"aspect": "Trine"
},
{
"planetOne": "Moon",
"planetTwo": "Mars",
"orb": 1.4,
"aspect": "Trine"
},
{
"planetOne": "Sun",
"planetTwo": "Mars",
"orb": 1.8,
"aspect": "Trine"
},
{
"planetOne": "Sun",
"planetTwo": "Jupiter",
"orb": 0.7,
"aspect": "Opposition"
},
{
"planetOne": "Moon",
"planetTwo": "Jupiter",
"orb": 1,
"aspect": "Sextile"
},
{
"planetOne": "Mars",
"planetTwo": "Jupiter",
"orb": 1.3,
"aspect": "Sextile"
}
],
"image": {
"svg": "<svg><!-- dummy kite --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IGtpdGUgLS0+PC9zdmc+",
"width": 260,
"height": 260
}
}
],
"boatsWedges": [
{
"id": "A-B-C-D",
"patternType": "boatWedge",
"planets": [
"A",
"B",
"C",
"D"
],
"aspects_list": [
{
"planetOne": "A",
"planetTwo": "D",
"orb": 1,
"aspect": "Opposition"
},
{
"planetOne": "A",
"planetTwo": "B",
"orb": 1,
"aspect": "Sextile"
},
{
"planetOne": "A",
"planetTwo": "C",
"orb": 1,
"aspect": "Sextile"
},
{
"planetOne": "B",
"planetTwo": "C",
"orb": 1,
"aspect": "Trine"
},
{
"planetOne": "B",
"planetTwo": "D",
"orb": 1,
"aspect": "Sextile"
},
{
"planetOne": "C",
"planetTwo": "D",
"orb": 1,
"aspect": "Sextile"
}
],
"image": {
"svg": "<svg><!-- dummy boat/wedge --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IGJvYXQvd2VkZ2UgLS0+PC9zdmc+",
"width": 260,
"height": 260
}
}
],
"cradles": [
{
"id": "Jupiter-Moon-Saturn-Sun",
"patternType": "cradle",
"planets": [
"Sun",
"Jupiter",
"Moon",
"Saturn"
],
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 0.2,
"aspect": "Opposition"
},
{
"planetOne": "Sun",
"planetTwo": "Jupiter",
"orb": 1,
"aspect": "Trine"
},
{
"planetOne": "Moon",
"planetTwo": "Saturn",
"orb": 1,
"aspect": "Trine"
},
{
"planetOne": "Sun",
"planetTwo": "Saturn",
"orb": 1.3,
"aspect": "Sextile"
},
{
"planetOne": "Moon",
"planetTwo": "Jupiter",
"orb": 1.6,
"aspect": "Sextile"
},
{
"planetOne": "Jupiter",
"planetTwo": "Saturn",
"orb": 1.9,
"aspect": "Sextile"
}
],
"image": {
"svg": "<svg><!-- dummy cradle --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IGNyYWRsZSAtLT48L3N2Zz4=",
"width": 260,
"height": 260
}
}
],
"mysticRectangles": [
{
"id": "Mars-Mercury-Moon-Sun",
"patternType": "mysticRectangle",
"planets": [
"Sun",
"Mercury",
"Moon",
"Mars"
],
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 1,
"aspect": "Opposition"
},
{
"planetOne": "Mercury",
"planetTwo": "Mars",
"orb": 1.1,
"aspect": "Opposition"
},
{
"planetOne": "Sun",
"planetTwo": "Mercury",
"orb": 1.2,
"aspect": "Trine"
},
{
"planetOne": "Moon",
"planetTwo": "Mars",
"orb": 1.3,
"aspect": "Trine"
},
{
"planetOne": "Sun",
"planetTwo": "Mars",
"orb": 1.4,
"aspect": "Sextile"
},
{
"planetOne": "Mercury",
"planetTwo": "Moon",
"orb": 1.5,
"aspect": "Sextile"
}
],
"image": {
"svg": "<svg><!-- dummy mystic rectangle --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IG15c3RpYyByZWN0YW5nbGUgLS0+PC9zdmc+",
"width": 260,
"height": 260
}
}
],
"grandCrosses": [
{
"id": "Mars-Mercury-Moon-Sun",
"patternType": "grandCross",
"planets": [
"Sun",
"Mercury",
"Moon",
"Mars"
],
"aspects_list": [
{
"planetOne": "Sun",
"planetTwo": "Moon",
"orb": 0.8,
"aspect": "Opposition"
},
{
"planetOne": "Mercury",
"planetTwo": "Mars",
"orb": 1,
"aspect": "Opposition"
},
{
"planetOne": "Sun",
"planetTwo": "Mercury",
"orb": 1.1,
"aspect": "Square"
},
{
"planetOne": "Mercury",
"planetTwo": "Moon",
"orb": 1.3,
"aspect": "Square"
},
{
"planetOne": "Moon",
"planetTwo": "Mars",
"orb": 1.5,
"aspect": "Square"
},
{
"planetOne": "Mars",
"planetTwo": "Sun",
"orb": 1.7,
"aspect": "Square"
}
],
"image": {
"svg": "<svg><!-- dummy grand cross --></svg>",
"base64": "PHN2Zz48IS0tIGR1bW15IGdyYW5kIGNyb3NzIC0tPjwvc3ZnPg==",
"width": 260,
"height": 260
}
}
],
"stelliums": [
{
"type": "sign",
"sign": "ar",
"planets": [
"Sun",
"Mercury",
"Venus"
],
"patternType": "stellium"
},
{
"type": "house",
"house": 10,
"planets": [
"Moon",
"Mars",
"Jupiter"
],
"patternType": "stellium"
}
]
}
}
}
Example Code Implementations
Below are example implementations in various programming environments.
cURL
curl --location 'https://astroapi-8.divineapi.com/western-api/v1/aspect-patterns' \
--header 'Authorization: Bearer {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"'NodeJS
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://astroapi-8.divineapi.com/western-api/v1/aspect-patterns',
'headers': {
'Authorization': 'Bearer {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'
}
};
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");
var settings = {
"url": "https://astroapi-8.divineapi.com/western-api/v1/aspect-patterns",
"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/aspect-patterns"
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'}
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.