Natal Chart

Previous value: -"Extra bodies by name, e.g. ['eris','sedna','psyche','hekate','fortuna','chariklo']; any id in GET /catalogs/bodies. No extra credits. Bodies with their own JPL kernel (centaurs, TNOs, extended asteroids) cover 1600–2200 CE only; outside that they are listed in omitted_bodies with valid_from/valid_to, never approximated."New value: +"Extra body ids from GET /catalogs/bodies, e.g. ['eris','sedna']; free; 1600–2200 CE, else listed in omitted_bodies."

Previous value: -"Opt-in extras, no extra credits: element_balance (element and modality counts over the classical ten), hemisphere_emphasis, aspect_patterns, harmonics, dignities (essential dignity and score per planet), sect, angle_aspects (aspects to ASC/MC), human_design_gates."New value: +"Opt-in extras, free."

Previous value: -"Add a whole family: major (Ceres, Pallas, Juno, Vesta), centaur (Chiron, Pholus), tno (Eris, Sedna, Makemake, Haumea, Quaoar, Orcus, Ixion, Varuna) or main_belt (12 large asteroids)."New value: +"Add a family: major (Ceres–Vesta), centaur, tno (Eris, Sedna, …) or main_belt (12 large)."

Previous value: -"Sidereal system. Default lahiri. Only read when zodiac_type is `sidereal`."New value: +"Default lahiri; sidereal only."

Previous value: -"ISO 8601 datetime. A datetime with no zone is rejected; give a `Z` or ±HH:MM suffix, or a local time with the `timezone` argument. Date-only resolves to 12:00 UTC."New value: +"ISO 8601; zone required (`Z`/offset, or local time plus `timezone`)."

Previous value: -"Add each body's declination and out-of-bounds flag, plus parallel/contraparallel aspects (1.5° orb)."New value: +"Add declinations, out-of-bounds flags and parallels (1.5° orb)."

Previous value: -"Output format. 'llm' returns a compact array-based projection optimized for LLM token efficiency (available on all tiers). 'json' returns full verbose JSON."New value: +"'llm' = compact; 'json' = full (default)."

Previous value: -"House system to use. Defaults to 'placidus' if omitted."New value: +"Default placidus."

Previous value: -"Include Hermetic Lots / Arabic Parts in the natal response (routed as `options.include_hermetic_lots: true`)."New value: +"Add Hermetic Lots / Arabic Parts."

Previous value: -"Add fixed-star conjunctions (Regulus, Algol, Spica and the catalog) against the chart's bodies and angles. Honoured by the endpoint since 4.14.0; same zodiac frame as the chart."New value: +"Add fixed-star conjunctions to bodies and angles."

Previous value: -"Add quincunx, semisextile, semisquare, sesquiquadrate, quintile and biquintile to the aspect grid. Off by default; minors use their own orbs, so this widens the grid without changing any major aspect."New value: +"Add minor aspects."

Previous value: -"When true, renders the natal chart wheel as an SVG and embeds it directly in the response. Costs 2 additional credits on top of the base call cost."New value: +"Embed a chart-wheel SVG. +2 credits."

Previous value: -"Geographic latitude of birth location in decimal degrees (positive = North)."New value: +"Birth latitude."

Previous value: -"Geographic longitude of birth location in decimal degrees (positive = East)."New value: +"Birth longitude."

Previous value: -"Classify combustion, cazimi and under-beams for Moon–Saturn relative to the Sun."New value: +"Add combustion, cazimi and under-beams."

Previous value: -"IANA timezone (e.g. `America/Chicago`); required when the datetime is naive, ignored otherwise."New value: +"IANA zone for a local datetime."

Previous value: -"Optional rendering preferences (only used when include_visual=true)."New value: +"Rendering options for include_visual."

Previous value: -"Canvas size in pixels, 200–4000. Default: 800."New value: +"Pixels, 200–4000. Default 800."

Previous value: -"Color theme. Default: light."New value: +"Default light."

