Solarhoroskop-API

Anfrage

Eine echte Anfrage: das Solar 2027 für das Demo-Horoskop, am Geburtsort.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

Antwort

Ein Teil der Antwort auf diese Anfrage: die wichtigsten Felder, jede Liste auf ihre ersten drei Einträge gekürzt.

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

Was zurückkommt

• exactMomentUtc: der Moment, in dem die Sonne wieder ihre Länge im Geburtshoroskop erreicht, in UTC.
• location: der Ort, für den das Horoskop berechnet wird; der Geburtsort, sofern du keinen anderen sendest.
• natalSun: die Länge der Sonne im Geburtshoroskop, von der aus die Rückkehr gemessen wird.
• chart: das vollständige Horoskop für diesen Moment und Ort, in derselben Struktur wie beim Endpunkt für das Geburtshoroskop.

Limits

• Nur mit API Pro. Mit dem kostenlosen Schlüssel antwortet der Endpunkt mit 403 und einem Link zum Upgrade.
• Eine Geburtszeit ist erforderlich.
• Tropischer Tierkreis und Placidus-Häuser, dieselben Einstellungen wie beim Geburtshoroskop.
• Geburtsdaten werden gelesen, verwendet und vergessen: Anfrageinhalte werden nie gespeichert.

In einem KI-Assistenten

Über den MCP-Server unter https://www.natalchart.ai/mcp rufen Assistenten das Tool solar_return auf und lesen das kommende Jahr aus einem berechneten Horoskop.

Der Rest der API

Derselbe Schlüssel öffnet die ganze Astrologie-API: Geburtshoroskope, tägliche Transite, Synastrie, Transite für einen Zeitraum, Solarhoroskope, beste Tage und Astrokartographie. Jeder Endpunkt, jedes Feld und jeder Fehler steht in der Dokumentation, und die Preisseite erklärt, was als Anfrage zählt.

Fragen