Die API von NatalChart.AI ist der Rechenkern der App NatalChart.AI, geöffnet für Entwickler. Sende Geburtsdatum, Geburtszeit und Koordinaten und erhalte das Horoskop zurück: Du musst keine Ephemeridendateien hosten, keine Zeitzonentabellen pflegen und keine Astrologie-Bibliothek aktuell halten.
Was du damit bauen kannst
Seiten mit Geburtshoroskopen
Sonne, Mond und Aszendent, jeder Planet in seinem Zeichen und Haus, die Aspekte mit Orben und die Gewichtung der Elemente, für jede Geburt von 1800 bis 2399. /v1/chart/full, /v1/chart/short
Tageshoroskope nach dem echten Himmel
Die Transite des Tages zum Horoskop einer Person, jeweils mit Orbis und der Angabe, ob er sich aufbaut oder abklingt, dazu die Mondphase und die Himmelsereignisse der Woche. /v1/horoscope/daily, /v1/sky
Partnerhoroskope für Dating-Produkte
Zwei Horoskope im Vergleich: jeder Aspekt zwischen ihnen, in welche Häuser der jeweils anderen Person die Planeten jeder Person fallen, und ein Wert für jeden Lebensbereich. /v1/synastry
Vorhersagen und das kommende Jahr
Jeder exakte Transit in einem Zeitraum von bis zu 92 Tagen und das Solarhoroskop für jedes beliebige Jahr, am Geburtsort oder dort, wo die Person dann sein wird. /v1/transits, /v1/solar-return
Beste Tage
Jeder Tag eines Zeitraums, bewertet für eine Aktivität (Geschäft, Liebe, Reisen, Gesundheit und mehr), mit den Transiten, die dafür und dagegen sprechen. /v1/timing
Astrokartographie und Relokation
Eine Stadt, bewertet nach einem Horoskop, oder die großen Städte der Welt als Rangliste dafür, nach Lebensbereich und Region. /v1/locations/score, /v1/locations/rank
In einer Minute starten
Erstelle einen Schlüssel (kostenlos, ohne Kreditkarte) und sende dann Geburtsdaten:
curl https://api.natalchart.ai/v1/chart/short \
-H "Authorization: Bearer $NATALCHART_API_KEY" \
-H "Content-Type: application/json" \
-d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234}}'Jeder Endpunkt, jedes Feld und jeder Fehler steht in der API-Dokumentation, und das OpenAPI-Dokument beschreibt sie für Codegeneratoren.
Genauigkeit, die du prüfen kannst
Tropischer Tierkreis, Placidus-Häuser, die fünf Hauptaspekte, wahrer Mondknoten, Positionen auf vier Nachkommastellen eines Grades. Die Zeitzone wird aus den Koordinaten ermittelt, mit den Sommerzeitregeln des Geburtsdatums, und bei unbekannter Geburtszeit werden Häuser und Achsen zurückgehalten statt geraten. Der Genauigkeitsbericht vergleicht den Rechenkern mit NASA JPL Horizons, und mit dem veröffentlichten Demo-Horoskop kannst du eine Antwort prüfen, bevor du Code schreibst.
Für KI-Assistenten: der MCP-Server
Dieselben Berechnungen gibt es als MCP-Server unter https://www.natalchart.ai/mcp. Claude, ChatGPT, Cursor und VS Code verbinden sich mit demselben Schlüssel und rufen die Tools für Horoskop, Transite und Partnerhoroskop selbst auf, sodass ein Assistent ein Horoskop liest, das berechnet und nicht geraten wurde.
Preise
| Tarif | Preis | Anfragen | Endpunkte |
|---|---|---|---|
| Free | $0 | 10 pro Tag | Horoskope und ihre Teile, Tageshoroskop, Himmel, Nutzung |
| API Pro | $6.99 pro Monat | 1.000 pro Tag | Alles: Transite, Synastrie, Solarhoroskope, beste Tage, Orte |
Das Kontingent gilt pro Konto und füllt sich um 00:00 UTC wieder auf. Eine als ungültig abgelehnte Anfrage wird nicht gezählt, und Geburtsdaten werden nie gespeichert: Das Protokoll enthält nur den Endpunkt, den Status und die Zeit.
Fragen
Gibt es eine kostenlose Astrologie-API?
Ja. Ein Schlüssel von NatalChart.AI ist kostenlos und bietet 10 Anfragen pro Tag: Geburtshoroskope vollständig oder in Teilen, den Himmel des Tages mit Transiten zu einem Horoskop und Planetenpositionen für jedes Datum. Eine Kreditkarte ist nicht nötig. API Pro ($6.99 pro Monat) erhöht das Kontingent auf 1.000 pro Tag und schaltet Transite für einen Zeitraum, Synastrie, Solarhoroskope, beste Tage und Astrokartographie frei.
Wie genau sind die Berechnungen?
Die Positionen stammen aus der Swiss Ephemeris, dem Standard professioneller Astrologie-Software, mit ihren Datendateien und aktiviertem Geschwindigkeits-Flag. Derselbe Rechenkern zeichnet jedes Horoskop in der App NatalChart.AI, und der Genauigkeitsbericht vergleicht seine Ergebnisse mit NASA JPL Horizons.
Kann ich darauf eine Horoskop- oder Partnerhoroskop-App bauen?
Ja, dafür ist sie da: Seiten mit Geburtshoroskopen, Tageshoroskope aus echten Transiten, Partnerhoroskop-Werte für Dating-Produkte, Auswahlhilfen für die besten Tage und Relokationskarten. Die kommerzielle Nutzung ist in beiden Tarifen erlaubt; bewahre den Schlüssel auf deinem Server auf.
Liefert sie geschriebene Deutungen?
Nein. Die API berechnet und liefert Zahlen: Zeichen, Grade, Häuser, Aspekte mit Orben, Werte je Lebensbereich. Es gibt keine KI-Aufrufe, deshalb ergibt dieselbe Eingabe immer dieselbe Ausgabe, und die Worte bleiben deine oder die deines Modells.
Mit welchen Sprachen und Frameworks funktioniert sie?
Mit allem, was eine HTTPS-Anfrage mit JSON-Inhalt senden kann: JavaScript, Python, PHP, Swift, Kotlin, No-Code-Tools. Die Dokumentation enthält Beispiele zum Kopieren und Einfügen, und ein OpenAPI-Dokument beschreibt jeden Endpunkt für Codegeneratoren.
Können KI-Assistenten sie nutzen?
Ja, über den MCP-Server: Claude, ChatGPT, Cursor und VS Code verbinden sich mit demselben Schlüssel und rufen die Berechnungen als Tools auf.