Was ist die Ebertin-Kosmobiologie?

Kosmobiologie ist eine astrologische Methode des 20. Jahrhunderts, entwickelt von Reinhold Ebertin in Deutschland. Sie reduziert die Chartdeutung auf harte Aspekte (Konjunktion, Opposition, Quadrat, Halbquadrat, Anderthalbquadrat), gelesen auf einer 22.5°-Scheibe — der 4. Harmonischen des Tierkreises. Mittelpunkte und die grafische Ephemeride sind zentrale Werkzeuge. Die Kosmobiologie betont Timing und Ereignisvorhersage stärker als psychologische Deutung. Der graphic-ephemeris-Endpoint liefert die Visualisierung, die Kosmobiologen seit Ebertins Kombination der Gestirneinflüsse (1940) nutzen.

Warum ist die 4. Harmonische bei 22.5° der Standard?

360° geteilt durch 16 ergibt 22.5°. Die 4. Harmonische bringt jeden harten Aspekt zum Vorschein: Konjunktion (0°), Halbquadrat (45°), Quadrat (90°), Anderthalbquadrat (135°) und Opposition (180°) fallen alle auf dasselbe 22.5°-Raster, weil jeder ein Vielfaches von 22.5° ist. Weiche Aspekte (Trigon, Sextil) nicht. Das macht die 22.5°-Scheibe zum Hartaspekt-Detektor — und genau darum hat die Kosmobiologie sie als De-facto-Standard für Timing-Arbeit übernommen. graphic-ephemeris hat aus diesem Grund harmonic=4 als Default.

Sind SVG-Layer für nachgelagertes Styling benannt?

