visualization

Generate Chart Wheel

Generate SVG/PNG chart wheel. Free on every tier, including Explorer.

post/visualization/chart-wheel

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/visualization/chart-wheel
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

formatstring
sizeinteger
stylestring
no_logoboolean

When true, suppresses the Open Ephemeris watermark/logomark in the rendered SVG. Intended for white-label and embedded use cases where the chart is presented inside a host product's branded shell.

aspect_gridboolean

When true, renders an aspect-grid reference panel (the classic astro.com-style triangular matrix of aspect glyphs and orbs) as a band below the chart. Off by default; growing the canvas only when requested keeps existing callers' output unchanged. Note: when format=png, the resulting image is taller than it is wide (matches the SVG canvas) rather than square; if the server falls back to its legacy PNG rasterizer (native renderer unavailable), the panel is not rendered at all.

aspect_grid_orbsboolean

When aspect_grid is true, controls whether each populated cell also prints its orb in degrees. Defaults on; set false to show only the aspect glyph.

include_angle_aspectsboolean

When true, includes aspects to the four chart angles (Ascendant, Descendant, Midheaven, Imum Coeli) as lines on the wheel, in addition to planet-planet aspects. Angle-to-angle pairs are never drawn (Descendant and Imum Coeli are the 180° opposites of Ascendant and Midheaven, so those pairs carry no information beyond what Ascendant/Midheaven aspects already show). Uses the same tighter orbs as the /ephemeris/natal-chart/enhanced options.include_angle_aspects flag. Off by default: existing callers' wheel output is unchanged.

elementsboolean

When true, renders an element/modality summary table (Fire/Earth/Air/Water and Cardinal/Fixed/Mutable, with the actual body glyphs in each row) as a band below the chart. Off by default. Independent of aspect_grid — either or both may be requested. Same format=png caveats as aspect_grid apply.

planet_colorsboolean

When true, colors each planet/point glyph using Ela Map's canonical per-body palette instead of the default monochrome ink. Off by default; existing callers' output is unchanged. Bodies outside that palette (e.g. Earth, Lots, chart angles) keep the monochrome treatment.

Request body

Example request

{
  "subject": {
    "birth_datetime": {
      "iso": "1985-03-20T08:15:00"
    },
    "birth_location": {
      "latitude": {
        "decimal": 37.7749
      },
      "longitude": {
        "decimal": -122.4194
      },
      "timezone": {
        "iana_name": "America/Los_Angeles"
      }
    },
    "name": "Jane Smith"
  }
}

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.