Transit-API

Anfrage

Eine echte Anfrage für das Demo-Horoskop, für einen Monat:

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

Antwort

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

Was zurückkommt

• window: der Zeitraum, den du angefragt hast.
• events: bis zu 60 exakte Aspekte transitierender Himmelskörper zu denen des Geburtshoroskops, Zeichenwechsel und Stillstände, nach Datum geordnet, jeweils mit dem Moment in UTC, der Position und den beteiligten Häusern. Enthält ein Zeitraum mehr, werden die bedeutendsten behalten.
• activeOnFirstDay: die Transite, die am ersten Tag schon im Orbis sind, mit den verwendeten Orben.
• Jedes Ereignis ist nach Bedeutung eingestuft (high, medium oder low), je nach den beteiligten Himmelskörpern.

Limits

• Nur mit API Pro, höchstens 92 Tage und 60 Ereignisse pro Anfrage. Mit dem kostenlosen Schlüssel antwortet der Endpunkt mit 403 und einem Link zum Upgrade.
• Geburten von 1800 bis 2399. Die Häuser eines Transits brauchen eine Geburtszeit; ohne sie werden sie weggelassen.
• Jeder exakte Moment wird mit der Swiss Ephemeris ermittelt und in UTC angegeben.
• 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 transits für einen Zeitraum und daily_transits für einen einzelnen Tag auf und lesen echte Transite, statt sie zu raten.

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