Natal Wheel Chart

Visualize the complete astrological snapshot of a birth moment with the Natal Wheel Chart API. This endpoint generates an astrology wheel (SVG/base64) showing planetary placements, houses, and zodiac positions based on birth data. You can also customize colors, symbols, and house systems for seamless integration into web or mobile apps.

Step by Step Natal Wheel Chart API Postman Testing Integration

Step by Step Natal Wheel Chart 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

You can return the response in different languages by passing lan in the request body.

Guide: These languages are supported by this API. Use "lan": "<code>" in the body to switch.

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

Note: If house_system is not sent, the API uses P (Placidus).

API Endpoint

POST https://astroapi-4.divineapi.com/western-api/v1/natal-wheel-chart

Returns the natal wheel chart in SVG and base64 formats.

Headers

Request Body

Fields marked with * are mandatory.

200: OK Natal Wheel Chart Fetched Successfully

{
    "success": 1,
    "data": {
        "svg": "SVG CODE",  
        "base64_image": "base64_svg_image"
    }
}

The svg can be rendered directly in web apps. The base64_image can be saved or displayed as an image.

Example Code Implementations

Below are example implementations in various programming environments.

cURL Example

curl --location 'https://astroapi-4.divineapi.com/western-api/v1/natal-wheel-chart' \
--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"' \
--form 'show_symbol="1"' \
--form 'wheel_color="#000"' \
--form 'text_color="#000"'

NodeJS Example

var request = require('request');

var options = {
  method: 'POST',
  url: 'https://astroapi-4.divineapi.com/western-api/v1/natal-wheel-chart',
  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',
    'show_symbol': '1'
  }
};

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

JavaScript jQuery AJAX Example

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");
form.append("show_symbol", "1");

var settings = {
  url: "https://astroapi-4.divineapi.com/western-api/v1/natal-wheel-chart",
  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 Example

import requests

url = "https://astroapi-4.divineapi.com/western-api/v1/natal-wheel-chart"

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',
    'show_symbol': '1'
}

headers = {
    'Authorization': 'Bearer {Your Auth Token}'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Implementation Notes

Always send accurate birth time, latitude, longitude, and timezone to avoid incorrect house cusps.

Use house_system only if you want to override the default Placidus.

To embed in frontend, prefer the svg field; to download/store, use base64_image.

Keep color values in valid hex format (#000, #ffffff) when customizing the chart.