Horoskop-API

Anfrage

Eine echte Anfrage für das Demo-Horoskop:

curl -X POST https://api.natalchart.ai/v1/horoscope/daily \
  -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},"date":"2026-09-18"}'

Antwort

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

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

Was zurückkommt

• positions: wo jeder Himmelskörper an diesem Datum um 12:00 Uhr UTC steht, nach Zeichen und Grad.
• moon: die Phase mit ihrem beleuchteten Anteil, das Zeichen des Mondes sowie der nächste Neumond und Vollmond.
• events: die Himmelsereignisse der kommenden Woche, etwa Zeichenwechsel und Stillstände.
• transits: mit Geburtsdaten jeder Transit zum Geburtshoroskop, mit Aspekt, Orbis, der Angabe, ob er applikativ (sich bildend) oder separativ (sich lösend) ist, dem exakten Moment und dem Haus des Geburtshoroskops, in dem der transitierende Himmelskörper steht.
• focus: die drei Kontakte, die nach Geschwindigkeit des Planeten und Enge am höchsten eingestuft werden, jeweils mit einem Feld tone, das einer festen Regel folgt (supportive für Trigon und Sextil, challenging für Quadrat und Opposition, intensifying für Konjunktion).

Limits

• Kostenloser Schlüssel: 10 Anfragen pro Tag; API Pro: 1.000.
• Transitorben: 2° für Mond, Sonne, Merkur, Venus und Mars, 3° für die langsameren Himmelskörper.
• Keine Sternzeichentexte und kein generierter Text: Der Endpunkt liefert Zahlen für ein Horoskop.
• 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 daily_transits auf und schreiben das Horoskop aus den berechneten Transiten, statt sie zu erfinden.

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