<!-- generated by scripts/docs/generate-reference.ts — do not edit -->

astro_render_wheel

Zodiac wheel renders — single, bi-, tri-, quadri-, or heliocentric wheel.

  • Layer: render
  • Methods: single, biwheel, triwheel, quadriwheel, heliocentric
  • Free tier: single
  • Paid tier: biwheel, triwheel, quadriwheel, heliocentric

Description

Zodiac wheel renders — single, bi-, tri-, quadri-, or heliocentric wheel.

Methods:
  single       [Free] — birth data → single zodiac wheel (wheel or square style, optional harmonic)
  biwheel      [Paid] — two birth data sets → inner/outer bi-wheel with cross-aspect display options
  triwheel     [Paid] — three birth data sets → tri-wheel (3 rings), no aspect lines
  quadriwheel  [Paid] — four birth data sets → quadri-wheel (4 rings), no aspect lines
  heliocentric [Paid] — birth data → Sun-centred houseless wheel (Earth plotted, no cusps or angles)

Input schema

single

FieldTypeRequiredConstraints
birthData.yearintegeryesmin -4000, max 4000, int
birthData.monthintegeryesmin 1, max 12, int
birthData.dayintegeryesmin 1, max 31, int
birthData.hourintegeryesmin 0, max 23, int
birthData.minuteintegeryesmin 0, max 59, int
birthData.secondintegernomin 0, max 59, int
birthData.latitudenumberyesmin -90, max 90
birthData.longitudenumberyesmin -180, max 180
birthData.timezonenumberyesmin -12, max 14
birthData.unknownTimebooleanno
houseSystemenum(44)no
style"wheel" | "square"no
harmonicintegernomin 1, max 360, int
showAspectsbooleanno
showHouseNumbersbooleanno
houseNumbersMode"show" | "middle" | "hide" | "axes-only"no
degreeLabelColoring"default" | "by-sign" | "by-planet"no
extendedBodiesarray<string>no
mode"light" | "dark"no

Example request

{
  "method": "single",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1120 1120\" width=\"1120\" height=\"1120\">\n<defs>\n<path id=\"wm-admetos\"… (185378 chars total)",
  "style": "wheel",
  "harmonic": 1
}

Rendered example

astro_render_wheel.single example render (watchmaker style)

biwheel

FieldTypeRequiredConstraints
inner.yearintegeryesmin -4000, max 4000, int
inner.monthintegeryesmin 1, max 12, int
inner.dayintegeryesmin 1, max 31, int
inner.hourintegeryesmin 0, max 23, int
inner.minuteintegeryesmin 0, max 59, int
inner.secondintegernomin 0, max 59, int
inner.latitudenumberyesmin -90, max 90
inner.longitudenumberyesmin -180, max 180
inner.timezonenumberyesmin -12, max 14
inner.unknownTimebooleanno
outer.yearintegeryesmin -4000, max 4000, int
outer.monthintegeryesmin 1, max 12, int
outer.dayintegeryesmin 1, max 31, int
outer.hourintegeryesmin 0, max 23, int
outer.minuteintegeryesmin 0, max 59, int
outer.secondintegernomin 0, max 59, int
outer.latitudenumberyesmin -90, max 90
outer.longitudenumberyesmin -180, max 180
outer.timezonenumberyesmin -12, max 14
outer.unknownTimebooleanno
houseSystemenum(44)no
harmonicintegernomin 1, max 360, int
aspectDisplay"cross" | "natal" | "natal-outer" | "hide"no
mode"light" | "dark"no

Example request

{
  "method": "biwheel",
  "inner": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  },
  "outer": {
    "year": 2024,
    "month": 6,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 760\" width=\"760\" height=\"760\">\n<rect width=\"100%\" height=\"100%\"… (185870 chars total)",
  "harmonic": 1,
  "crossAspectCount": 10
}

Rendered example

astro_render_wheel.biwheel example render (watchmaker style)