Previous value: -"Zodiac frame. Default tropical. `sidereal` subtracts the ayanamsa (~24°) from every longitude, so signs, dignities and element balance all move; aspects and house numbers do not. The response names the frame it used."New value: +"Default tropical. `sidereal` subtracts the ayanamsa (~24°) from every longitude."

Previous value: -"Extra bodies to add to the chart, by name: e.g. ['eris','sedna','psyche','hekate','fortuna','pandora','asbolus','hylonome','chaos','gonggong','salacia','sappho','eros','nessus','chariklo']. Any body in GET /catalogs/bodies works (use its id/name, lowercase). No extra credits. Bodies with their own JPL kernel (centaurs, trans-Neptunian objects, the extended asteroids) are computed for 1600–2200 CE only; for a chart outside that they are left out and listed in omitted_bodies with their valid_from/valid_to — never approximated."New value: +"Extra bodies by name, e.g. ['eris','sedna','psyche','hekate','fortuna','chariklo']; any id in GET /catalogs/bodies. No extra credits. Bodies with their own JPL kernel (centaurs, TNOs, extended asteroids) cover 1600–2200 CE only; outside that they are listed in omitted_bodies with valid_from/valid_to, never approximated."

Previous value: -"Optional whole-chart analytics, off by default: element_balance (fire/earth/air/water plus modality counts over the classical ten, unweighted), hemisphere_emphasis (above/below and east/west from the angles), aspect_patterns (aspect matrix + detected patterns), harmonics. No extra credits. Absent from format='llm'."New value: +"Opt-in extras, no extra credits: element_balance (element and modality counts over the classical ten), hemisphere_emphasis, aspect_patterns, harmonics, dignities (essential dignity and score per planet), sect, angle_aspects (aspects to ASC/MC), human_design_gates."

Previous value: -[
-  "element_balance",
-  "hemisphere_emphasis",
-  "aspect_patterns",
-  "harmonics"
-]New value: +[
+  "element_balance",
+  "hemisphere_emphasis",
+  "aspect_patterns",
+  "harmonics",
+  "dignities",
+  "sect",
+  "angle_aspects",
+  "human_design_gates"
+]

Added value: +{
+  "description": "Extra bodies to add to the chart, by name: e.g. ['eris','sedna','psyche','hekate','fortuna','pandora','asbolus','hylonome','chaos','gonggong','salacia','sappho','eros','nessus','chariklo']. Any body in GET /catalogs/bodies works (use its id/name, lowercase). No extra credits. Bodies with their own JPL kernel (centaurs, trans-Neptunian objects, the extended asteroids) are computed for 1600–2200 CE only; for a chart outside that they are left out and listed in omitted_bodies with their valid_from/valid_to — never approximated.",
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 40,
+  "type": "array"
+}

