Astrokartographie-API

Anfrage

Eine echte Anfrage: Lissabon, gemessen am Demo-Horoskop.

curl -X POST https://api.natalchart.ai/v1/locations/score \
  -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},"location":{"name":"Lisbon","latitude":38.7223,"longitude":-9.1393}}'

Antwort

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

{
  "relocated": {
    "ascendant": {
      "longitude": 277.7847,
      "sign": "Capricorn"
    },
    "midheaven": {
      "longitude": 210.708,
      "sign": "Scorpio"
    }
  },
  "angularPlanets": [
    {
      "planet": "Uranus",
      "angle": "ASC",
      "orb": 2.12,
      "weight": "major",
      "strength": "strong"
    },
    {
      "planet": "Neptune",
      "angle": "ASC",
      "orb": 6.31,
      "weight": "major",
      "strength": "weak"
    }
  ],
  "spheres": {
    "identity": {
      "score10": 1,
      "verdict": "challenging"
    },
    "love": {
      "score10": 6.1,
      "verdict": "slightly supportive"
    },
    "body": {
      "score10": 3.2,
      "verdict": "challenging"
    },
    "money": {
      "score10": 2.2,
      "verdict": "challenging"
    },
    "home": {
      "score10": 1.7,
      "verdict": "challenging"
    },
    "mind": {
      "score10": 4.9,
      "verdict": "neutral"
    }
  },
  "overall10": 2.2,
  "strength": "moderate"
}

Was zurückkommt

• relocated: der Aszendent und das Medium Coeli, die das Horoskop an diesem Ort hat.
• angularPlanets: die Planeten auf diesen Achsen, jeweils mit Achse, Orbis und Stärke.
• spheres: identity, love, body, money, home und mind, jeweils von 0 bis 10, mit 5 als neutral; overall10 fasst sie zusammen.
• strength: stark, wenn ein wichtiger Planet innerhalb von 2° einer Achse steht, mittel innerhalb von 4°, sonst schwach. Die Regeln stehen in der Antwort.
• POST /v1/locations/rank liefert die besten Städte aus dem Katalog, nach allen sechs Lebensbereichen oder den von dir gewählten, weltweit oder in einer Region.

Limits

• Nur mit API Pro. Mit dem kostenlosen Schlüssel antworten beide Endpunkte mit 403 und einem Link zum Upgrade.
• Eine Geburtszeit ist erforderlich: Die Relokation verschiebt die Achsen, und für die Achsen braucht es die Uhrzeit.
• Die Rangliste vergleicht 61 große Städte, nicht jeden Ort der Erde; jeden anderen Ort kann man mit POST /v1/locations/score bewerten.
• 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 location_score für einen Ort und best_cities für die besten Städte auf.

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