triwheel

FieldTypeRequiredConstraints
chartsarray<object>yes
houseSystemenum(44)no
harmonicintegernomin 1, max 360, int
mode"light" | "dark"no

Example request

{
  "method": "triwheel",
  "charts": [
    {
      "year": 1990,
      "month": 1,
      "day": 1,
      "hour": 12,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    {
      "year": 1992,
      "month": 3,
      "day": 21,
      "hour": 18,
      "minute": 30,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    {
      "year": 2024,
      "month": 6,
      "day": 1,
      "hour": 12,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    }
  ]
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 760\" width=\"760\" height=\"760\">\n<defs>\n<path id=\"wm-admetos\" d=\"… (196615 chars total)",
  "harmonic": 1,
  "rings": 3
}

Rendered example

astro_render_wheel.triwheel example render (watchmaker style)

quadriwheel

FieldTypeRequiredConstraints
chartsarray<object>yes
houseSystemenum(44)no
harmonicintegernomin 1, max 360, int
mode"light" | "dark"no

Example request

{
  "method": "quadriwheel",
  "charts": [
    {
      "year": 1990,
      "month": 1,
      "day": 1,
      "hour": 12,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    {
      "year": 1992,
      "month": 3,
      "day": 21,
      "hour": 18,
      "minute": 30,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    {
      "year": 1988,
      "month": 11,
      "day": 11,
      "hour": 6,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    },
    {
      "year": 2024,
      "month": 6,
      "day": 1,
      "hour": 12,
      "minute": 0,
      "latitude": 51.5074,
      "longitude": -0.1278,
      "timezone": 0
    }
  ]
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 760 760\" width=\"760\" height=\"760\">\n<defs>\n<path id=\"wm-admetos\" d=\"… (212223 chars total)",
  "harmonic": 1,
  "rings": 4
}

Rendered example

astro_render_wheel.quadriwheel example render (watchmaker style)

heliocentric

FieldTypeRequiredConstraints
birthData.yearintegeryesmin -4000, max 4000, int
birthData.monthintegeryesmin 1, max 12, int
birthData.dayintegeryesmin 1, max 31, int
birthData.hourintegeryesmin 0, max 23, int
birthData.minuteintegeryesmin 0, max 59, int
birthData.secondintegernomin 0, max 59, int
birthData.latitudenumberyesmin -90, max 90
birthData.longitudenumberyesmin -180, max 180
birthData.timezonenumberyesmin -12, max 14
birthData.unknownTimebooleanno
zodiacenum(35)no
aspectOrbsany | "default" | "hide" | objectno
minorAspects.quincunxbooleanno
minorAspects.semiSextilebooleanno
minorAspects.semiSquarebooleanno
minorAspects.sesquiquadratebooleanno
minorAspects.quintilebooleanno
minorAspects.biQuintilebooleanno
minorAspects.septilebooleanno
minorAspects.biSeptilebooleanno
minorAspects.triSeptilebooleanno
minorAspects.novilebooleanno
minorAspects.biNovilebooleanno
minorAspects.quadriNovilebooleanno
minorAspects.semiQuintilebooleanno
minorAspects.undecilebooleanno
minorAspects.quindecilebooleanno
extendedBodiesarray<string>no
showAspectsbooleanno
showDegreeTicksbooleanno
mode"light" | "dark"no

Example request

{
  "method": "heliocentric",
  "birthData": {
    "year": 1990,
    "month": 1,
    "day": 1,
    "hour": 12,
    "minute": 0,
    "latitude": 51.5074,
    "longitude": -0.1278,
    "timezone": 0
  }
}

Example response (captured; long values elided)

{
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 1120 1120\" width=\"1120\" height=\"1120\">\n<defs>\n<path id=\"wm-admetos\"… (179779 chars total)",
  "bodyCount": 11
}

Rendered example

astro_render_wheel.heliocentric example render (watchmaker style)