Ja. Jeder /render/*-Endpoint gruppiert SVG-Elemente in benannte Layer: g id='axes', g id='aspects', g id='planets' auf dem Wheel; g id='bars', g id='ticks', g id='axis' auf Transit-Gantt; g id='planet-sun', g id='planet-moon' usw. auf graphic-ephemeris. Dein CSS oder nachgelagerter SVG-Prozessor kann jeden Layer per id ansprechen, ohne Geometrie zu parsen — Planeten umfärben, Aspekt-Layer ausblenden, Ticks umstylen. Die Namenskonvention bleibt versionsstabil.

Welche Chart-Themes gibt es?

Vier Presets: minimal (sauber hell), minimal-dark (sauberes dunkles Papier), astrocom (helle Version des astro.com-Looks) und astrocom-dark (dunkle Version des astro.com-Looks). Darunter funktionieren vier native Kerykeion-CSS-Themes: light, dark, dark-high-contrast, classic. Setze theme=astrocom-dark für den populärsten dunklen Profi-Look. Jedes Preset legt sich auf ein Kerykeion-CSS-Basis-Theme, damit Papierfarben und Tierkreissektoren sauber erben.

Kann ich ein Chart im Astrocom-Stil bekommen?

Ja — setze theme=astrocom (hell) oder theme=astrocom-dark. Das kombiniert vier Patches auf einmal: axis_stroke_width=3.0 für dicke AC/MC/DC/IC-Linien, axes_labels_position='outside' für Labels direkt hinter dem Wheel, house_numbers_position='center' für das Inner-Ring-Layout der Hausnummern und eine einheitliche axis_color (#444444 hell, #6b7280 dunkel). Der Output ahmt das astro.com- (Astrodienst-) Referenzchart nach, das traditionelle Astrologen seit über 30 Jahren lesen.

Wie passe ich die Achsendicke an?

Übergib axis_stroke_width als Float. 1.0 ist der Default (Kerykeions Pre-Patch-Verhalten). 3.0 entspricht dem astrocom-Preset und der astro.com-Referenz. 5.0+ funktioniert für Wandposter-Ausgabe. Der Parameter wirkt nur auf die vier Achsen-Cusps (AC bei Index 0, IC bei 3, DC bei 6, MC bei 9). Andere Häuserspitzen bleiben bei 1px gestrichelt mit 0.4 Deckkraft. Achsenlinien rendern durchgezogen bei 0.9 Deckkraft, wenn dieser Parameter gesetzt ist.

Kann ich einzelne Planeten aus Aspektlinien ausblenden?

Ja — übergib hide_points_in_aspects als Array von Punktnamen, z. B. ['Chiron','Mean_Lilith','Mean_South_Node']. Diese Punkte bleiben auf dem Wheel sichtbar, aber der Post-Processor entfernt sie aus jeder Aspektlinie im SVG und löscht ihre Zeile aus dem Aspektgitter. Nützlich für Embeds, in denen du eine aufgeräumte Aspekt-Sicht willst, ohne kleinere Körper komplett aus dem Chart zu entfernen. Der Post-Processor läuft nach Kerykeions makeTemplate(), das Timing ist also konsistent.

Rendert die API den Glückspunkt?

Ja. Füge 'part_of_fortune' zu active_points hinzu, und drei Dinge passieren: die Tag-/Nachtformel berechnet die Position (ASZ + Mond - Sonne für Taggeburten, ASZ + Sonne - Mond für Nachtgeburten), der eingekreiste Kreuz-Glyph rendert auf dem Wheel über das neue Part_of_Fortune-Symbol in den SVG-defs, und eine Glückspunkt-Zeile erscheint im Aspektgitter. Wir berechnen Glückspunkt-Aspekte selbst, weil der Upstream-Kerykeion den Körper nicht kennt. Funktioniert heute für Natal- und External-Natal-Charttypen.

Unterstützt ihr Planeten der Hamburger Schule / uranische Planeten?

Ja — alle acht uranischen Hypothesen rendern nativ: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon. Füge die gewünschten Namen zu active_points hinzu, und der settings_builder injiziert für jeden den Glyph und die Farb-Konfig. Sie tauchen auf dem Wheel und im Aspektgitter auf wie jeder andere Körper. Kombiniere mit hide_points_in_aspects, um die Glyphen ohne Aspekt-Rauschen zu zeichnen — entspricht dem Notationsstil der Hamburger Schule.

Kann ich Synastrie-, Transit- und Composite-Charts rendern?

Ja — ein Endpoint, vier Chart-Typen: Natal, Synastrie, Transit, Composite. Das Theme-System gilt für alle, also liefert theme=astrocom-dark ein dunkles Synastrie-Chart im Astrocom-Stil mit den Namen beider Subjekte in der Dual-Chart-Überschrift. Die Sekundärsubjekte von Synastrie und Transit bekommen ebenfalls die gepatchten Hausnummern und (wenn konfiguriert) ihren eigenen Glückspunkt-Glyph. Cross-Subject-Glückspunkt-Aspekte stehen auf der Roadmap.

Wo landen die Hausnummern bei house_numbers_position='center'?

Hausnummern rendern in einem inneren Ring bei 78% des Wheel-Radius (r * 0.78), mit 10px Schrift und 0.7 fill-opacity. Das ist das astro.com-Layout. Der Default ('near_cusp' oder null) behält sie am ursprünglichen Drop-in-Offset neben jeder Häuserspitze mit 14px Schrift und 0.6 fill-opacity. Für Synastrie- und Transit-Charts gilt dieselbe Verkleinerung für die Nummern des Sekundärsubjekts — die Transit-spezifische fill-opacity-Logik (0 für Transit, 0.4 sonst) bleibt erhalten.

Was macht hide_axes_visually?

Übergib ein Array von Achsennamen (z. B. ['IC','DC']), und diese Achsenlinien werden aus dem SVG entfernt, während die zugrundeliegenden Berechnungen intakt bleiben. Die Winkel sind weiterhin in den Chart-Daten, Aspektberechnungen und Hauspositionen bleiben korrekt — nur die sichtbare Linie ist weg. Nützlich für minimale Embeds, in denen du Planeten und Zeichen ohne das Kreuz der Kardinalachsen zeigen willst. Derzeit ein Stub-Level-Post-Processor; vollständige achsenspezifische Steuerung steht auf der Roadmap.

Wie schnell ist das Rendering?

Typische Renderzeit bleibt unter 500 ms, Worst Case unter 1 Sekunde. Der Vendored-Kerykeion-Codepfad fügt minimalen Overhead hinzu — die Patches sind meist konditionale Branches in bestehenden Draw-Funktionen plus ein Post-Processor-Pass auf dem SVG-String. Die Cold-Start-Zeit hängt vom Laden der Swiss-Ephemeris-Dateien ab. Edge-Caching deckt identische Requests ab, also kommt wiederholte Chart-Generierung für dieselben Geburtsdaten quasi sofort zurück.

Welche Ausgabeformate bekomme ich?

SVG ist das primäre Ausgabeformat — alles, was der Renderer macht, ist SVG-nativ. PNG, JPEG, WebP und PDF sind über Format-Konvertierungs-Endpoints verfügbar. SVG ist das, was du für Web-Embeds willst, weil es ohne Qualitätsverlust skaliert und klein ist. Nutze PNG oder JPEG, wenn du E-Mail-Client-Kompatibilität brauchst (Outlook). PDF erhält Vektorqualität für den Druck. WebP ist bei gleicher visueller Qualität etwa 30% kleiner als PNG.

Kann ich Theme-Einstellungen pro Request überschreiben?

Ja — übergib ein custom_settings dict, um jede Chart-Einstellung über das Theme hinaus zu überschreiben. Das Merging ist flach: Theme-Defaults laden zuerst, dein custom_settings dict überschreibt oben drauf, das Ergebnis fließt in Kerykeion. Du kannst auch einzelne Patch-Parameter (axis_stroke_width, axes_labels_position usw.) direkt übergeben — die gewinnen immer gegen Theme-Defaults. Ein Theme ist ein Startpunkt, kein Zwangsrahmen.

Was kostet die Chart Rendering API?

Chart-Rendering kostet 10 Credits pro Request. Der Ultra-Plan startet bei 37$/Monat für 55.000 Credits (etwa 5.500 Charts). Der Business-Plan ist 99$/Monat für 220.000 Credits (etwa 22.000 Charts). Der Free-Tier enthält kein Chart-Rendering — nur Daten-Endpoints. Enterprise-Pläne bekommen dedizierte Infrastruktur und unbegrenzte Generierung.

Welche Häusersysteme werden unterstützt?

23 Häusersysteme funktionieren mit jedem Theme und jedem Chart-Typ: Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyrius, Topozentrisch, Alcabitius, Krusinski, Sripati und 11 weitere. Die Häusersystem-Wahl ist unabhängig vom Theme — du kannst ein Whole-Sign-Chart im astrocom-dark-Theme rendern, und die Cusps zeichnen korrekt. Berechnungen nutzen Swiss Ephemeris (NASA-JPL-Daten).

Wie präzise sind die zugrundeliegenden Berechnungen?

Sub-Bogensekunden-Genauigkeit für jeden Planeten, Asteroiden und hypothetischen Körper. Der Renderer ist eine dünne Schicht über Swiss Ephemeris, das NASA-JPL-Ephemeris-Daten nutzt — dieselbe Quelle, auf die sich professionelle Astronomiesoftware verlässt. Theme- und Customization-Parameter wirken nur auf die visuelle Ausgabe; die Mathematik ist identisch, egal welches Theme du wählst.

Gibt es Timing-Wheels (Altersbänder, Bi-Wheel)?

Ja — SVG-Timing-Wheels liegen unter /svg/timing/* als separate Endpoints. Das Altersbänder-Wheel rendert Lebensphasen-Ringe um ein Natal-Chart. Der Bi-Wheel-Renderer überlagert ein Chart über einem anderen (z. B. Transit über Natal) mit beiden Ringen sichtbar. Sie teilen denselben Vendored-Kerykeion-Core wie der Standard-chart_svg-Endpoint, also gelten Theme-Presets und Patch-Parameter.

Wie integriere ich das in meine App?

Es ist eine REST-API. Schicke Geburtsdaten (Datum, Uhrzeit, Ort), dazu Theme und beliebige Customization-Params, und du bekommst einen SVG-String zurück. Funktioniert mit jeder Sprache — curl, JavaScript, Python, Ruby, PHP, Go. Fürs Web kippst du das SVG direkt in die Seite. Für Mobile-Apps fordere PNG oder WebP über die Format-Konvertierungs-Endpoints an. Gleiche Auth, gleiche Rate-Limits, gleiches Credit-Modell über alle Chart-Typen.

Gibt es Rate-Limiting auf die Chart-Generierung?

Rate-Limits hängen vom Plan ab. Ultra (55.000 Credits/Monat) deckt die meisten unabhängigen Plattformen ab. Business (220.000 Credits) passt zu skalierenden Apps. Enterprise-Pläne laufen auf dedizierter Infrastruktur ohne Monatscap. Bei 10 Credits pro Chart gibt dir Ultra ~5.500 Charts/Monat und Business ~22.000 — die Grenze ist der Credit-Pool, kein Per-Second-Rate-Limit.

Anpassbare SVG-Charts

Chart Rendering API: SVG in Astrocom-Qualität, deine Regeln

Wir haben Kerykeion v4.26.3 vendort, damit wir es patchen können.

Ergebnis: 3 Theme-Presets, ein Astrocom-Preset, 10+ Chart-Parameter, Glückspunkt, uranische Planeten und Natal/Synastrie/Transit/Composite aus einem Endpoint.

Demo ansehen

Gantt

Transit-Timing-Balken

22.5°

Ebertin 4. Harmonische

Astrocom

Theme-Presets

10+

Custom-Parameter

2,1 Mio.+ Charts monatlich gerendert

Von 750+ Plattformen weltweit genutzt

Swiss-Ephemeris-Präzision garantiert

Forecasting-Dashboards brauchen professionelle Timing-Views — Gantt-Balken und grafische Ephemeride — nicht nur Natal-Wheels
Kerykeion liefert von Haus aus fixe Ausgaben: gleiche Achsen, gleiche Fonts, gleicher Look auf jeder Seite
Keine Möglichkeit, die Astrocom-Ästhetik (Astrodienst) nachzubilden, die traditionelle Astrologen erwarten
Aspektlinien stapeln sich — du kannst einzelne Punkte nicht ausblenden, ohne sie aus dem Wheel zu entfernen
Glückspunkt fehlt im Upstream-Renderer (kein Glyph, keine Aspektzeile)
Achsenlinien (AC, MC, DC, IC) rendern alle gleich — keine Möglichkeit, sie dicker zu machen oder die Beschriftung zu verschieben
Hamburger Schule und uranische Astrologen können ihre hypothetischen Planeten nicht darstellen
Hausnummern festgenagelt an einer Stelle; kein Inner-Ring-Layout möglich
Kosmobiologie-Workflows brauchen das Ebertin-22.5°-Raster der 4. Harmonischen; die meisten APIs liefern es nicht

Transformiere mit

/api/v3/render/* ist der konsolidierte Namespace — Chart-Wheels, Transit-Gantt, Grafische Ephemeride liegen als Geschwister nebeneinander
/render/transit-gantt: Balkendiagramm der Aspekt-Timing-Fenster für Forecasting-Dashboards
/render/graphic-ephemeris: Ebertin-Style 4. Harmonische, 22.5°-Raster, Planeten als durchgehende Linien
Benannte SVG-Layer (g id='axes', g id='aspects', g id='planets') für nachgelagertes CSS-Styling
3 Theme-Presets: minimal, minimal-dark, astrocom-dark — wähle den Look mit einem Parameter
Astrocom-Preset: dickere Achsen, AC/MC/DC/IC-Beschriftung außen, zentrierte Hausnummern — sofort einsatzbereit
10+ Chart-Parameter: axis_stroke_width, axes_labels_position, house_numbers_position, axis_color und mehr
hide_points_in_aspects: ausgewählte Planeten aus Aspektlinien entfernen, aber im Wheel behalten
Glückspunkt + 8 uranische Hypothesen rendern serverseitig
Natal, Synastrie, Transit, Composite — gleicher Chart-Endpoint, gleiches Theme-System

Chart-Rendering-Performance

Vendorter Kerykeion v4.26.3 mit unserer Customization-Schicht

Theme-Presets

10+

Customization-Parameter

SVG (nachbearbeitet)

Primäres Ausgabeformat

<500ms

Renderzeit

Wheel, Transit-Gantt, Grafische Ephemeride

Render-Endpoints

2,1 Mio.+

Renderings pro Monat

Anpassbares SVG, vom Theme bis zur einzelnen Achse

3 Presets, 10+ Parameter, Output in Astrocom-Qualität

Transit-Gantt-SVG

/render/transit-gantt zeichnet horizontale Balken für Aspekt-Timing-Fenster. Zeilen sind Planetenpaare, Spalten Datumsangaben, exakte Treffer als Ticks im Balken.

Endpoint: /api/v3/render/transit-gantt — farbcodiert nach Aspekttyp, benannte SVG-Layer

Grafische Ephemeride SVG

/render/graphic-ephemeris zeichnet Planeten als durchgehende Linien auf dem Ebertin-22.5°-Raster der 4. Harmonischen. Linientreffen markieren harte Aspekte nach Kosmobiologie-Logik.

Endpoint: /api/v3/render/graphic-ephemeris — Harmonische 1/2/4/8/16, Default-Fenster 12 Monate

Ebertin-Standard 4. Harmonische

Das 22.5°-Raster ist seit den 1940ern der De-facto-Standard der Kosmobiologie. Wir liefern ihn als Default-Harmonische auf graphic-ephemeris.

harmonic=4 Default; pro Request umschaltbar auf 1, 2, 8, 16

Benannte SVG-Layer

Jeder Render-Output gruppiert Elemente in benannte SVG-Layer (g id='axes', 'aspects', 'planets', 'bars', 'ticks'), damit nachgelagertes CSS ohne Geometrie-Parsing umstylen kann.

Stabile id-Namenskonvention über alle /render/*-Endpoints

/render/*-Namespace

Ein Namespace für Visualisierungen: Chart-Wheels, Transit-Gantt, Grafische Ephemeride. Alte /svg/timing/*-Pfade funktionieren weiter für Rückwärtskompatibilität.

Konsolidiert unter /api/v3/render/* — Legacy /svg/timing/* aliased

Astrocom-Theme-Preset

Ein Parameter (theme=astrocom) liefert den astro.com-Chart-Look — dicke Achsen, AC/MC/DC/IC-Labels außen, zentrierte Hausnummern, einheitliche Achsenfarbe.

Kombiniert PATCH-01, PATCH-02, PATCH-03, PATCH-04 mit Achsenfarbe #444444

Astrocom-Dark-Theme

Dunkles Gegenstück zu Astrocom — gleiche strukturelle Patches, dunkles Papier, einheitliche Achsenfarbe abgestimmt auf dunkle UIs.

axis_color=#6b7280, basiert auf Kerykeion dark.css

Minimal-Theme

Sauberes helles Theme mit gedämpften Aspektlinien und schlichten Tierkreissektoren — für Embeds, die nicht gegen die Seite arbeiten sollen.

Basiert auf classic.css, keine strukturellen Patches angewendet

Minimal-Dark-Theme

Derselbe minimale Look auf dunklem Papier — passt zu dunkler UI ohne Extra-CSS.

Erbt Papier- und Tierkreissektor-Farben aus dark.css

axis_stroke_width-Parameter

Steuere, wie dick die AC/MC/DC/IC-Häuserspitzen rendern. 1.0 Default, 3.0 imitiert astro.com, 5.0 für Wandposter.

Float — wirkt nur auf Achsen-Cusps (Indizes 0, 3, 6, 9), durchgezogene Linie bei 0.9 Deckkraft

axes_labels_position-Parameter

Platziere AC/MC/DC/IC-Labels außerhalb des Wheels (fett), in einem kleinen inneren Ring (mittlere Strichstärke) oder verstecke sie komplett.

Akzeptiert 'outside' | 'center' | null — Koordinatenmathe nutzt Cusp-Offset-Formel wieder

house_numbers_position-Parameter

Rendere Hausnummern in einem inneren Ring bei 78% Radius (astro.com-Stil) oder neben jeder Häuserspitze (Default).

Akzeptiert 'center' | 'near_cusp' — gilt auch für Synastrie/Transit-Sekundärsubjekt

Glückspunkt-Glyph

'part_of_fortune' zu active_points hinzufügen — der eingekreiste Kreuz-Glyph rendert auf dem Wheel und eine Glückspunkt-Zeile erscheint im Aspektgitter.

Tag-/Nachtformel, id=23, damit indexierte Upstream-Zugriffe stabil bleiben

hide_points_in_aspects

Übergib ein Array von Punktnamen, um sie aus Aspektlinien und dem Aspektgitter zu entfernen — ohne die Glyphen aus dem Wheel zu nehmen.

Post-Processor auf dem SVG-String — läuft nach Kerykeion makeTemplate()

hide_axes_visually

Behalte AC/MC/DC/IC in der Berechnung, aber verstecke die Linien im SVG. Nützlich für aufgeräumte Embed-Views.

Post-Processor auf Stub-Ebene — akzeptiert Array von Achsennamen

Hypothetische Planeten

8 uranische Hypothesen / Hamburger Schule — Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulcanus, Poseidon — rendern mit eigenen Glyphen.

Zu active_points hinzufügen; settings_builder injiziert Glyph- + Farb-Konfig

Dual-Chart-Überschrift

Synastrie- und Transit-Charts behalten ihre Doppel-Subjekt-Überschrift über den Renderer-Refactor hinweg — beide Namen, beide Geburtsdaten rendern über dem Wheel.

Erhalten durch die ChartRenderer-Fassade in app/services/chart_renderer/renderer.py

Composite-Chart-Typ

Mittelpunkt-Composite-Charts rendern über denselben Endpoint mit demselben Theme-System.

chart_type='Composite' auf der vereinheitlichten ChartRenderer-Fassade

Swiss-Ephemeris-Präzision

NASA-JPL-Ephemeris-Daten treiben jede Planetenposition, unabhängig vom Theme oder Chart-Typ.

Sub-Bogensekunden-Genauigkeit für alle Himmelskörper

23 Häusersysteme

Placidus, Whole Sign, Equal House, Koch, Regiomontanus, Campanus, Morinus, Porphyrius, Topozentrisch und 14 weitere.

Häusersystem-Auswahl unabhängig vom Theme

Custom Settings Override

Übergib ein custom_settings dict, um jedes Chart-Feld pro Request zu überschreiben — Farben, Glyph-Farben, Papierfarben, Tierkreisfarben.

Wird über die Theme-Defaults gemerged; Caller gewinnt

Was ist die Chart Rendering API? Die Vendored-Kerykeion-Story

3 Theme-Presets, 10+ Customization-Parameter, Astrocom-Qualität, Glückspunkt, uranische Planeten

Die Chart Rendering API verwandelt Geburtsdaten in ein anpassbares SVG-Astrologiechart. Wir haben Kerykeion v4.26.3 in unsere Codebase vendort, damit wir es patchen können — das brachte uns dickere Achsen, Achsenbeschriftung außerhalb des Rings, zentrierte Hausnummern, einen Glückspunkt-Glyph, Support für hypothetische Planeten und einen Post-Processor, der ausgewählte Punkte aus Aspektlinien entfernen kann. Du bekommst drei Theme-Presets ab Werk (minimal, minimal-dark, astrocom-dark), 10+ Chart-Parameter und einen Endpoint, der Natal-, Synastrie-, Transit- und Composite-Charts liefert. Die Renderzeit bleibt unter 500 ms.

Warum haben wir Kerykeion v4.26.3 vendort statt es zu importieren?

Kerykeion ist eine starke Open-Source-Chart-Library, aber der Upstream-Renderer ist abgeriegelt: fixe Achsenbreiten, kein Glückspunkt, keine Hooks zum Ausblenden von Punkten aus Aspektlinien und kein Weg für hypothetische Planeten der Hamburger Schule.

Wir haben die relevanten Module in app/vendor/kerykeion_charts/ in der Version 4.26.3 kopiert, die Import-Oberfläche kompatibel gehalten und eine PATCHES.md angelegt, die jede Änderung trackt.

Vier nummerierte Patches (PATCH-01 bis PATCH-04) plus eine Glückspunkt-Injektion decken die neuen Parameter ab.

Die zwei Themes, die mit der Upstream-Library kommen (light, dark, dark-high-contrast, classic), funktionieren weiter als Basis-Layer.

Unsere Presets legen sich auf diese CSS-Variablen, damit Dark-Mode-Papierfarben, Tierkreissektor-Farben und Glyph-Farben sauber erben.

Der Vendor-Ansatz macht jedes Upstream-Upgrade zum Code-Review — keine überraschenden Breaking Changes in Produktion.

Vendorter Kerykeion v4.26.3 — wir kontrollieren die Patch-Line

1 min read

Welches Theme soll ich nehmen: minimal, minimal-dark oder astrocom-dark?

Drei Presets decken die meisten Fälle ab.

Minimal ist ein sauberes helles Theme: gedämpfte Aspektlinien, schlichte Tierkreissektoren, helles Papier.

Nutze es für Blog-Embeds, Social Cards und Apps, die ein Chart wollen, das nicht gegen den Rest der Seite arbeitet.

Minimal-dark dreht das Papier auf Dunkelgrau, hält die Aspektfarben lesbar und passt zu dunklen UIs.

Astrocom-dark ist das dunkle Gegenstück zum Astrocom-Preset: dickere Achsen, AC/MC/DC/IC-Beschriftung außerhalb des Rings, zentrierte Hausnummern, einheitliche Achsenfarbe (#6b7280) — im Grunde der Astrodienst-Chart-Look in dunkler Verpackung.

Setze theme=astrocom für die helle Version, theme=astrocom-dark für dunkel, theme=minimal für einen sauberen hellen Look oder theme=minimal-dark für dasselbe auf dunkel.

Du kannst jeden zugrundeliegenden Parameter pro Request überschreiben — ein Theme ist ein Startpunkt, kein Käfig.

3 Presets: minimal, minimal-dark, astrocom-dark — plus astrocom (hell)

1 min read

Was ist das Astrocom-Preset und warum ist es wichtig?

Astrocom ist der Look, den du auf astro.com siehst — das Astrodienst-Chart, das professionelle Astrologen seit den 90ern lesen.

Es ist der De-facto-Referenzstil der westlichen Tradition: dicke schwarze Achsenlinien, AC/MC/DC/IC-Labels direkt außerhalb des Wheels, Hausnummern in einem inneren Ring statt neben den Häuserspitzen und eine einheitliche neutrale Achsenfarbe, damit die vier Kardinalrichtungen nicht gegeneinander arbeiten.

Das astrocom-Preset kombiniert PATCH-01 (axis_stroke_width=3.0), PATCH-02 (axes_labels_position='outside'), PATCH-03 (house_numbers_position='center') und PATCH-04 (axis_color='#444444' für hell, '#6b7280' für dunkel).

Setze theme=astrocom und du bekommst alle vier auf einmal.

Für Plattformen, die sich an traditionelle Astrologen richten, ist allein dieses Preset oft der Grund, warum Teams wechseln.

Das classic-Kerykeion-Theme hat achsenspezifische Farben (orange/schwarz/blau/rot), die mit einem zurückhaltenderen Layout kollidieren — astrocom vereinheitlicht sie.

Astrocom-Preset = astro.com-Referenz-Look mit einem Parameter

1 min read

Wie funktionieren die Per-Element-Parameter?

Fünf Parameter lassen dich das Preset pro Request überschreiben.

axis_stroke_width nimmt einen Float — 1.0 ist Default, 3.0 ahmt astro.com nach, 5.0 ist Wandposter-dick.

axes_labels_position akzeptiert 'outside' (direkt hinter dem Wheel, fett), 'center' (kleiner innerer Ring, mittlere Strichstärke) oder null (keine Achsenbeschriftung — Kerykeions Pre-Patch-Verhalten).

house_numbers_position nimmt 'center' (kleiner innerer Ring bei 78% Radius, 10px Schrift, 0.7 Deckkraft) oder 'near_cusp' (Default, 14px, neben jeder Häuserspitze).

hide_points_in_aspects nimmt ein Array von Punktnamen: übergib ['Chiron','Lilith'] und Chiron und Lilith bleiben im Wheel, verschwinden aber aus jeder Aspektlinie und aus der Aspektgitter-Zeile.

hide_axes_visually nimmt ein Array von Achsennamen: der AC bleibt in der Berechnung, aber es wird keine Linie gezeichnet — nützlich für Embeds, wenn du ein aufgeräumtes Wheel willst.

axis_color überschreibt die achsenspezifischen CSS-Variablen mit einer einheitlichen Farbe.

5 Patch-Parameter: axis_stroke_width, axes_labels_position, house_numbers_position, hide_points_in_aspects, hide_axes_visually

1 min read

Was ist der /render/transit-gantt-Endpoint?

/api/v3/render/transit-gantt ist ein SVG-Renderer für Aspekt-Timing-Fenster.

Statt eines Wheels bekommst du ein Balkendiagramm: Zeilen sind Planetenpaare (z.

Transit-Saturn zu Natal-Sonne), Spalten sind Datumsangaben, und jeder Balken markiert das Fenster, in dem der Aspekt im Orbis liegt.

Exakte Treffer zeigen sich als vertikale Ticks im Balken.

Das Ergebnis ist die Forecasting-Dashboard-Sicht, die Astrologen und Timing-Apps brauchen — wann startet dieser Transit, wann steht er exakt, wann endet er.

Balken sind nach Aspekttyp farbcodiert (Konjunktion, Quadrat, Opposition, Trigon, Sextil), und das SVG liefert benannte Layer (g id='bars', g id='ticks', g id='axis') mit, sodass nachgelagertes CSS umstylen kann, ohne Geometrie zu parsen.

Spec in docs/SPECS/06_timing_visualizations.md §A, Renderer in app/services/render/transit_gantt.py.

Zeitraum, einbezogene Aspekte und Orbis-Toleranzen sind Request-Parameter.

/render/transit-gantt — Balken-SVG für Aspekt-Timing-Fenster

1 min read

Was ist der /render/graphic-ephemeris-Endpoint?

/api/v3/render/graphic-ephemeris ist die grafische Ephemeride im Ebertin-Stil — 4.

Harmonische, ein Klassiker der Kosmobiologie seit den 1940ern.

Die X-Achse ist Zeit.

Die Y-Achse ist das 22.5°-Raster (360° / 16 — die 4.

Harmonische, die vierte Teilung des 22.5°-Grundscheibens).

Jeder Planet ist eine durchgehende Linie, die bei jedem Überschreiten von 22.5° umbricht.

Wenn sich zwei Linien auf dem Raster treffen, ist das nach der Logik der 4.

Harmonischen ein harter Aspekt: Konjunktion, Opposition, Quadrat oder Halbquadrat.

Kosmobiologen lesen diese Treffen als Ereignisdaten.

Harmonische-Optionen: 1 (Roh-Länge), 2, 4 (Ebertin-Default), 8 oder 16.

Standardfenster ist 12 Monate, konfigurierbar.

Output ist SVG mit benannten Layern (g id='planet-sun', g id='planet-moon' usw.), sodass jede Planetenlinie per CSS ansprechbar ist.

Spec: docs/SPECS/06_timing_visualizations.md §B.

Renderer: app/services/render/graphic_ephemeris.py.

/render/graphic-ephemeris — Ebertin 4. Harmonische, 22.5°-Raster

1 min read

Use Cases

Plattformen für traditionelle Astrologen

theme=astrocom liefert den astro.com-Chart-Look, dem Profis bereits vertrauen

Moderne Dark-Mode-Apps

theme=minimal-dark oder astrocom-dark passt zu dunkler UI ohne Extra-CSS

Hellenistische Charts mit Glückspunkt

'part_of_fortune' zu active_points hinzufügen — Glyph und Aspektzeile rendern automatisch

Uranisch / Hamburger Schule

8 hypothetische Planeten (Cupido bis Poseidon) rendern mit eigenen Glyphen

Aspekt-fokussierte Embeds

hide_points_in_aspects entfernt kleinere Körper aus Linien, ohne das Wheel zu verändern

Synastrie, Transit, Composite

Ein Endpoint, gleiches Theme-System, Dual-Chart-Überschrift bleibt über alle Typen erhalten

Technical Specifications

Render-Namespace	/api/v3/render/* (chart, transit-gantt, graphic-ephemeris)
Transit-Gantt-Zeitraum	Default 12 Monate; konfigurierbares Start/Ende
Grafische Ephemeride Harmonische	1, 2, 4 (Ebertin-Default), 8 oder 16
SVG-Layer-Benennung	g id='axes' \| 'aspects' \| 'planets' \| 'bars' \| 'ticks'
Renderer-Basis	Vendorter Kerykeion v4.26.3 + 4 nummerierte Patches
Theme-Presets	minimal, minimal-dark, astrocom, astrocom-dark
Native Kerykeion-Themes	light, dark, dark-high-contrast, classic
axis_stroke_width	Float — 1.0 Default, 3.0 astrocom, bis 5.0
axes_labels_position	outside \| center \| null (keine Labels)
house_numbers_position	center (innerer Ring bei r*0.78) \| near_cusp (Default)
axis_color	Hex-String — überschreibt achsenspezifische CSS-Variablen
hide_points_in_aspects	Array von Punktnamen — Post-Processor entfernt sie aus Aspektlinien
hide_axes_visually	Array von Achsennamen — in Berechnung erhalten, im SVG entfernt
active_points	Inklusive part_of_fortune + 8 uranische Hypothesen
Chart-Typen	Natal, Synastrie, Transit, Composite (ein Endpoint)
Ausgabeformate	SVG primär; PNG, JPEG, WebP, PDF per Konvertierung
Renderzeit	<500ms typisch, <1s Worst Case
Häusersysteme	23 unterstützt (Placidus, Whole Sign, Koch usw.)
Rechenpräzision	Swiss Ephemeris (NASA-JPL-Daten)
Custom Settings Override	custom_settings dict — jedes Feld, pro Request

Vendorter Kerykeion + Patches vs. Stock-Kerykeion vs. geschlossene Konkurrenz

Feature	Astrology API	Others
Visualisierungs-Umfang	Wheel + Transit-Gantt + Grafische Ephemeride (3 Render-Endpoints)	Nur Natal-Wheels
Source-Basis	Vendorter Kerykeion v4.26.3 — wir kontrollieren die Patch-Line	Stock pip install ODER geschlossenes SDK
Astrocom-Stil-Output	theme=astrocom — ein Parameter	Nicht verfügbar; festgenagelter Chart-Stil
Theme-Presets	minimal, minimal-dark, astrocom, astrocom-dark	Fixer Look oder 1-2 Themes
Achsenstrichstärke	Float-Param, 1.0 bis 5.0+	Hardcoded 1px
Position der Hausnummern	center \| near_cusp	Nur near_cusp
Punkte aus Aspekten ausblenden	hide_points_in_aspects Array — Post-Processor	Alles oder nichts; ganz aus Chart entfernen
Glückspunkt	Formel + Glyph + Aspektgitter-Zeile	Nicht unterstützt (Kerykeion); variiert anderswo
Hypothetische Planeten	8 uranische (Cupido bis Poseidon) nativ	Selten unterstützt
Chart-Typen	Natal, Synastrie, Transit, Composite — ein Endpoint	Oft getrennte Endpoints oder Libraries
Upstream-Upgrade-Pfad	Code-Review bei jedem Bump — PATCHES.md getrackt	Stille Breaking Changes beim pip-Upgrade
Renderzeit	<500ms typisch	1-3 Sekunden üblich

Transit-Gantt-SVG

Balkendiagramm der Aspekt-Timing-Fenster

Grafische Ephemeride SVG

Ebertin-Style 4. Harmonische, 22.5°-Raster

Natal API

Geburtschart-Berechnungen, die den Renderer antreiben

Glückspunkt

Hellenistisches Lot — Formel, Glyph, Aspektzeile

Hypothetische Planeten

Hamburger Schule / Uranisch — 8 Hypothesen nativ

Synastrie-API

Beziehungs-Charts mit gleichem Theme-System

Composite-API

Mittelpunkt-Composite-Charts für Paare

Timing-API

Altersbänder und Bi-Wheel-Timing-SVGs

Transit-API

Live-Transite über einem Natal-Wheel

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Einfache, Transparente Preise

Kostenlos starten, skalieren Sie mit Ihrem Wachstum. Keine versteckten Gebuhren.

Immer Kostenlos

Kostenlos starten

Perfekt zum Lernen, Testen und fur kleine personliche Projekte

50 API-Aufrufe/Monat

Basis-Geburtshoroskope

5 Haussysteme

Community-Support

Pro

11€/Monat

Fur kleine Apps und personliche Projekte

Alle Basis-Endpoints
12 Haussysteme
E-Mail-Support

Bester Wert

Pro Plus

21€/Monat

Fur wachsende Apps und mittleren Traffic

Alle erweiterten Endpoints
18 Haussysteme
KI-Interpretationen
Prioritats-E-Mail-Support

Ultra

37€/Monat

Fur professionelle Astrologie-Anwendungen

Credit math ↓

Alle Premium-Endpoints
23 Haussysteme
Erweiterte KI-Interpretationen
Priority-Support

Hochvolumen-Plane

Fur Enterprise-Anwendungen

Business

99€/Monat

Fur Hochvolumen-Anwendungen

Credit math ↓

ALLE Endpoints
White-Label-bereit
Individuelles KI-Feintuning
Telefon-Support

UNBEGRENZT

Enterprise

399€+pro Monat

Unbegrenzte Anfragen mit dedizierter Infrastruktur

Dedizierte Server-Infrastruktur
Unter 300ms garantiert
24/7 dedizierter Support
99,99% Uptime-SLA

Alle Plane beinhalten umfassende Dokumentation und SDKs

Fragen? Sprechen Sie mit unserem Team

Häufig gestellte Fragen zur Chart Rendering API

Themes, Patches, Glückspunkt, hypothetische Planeten und alles dazwischen

Drei SVG-Renderer, ein Namespace

Chart-Wheels, Transit-Gantt-Balken und grafische Ephemeride auf dem Ebertin-22.5°-Raster der 4. Harmonischen — alles unter /api/v3/render/*. Astrocom-Themes, benannte SVG-Layer, Glückspunkt, uranische Planeten.

Kostenlos starten Doku ansehen

Transit-Gantt + grafische Ephemeride SVG

Ebertin 4. Harmonische, 22.5°-Raster

Benannte SVG-Layer für CSS-Styling

<500ms Renderzeit

Verfügbar ab Ultra-Plan und höher

Chart Rendering API: SVG in Astrocom-Qualität, deine Regeln

Natal-Wheels allein reichen für Forecasting-Dashboards nicht

Ein Render-Namespace: Wheels, Gantt-Balken, Grafische Ephemeride

Chart-Rendering-Performance

Anpassbares SVG, vom Theme bis zur einzelnen Achse

Transit-Gantt-SVG

Grafische Ephemeride SVG

Ebertin-Standard 4. Harmonische

Benannte SVG-Layer

/render/*-Namespace

Astrocom-Theme-Preset

Astrocom-Dark-Theme

Minimal-Theme

Minimal-Dark-Theme

axis_stroke_width-Parameter

axes_labels_position-Parameter

house_numbers_position-Parameter

Glückspunkt-Glyph

hide_points_in_aspects

hide_axes_visually

Hypothetische Planeten

Dual-Chart-Überschrift

Composite-Chart-Typ

Swiss-Ephemeris-Präzision

23 Häusersysteme

Custom Settings Override

Was ist die Chart Rendering API? Die Vendored-Kerykeion-Story

Warum haben wir Kerykeion v4.26.3 vendort statt es zu importieren?

Welches Theme soll ich nehmen: minimal, minimal-dark oder astrocom-dark?

Was ist das Astrocom-Preset und warum ist es wichtig?

Wie funktionieren die Per-Element-Parameter?

Was ist der /render/transit-gantt-Endpoint?

Was ist der /render/graphic-ephemeris-Endpoint?

Use Cases

Plattformen für traditionelle Astrologen

Moderne Dark-Mode-Apps

Hellenistische Charts mit Glückspunkt

Uranisch / Hamburger Schule

Aspekt-fokussierte Embeds

Synastrie, Transit, Composite

Technical Specifications

Vendorter Kerykeion + Patches vs. Stock-Kerykeion vs. geschlossene Konkurrenz

Verwandte Astrologie-APIs

Transit-Gantt-SVG

Grafische Ephemeride SVG

Natal API

Glückspunkt

Hypothetische Planeten

Synastrie-API

Composite-API

Timing-API

Transit-API

References & Standards

Einfache, Transparente Preise

Immer Kostenlos

Pro

Pro Plus

Ultra

Hochvolumen-Plane

Business

Enterprise

Häufig gestellte Fragen zur Chart Rendering API

Was ist der /render/transit-gantt-Endpoint?

Was ist der /render/graphic-ephemeris-Endpoint?

Was ist die Ebertin-Kosmobiologie?

Warum ist die 4. Harmonische bei 22.5° der Standard?

Sind SVG-Layer für nachgelagertes Styling benannt?

Welche Chart-Themes gibt es?

Kann ich ein Chart im Astrocom-Stil bekommen?

Wie passe ich die Achsendicke an?

Kann ich einzelne Planeten aus Aspektlinien ausblenden?

Rendert die API den Glückspunkt?

Unterstützt ihr Planeten der Hamburger Schule / uranische Planeten?

Kann ich Synastrie-, Transit- und Composite-Charts rendern?

Warum habt ihr Kerykeion v4.26.3 vendort statt es einfach zu importieren?

Wo landen die Hausnummern bei house_numbers_position='center'?

Was macht hide_axes_visually?

Wie schnell ist das Rendering?

Welche Ausgabeformate bekomme ich?

Kann ich Theme-Einstellungen pro Request überschreiben?