Added value: +{
+  "description": "Optional whole-chart analytics, off by default: element_balance (fire/earth/air/water plus modality counts over the classical ten, unweighted), hemisphere_emphasis (above/below and east/west from the angles), aspect_patterns (aspect matrix + detected patterns), harmonics. No extra credits. Absent from format='llm'.",
+  "items": {
+    "enum": [
+      "element_balance",
+      "hemisphere_emphasis",
+      "aspect_patterns",
+      "harmonics"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Add a whole family: major (Ceres, Pallas, Juno, Vesta), centaur (Chiron, Pholus), tno (Eris, Sedna, Makemake, Haumea, Quaoar, Orcus, Ixion, Varuna) or main_belt (12 large asteroids).",
+  "items": {
+    "enum": [
+      "major",
+      "centaur",
+      "tno",
+      "main_belt"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Sidereal system. Default lahiri. Only read when zodiac_type is `sidereal`.",
+  "enum": [
+    "lahiri",
+    "fagan_bradley",
+    "krishnamurti",
+    "raman",
+    "yukteshwar"
+  ],
+  "type": "string"
+}

Previous value: -"ISO 8601 datetime; zone required — a `Z`/±HH:MM suffix or the `timezone` argument. Date-only resolves to 12:00 UTC. Full rule: server `instructions`."New value: +"ISO 8601 datetime. A datetime with no zone is rejected; give a `Z` or ±HH:MM suffix, or a local time with the `timezone` argument. Date-only resolves to 12:00 UTC."

Added value: +{
+  "description": "Add each body's declination and out-of-bounds flag, plus parallel/contraparallel aspects (1.5° orb).",
+  "type": "boolean"
+}

Previous value: -[
-  "placidus",
-  "whole_sign",
-  "equal",
-  "koch",
-  "campanus",
-  "regiomontanus",
-  "porphyry",
-  "alcabitius",
-  "morinus"
-]New value: +[
+  "placidus",
+  "whole_sign",
+  "equal",
+  "koch",
+  "campanus",
+  "regiomontanus",
+  "porphyry"
+]

Previous value: -"Include Hermetic Lots / Arabic Parts in the natal response (routed as `options.include_hermetic_lots: true`). For a standalone lots-only payload without a full natal chart, use `/ephemeris/hermetic-lots` instead."New value: +"Include Hermetic Lots / Arabic Parts in the natal response (routed as `options.include_hermetic_lots: true`)."

Previous value: -"Include fixed-star positions in the natal response (routed as `configuration.fixed_star_options.include: true`). For a standalone fixed-stars payload without a full natal chart, use `/ephemeris/fixed-stars` instead."New value: +"Add fixed-star conjunctions (Regulus, Algol, Spica and the catalog) against the chart's bodies and angles. Honoured by the endpoint since 4.14.0; same zodiac frame as the chart."

Added value: +{
+  "description": "Add quincunx, semisextile, semisquare, sesquiquadrate, quintile and biquintile to the aspect grid. Off by default; minors use their own orbs, so this widens the grid without changing any major aspect.",
+  "type": "boolean"
+}

Previous value: -"When true, renders the natal chart wheel as an SVG and embeds it directly in the response. The chart image will display in the conversation alongside the data. Costs 2 additional credits on top of the base call cost."New value: +"When true, renders the natal chart wheel as an SVG and embeds it directly in the response. Costs 2 additional credits on top of the base call cost."

Previous value: -"Geographic latitude of birth location in decimal degrees (positive = North). Resolve from a place name with location_search; never recall coordinates from memory."New value: +"Geographic latitude of birth location in decimal degrees (positive = North)."

Added value: +{
+  "description": "Classify combustion, cazimi and under-beams for Moon–Saturn relative to the Sun.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Zodiac frame. Default tropical. `sidereal` subtracts the ayanamsa (~24°) from every longitude, so signs, dignities and element balance all move; aspects and house numbers do not. The response names the frame it used.",
+  "enum": [
+    "tropical",
+    "sidereal"
+  ],
+  "type": "string"
+}

Previous value: -"ISO 8601 datetime string, e.g. '1990-04-15T14:30:00' (local time at birth location). Include timezone offset if known, e.g. '1990-04-15T14:30:00-05:00'."New value: +"ISO 8601 datetime; zone required — a `Z`/±HH:MM suffix or the `timezone` argument. Date-only resolves to 12:00 UTC. Full rule: server `instructions`."

Previous value: -"Reserved for future use. Hermetic Lots / Arabic Parts are currently available via the dedicated /ephemeris/hermetic-lots endpoint."New value: +"Include Hermetic Lots / Arabic Parts in the natal response (routed as `options.include_hermetic_lots: true`). For a standalone lots-only payload without a full natal chart, use `/ephemeris/hermetic-lots` instead."

Previous value: -"Reserved for future use. Fixed star positions are currently available via the dedicated /ephemeris/fixed-stars endpoint."New value: +"Include fixed-star positions in the natal response (routed as `configuration.fixed_star_options.include: true`). For a standalone fixed-stars payload without a full natal chart, use `/ephemeris/fixed-stars` instead."

Previous value: -"Geographic latitude of birth location in decimal degrees (positive = North)."New value: +"Geographic latitude of birth location in decimal degrees (positive = North). Resolve from a place name with location_search; never recall coordinates from memory."

Previous value: -"IANA timezone name, e.g. 'America/Denver'. Use this if passing local time without a UTC offset in the datetime string."New value: +"IANA timezone (e.g. `America/Chicago`); required when the datetime is naive, ignored otherwise."