Natal Wheel Chart - Western Astrology

Overview

The Western Astrology Natal Wheel Chart API generates a visual natal chart for a specified birth date, time, and geographical location. It creates a wheel-style chart showing zodiac signs, planetary positions, astrological houses, and the aspects between chart objects. The generated chart is returned as an SVG image URL that can be embedded in websites and applications.

The API supports customization of the house system, included planets and chart points, aspect types, and aspect orb values. You can also configure aspect line colors, zodiac sign background colors, chart background colors, text colors, and planet icon colors to match your application's design. Supported aspects include conjunction, opposition, trine, square, sextile, semi-sextile, quintile, septile, octile, novile, quincunx, and sesquiquadrate.

To generate a natal wheel chart, provide the birth year, month, date, time, latitude, longitude, and timezone. Optional configuration settings allow you to choose a supported house system, select geocentric or topocentric positions, specify a zodiac calculation mode, and set the response language. The API returns a JSON response containing the generated SVG chart URL, which you can use to display the chart in your website, mobile application, or Western astrology software.

Request Parameters

Supported Languages

This API endpoint supports the following languages. Use the corresponding 2-letter language code in the language parameter when making your request.

{
    "language": "te"
}

Request Example

{
    "year": 1998,
    "month": 3,
    "date": 3,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", /* geocentric or topocentric */
        "ayanamsha": "tropical", /*  tropical or sayana or lahiri  */
        "house_system": "Placidus", /* "Placidus","Koch","Whole Signs","Equal Houses","Regiomontanus","Vehlow" */
        "language": "en", 
        "exclude_planets": [], /* "True Node", "Mean Node", "IC","MC","Descendant","Ascendant","Sun","Moon","Mars","Mercury","Jupiter","Venus","Saturn","Lilith","Chiron","Ceres","Vesta","Juno","Pallas","Uranus","Neptune","Pluto"*/
        "allowed_aspects": [
            "Conjunction",
            "Opposition",
            "Trine",
            "Square",
            "Sextile",
            "Semi-Sextile",
            "Quintile",
            "Septile",
            "Octile",
            "Novile",
            "Quincunx",
            "Sesquiquadrate"
        ],
        /* "Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate" */
        "aspect_line_colors": {
            "Conjunction": "#558B6E",
            "Opposition": "#88A09E",
            "Square": "#704C5E",
            "Trine": "#B88C9E",
            "Sextile": "#F1C8DB",
            "Semi-Sextile": "#A799B7",
            "Quintile": "#9888A5",
            "Septile": "#776472",
            "Octile": "#445552",
            "Novile": "#294D4A",
            "Quincunx": "#49306B",
            "Sesquiquadrate": "#E1CDB5"
        },
        "wheel_chart_colors": {
            "zodiac_sign_background_color": "#303036",
            "chart_background_color": "#303036",
            "zodiac_signs_text_color": "#FFFFFF",
            "dotted_line_color": "#FFFAFF",
            "planets_icon_color": "#FFFAFF"
        },
        "orb_values": {
            "Conjunction": 3,
            "Opposition": 5,
            "Square": 5,
            "Trine": 5,
            "Sextile": 5,
            "Semi-Sextile": 5,
            "Quintile": 5,
            "Septile": 5,
            "Octile": 5,
            "Novile": 5,
            "Quincunx": 5,
            "Sesquiquadrate": 5
        }
    }
}

Response Examples

Example responses returned by this API.

{
    "statusCode": 200,
    "output": "https://western-astrology.s3.ap-south-1.amazonaws.com/Chart_1787805059308.svg"
}

Code Examples

Use the following examples to integrate this API into your application.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://json.freeastrologyapi.com/western/natal-wheel-chart',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "year": 2002,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
        "observation_point": "topocentric", 
        "ayanamsha": "tropical", 
        "house_system": "Porphyry", 
        "language": "tr", 
        "exclude_planets": [
        ],  
       "allowed_aspects":["Conjunction", "Opposition", "Trine","Square","Sextile","Semi-Sextile","Quintile","Septile","Octile","Novile","Quincunx","Sesquiquadrate"], 
        
        "aspect_line_colors": {
            "Conjunction": "#558B6E", 
            "Opposition": "#88A09E", 
            "Square": "#704C5E", 
            "Trine": "#B88C9E", 
            "Sextile": "#F1C8DB", 
            "Semi-Sextile": "#A799B7", 
            "Quintile": "#9888A5", 
            "Septile": "#776472", 
            "Octile": "#445552", 
            "Novile": "#294D4A", 
            "Quincunx": "#49306B", 
            "Sesquiquadrate": "#E1CDB5" 
        },
        "wheel_chart_colors": {
            "zodiac_sign_background_color":"#303036", 
            "chart_background_color":"#303036", 
            "zodiac_signs_text_color":"#FFFFFF", 
            "dotted_line_color":"#FFFAFF", 
            "planets_icon_color":"#FFFAFF" 
        },
        "orb_values": {
            "Conjunction": 3,  
            "Opposition": 5,  
            "Square": 5,  
            "Trine": 5,  
            "Sextile": 5,  
            "Semi-Sextile": 5,  
            "Quintile": 5,  
            "Septile": 5,  
            "Octile": 5,  
            "Novile": 5,  
            "Quincunx": 5,  
            "Sesquiquadrate": 5  
        }
    }
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'x-api-key: YOUR_API_KEY_HERE'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

