Synastrie-API

Anfrage

Eine echte Anfrage für zwei fiktive Personen: die Demo-Geburtsdaten aus Kyjiw und eine zweite Geburt in New York.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

Antwort

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

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

Was zurückkommt

• aspects: jeder Hauptaspekt zwischen einem Himmelskörper des einen Horoskops und einem des anderen, mit Winkel und Orbis.
• overlays: das Haus, in das die Planeten jeder Person im Horoskop der anderen fallen, in beide Richtungen. Eine Seite ist null, wenn die Geburtszeit der anderen Person unbekannt ist, denn die Häuser hängen von ihr ab.
• sphereScores: identity, love, body, money, home und mind, jeweils von 0 bis 100, gebildet aus den Aspekten zwischen den Horoskopen (60 %) und den Hausüberlagerungen (40 %).
• scoring: die Regel hinter den Werten, in der Antwort selbst angegeben. Sie beschreibt die Geometrie zweier Horoskope, nicht die Zukunft einer Beziehung.

Limits

• Nur mit API Pro. Mit dem kostenlosen Schlüssel antwortet der Endpunkt mit 403 und einem Link zum Upgrade.
• Geburten von 1800 bis 2399. Tropischer Tierkreis, Placidus-Häuser, die fünf Hauptaspekte.
• Keine Geokodierung: Sende Koordinaten. Die Zeitzone wird daraus ermittelt, mit den Sommerzeitregeln des Geburtsdatums.
• Geburtsdaten werden gelesen, verwendet und vergessen: Anfrageinhalte werden nie gespeichert.

In einem KI-Assistenten

Der MCP-Server unter https://www.natalchart.ai/mcp bietet dieselbe Berechnung als Tool synastry an, sodass Claude, ChatGPT oder Cursor zwei Horoskope vergleichen können, bevor sie sagen, wie gut zwei Menschen zusammenpassen.

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