API de astrocartografia

Requisição

Uma requisição real: o mapa de demonstração em relação a Lisboa.

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

Resposta

Parte da resposta a essa requisição: os campos principais, com cada lista reduzida aos três primeiros itens.

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

O que retorna

• relocated: o Ascendente e o Meio do Céu que o mapa tem naquele lugar.
• angularPlanets: os planetas sobre esses ângulos, cada um com seu ângulo, seu orbe e sua força.
• spheres: Identidade, Amor, Corpo, Dinheiro, Casa e Mente, cada uma de 0 a 10, com 5 como neutro; overall10 resume todas.
• strength: forte quando um planeta principal está a até 2° de um ângulo, moderada a até 4°, fraca nos demais casos. As regras vêm com a resposta.
• POST /v1/locations/rank retorna as melhores cidades do catálogo, pelas seis esferas ou pelas que você escolher, no mundo todo ou numa região.

Limites

• Apenas no API Pro. Com a chave grátis, os dois endpoints respondem com 403 e um link para fazer upgrade.
• A hora de nascimento é obrigatória: a relocação move os ângulos, e os ângulos precisam da hora.
• A classificação compara 61 grandes cidades, não todos os lugares da Terra; qualquer outro lugar pode ser pontuado com POST /v1/locations/score.
• Os dados de nascimento são lidos, usados e esquecidos: o corpo das requisições nunca é armazenado.

Num assistente de IA

Pelo servidor MCP em https://www.natalchart.ai/mcp, os assistentes chamam location_score para um lugar e best_cities para as melhores cidades.

O resto da API

A mesma chave dá acesso a toda a API de astrologia: mapas natais, trânsitos diários, sinastria, trânsitos de um período, revoluções solares, melhores dias e astrocartografia. Todos os endpoints, campos e erros estão na documentação, e a página de preços explica o que conta como requisição.

Perguntas