API астрокартографии

Запрос

Настоящий запрос: демонстрационная карта для Лиссабона.

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}}'

Ответ

Часть ответа на этот запрос: основные поля, каждый список сокращён до первых трёх элементов.

{
  "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"
}

Что возвращается

• relocated: Асцендент и Середина неба, которые карта имеет в этом месте.
• angularPlanets: планеты на этих углах, у каждой угол, орбис и сила.
• spheres: «Я», «Любовь», «Тело», «Деньги», «Дом» и «Разум», каждая от 0 до 10, где 5 означает нейтральную оценку; overall10 сводит их в одно число.
• strength: сильная, если одна из основных планет находится в пределах 2° от угла, умеренная в пределах 4°, слабая в остальных случаях. Правила приходят вместе с ответом.
• POST /v1/locations/rank возвращает лучшие города из каталога по всем шести сферам или по выбранным вами, по всему миру или в одном регионе.

Ограничения

• Только API Pro. С бесплатным ключом оба эндпоинта отвечают кодом 403 и ссылкой для перехода на API Pro.
• Нужно время рождения: релокация смещает углы, а для углов нужно время.
• Рейтинг сравнивает крупные города из каталога (всего 61), а не все места на Земле; любое другое место можно оценить через POST /v1/locations/score.
• Данные рождения читаются, используются и забываются: тела запросов никогда не сохраняются.

В ИИ-ассистенте

Через MCP-сервер по адресу https://www.natalchart.ai/mcp ассистенты вызывают location_score для одного места и best_cities для лучших городов.

Другие возможности API

Тот же ключ открывает весь астрологический API: натальные карты, ежедневные транзиты, синастрию, транзиты за период, соляры, лучшие дни и астрокартографию. Все эндпоинты, поля и ошибки описаны в документации, а на странице цен объяснено, что считается запросом.

Вопросы