import requests
import json

url = "https://json.freeastrologyapi.com/western/natal-wheel-chart"

payload = json.dumps({
  "year": 2002,
  "month": 1,
  "date": 1,
  "hours": 10,
  "minutes": 30,
  "seconds": 0,
  "latitude": 17.38405,
  "longitude": 78.45636,
  "timezone": 5.5,
  "config": {
    "observation_point": "topocentric",
    "ayanamsha": "tropical",
    "house_system": "Porphyry",
    "language": "tr",
    "exclude_planets": [],
    "allowed_aspects": [
      "Conjunction",
      "Opposition",
      "Trine",
      "Square",
      "Sextile",
      "Semi-Sextile",
      "Quintile",
      "Septile",
      "Octile",
      "Novile",
      "Quincunx",
      "Sesquiquadrate"
    ],
    "aspect_line_colors": {
      "Conjunction": "#558B6E",
      "Opposition": "#88A09E",
      "Square": "#704C5E",
      "Trine": "#B88C9E",
      "Sextile": "#F1C8DB",
      "Semi-Sextile": "#A799B7",
      "Quintile": "#9888A5",
      "Septile": "#776472",
      "Octile": "#445552",
      "Novile": "#294D4A",
      "Quincunx": "#49306B",
      "Sesquiquadrate": "#E1CDB5"
    },
    "wheel_chart_colors": {
      "zodiac_sign_background_color": "#303036",
      "chart_background_color": "#303036",
      "zodiac_signs_text_color": "#FFFFFF",
      "dotted_line_color": "#FFFAFF",
      "planets_icon_color": "#FFFAFF"
    },
    "orb_values": {
      "Conjunction": 3,
      "Opposition": 5,
      "Square": 5,
      "Trine": 5,
      "Sextile": 5,
      "Semi-Sextile": 5,
      "Quintile": 5,
      "Septile": 5,
      "Octile": 5,
      "Novile": 5,
      "Quincunx": 5,
      "Sesquiquadrate": 5
    }
  }
})
headers = {
  'Content-Type': 'application/json',
  'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://json.freeastrologyapi.com/western/natal-wheel-chart',
  'headers': {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY_HERE'
  },
  body: JSON.stringify({
    "year": 2002,
    "month": 1,
    "date": 1,
    "hours": 10,
    "minutes": 30,
    "seconds": 0,
    "latitude": 17.38405,
    "longitude": 78.45636,
    "timezone": 5.5,
    "config": {
      "observation_point": "topocentric",
      "ayanamsha": "tropical",
      "house_system": "Porphyry",
      "language": "tr",
      "exclude_planets": [],
      "allowed_aspects": [
        "Conjunction",
        "Opposition",
        "Trine",
        "Square",
        "Sextile",
        "Semi-Sextile",
        "Quintile",
        "Septile",
        "Octile",
        "Novile",
        "Quincunx",
        "Sesquiquadrate"
      ],
      "aspect_line_colors": {
        "Conjunction": "#558B6E",
        "Opposition": "#88A09E",
        "Square": "#704C5E",
        "Trine": "#B88C9E",
        "Sextile": "#F1C8DB",
        "Semi-Sextile": "#A799B7",
        "Quintile": "#9888A5",
        "Septile": "#776472",
        "Octile": "#445552",
        "Novile": "#294D4A",
        "Quincunx": "#49306B",
        "Sesquiquadrate": "#E1CDB5"
      },
      "wheel_chart_colors": {
        "zodiac_sign_background_color": "#303036",
        "chart_background_color": "#303036",
        "zodiac_signs_text_color": "#FFFFFF",
        "dotted_line_color": "#FFFAFF",
        "planets_icon_color": "#FFFAFF"
      },
      "orb_values": {
        "Conjunction": 3,
        "Opposition": 5,
        "Square": 5,
        "Trine": 5,
        "Sextile": 5,
        "Semi-Sextile": 5,
        "Quintile": 5,
        "Septile": 5,
        "Octile": 5,
        "Novile": 5,
        "Quincunx": 5,
        "Sesquiquadrate": 5
      }
    }
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});