Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Render → Natal Chart

AI-generated

Summary

Generate a natal chart image (or vector graphic) based on birth date, time, and location, with configurable output format, theme, size, and visual options.

Inputs

  • year (required) — Birth year (4‑digit).
  • month (required) — Birth month (1‑12).
  • day (required) — Birth day of month (1‑31).
  • hour (required) — Birth hour in 24‑hour format (0‑23).
  • minute (required) — Birth minute (0‑59).
  • locationType (required) — How to specify the birth location – either 'city' (city + countryCode) or 'coordinates' (latitude + longitude).
  • city (required) — Birth city name (used when locationType is 'city').
  • countryCode (required) — Two‑letter ISO country code for the birth city (used when locationType is 'city').
  • latitude (required) — Geographic latitude of the birth location in decimal degrees (‑90 to 90) (used when locationType is 'coordinates').
  • longitude (required) — Geographic longitude of the birth location in decimal degrees (‑180 to 180) (used when locationType is 'coordinates').
  • renderFormat — Output format for the chart – one of jpg, pdf, png, svg, webp (default: svg).
  • renderTheme — Visual theme for the chart – classic, dark, light, modern_light, traditional (default: light).
  • renderWidth — Width of the output image in pixels (200‑4000, default: 800).
  • renderHeight — Height of the output image in pixels (200‑4000, default: 800).
  • backgroundColor — Background colour for the chart as a hex colour code (default: #ffffff).
  • showAspects — Whether to display aspect lines in the chart (default: true).
  • showHouseNumbers — Whether to display house numbers in the chart (default: true).
  • showDegrees — Whether to display planetary degrees in the chart (default: true).

Output shape

Binary data (or base64‑encoded string) representing the rendered chart in the selected format, accompanied by metadata such as mime type and dimensions.

The output can be consumed directly by nodes that accept binary data (e.g., Write Binary File, HTTP Request, or email attachments).

Examples

Example 1: Create a simple SVG natal chart for a person born on 1990‑06‑15 at 14:30 in London, GB.

Set year=1990, month=6, day=15, hour=14, minute=30, locationType=city, city=London, countryCode=GB. Leave other fields at defaults to receive an SVG chart.

Links

Discussion