API de sinastria

Requisição

Uma requisição real para duas pessoas fictícias: o nascimento de demonstração em Kiev e um segundo nascimento em Nova 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}}'

Resposta

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

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

O que retorna

• aspects: cada aspecto maior entre um corpo de um mapa e um corpo do outro, com seu ângulo e seu orbe.
• overlays: em que casas do mapa da outra pessoa caem os planetas de cada uma, nos dois sentidos. Um dos lados é null quando a hora de nascimento da outra pessoa é desconhecida, porque as casas dependem dela.
• sphereScores: Identidade, Amor, Corpo, Dinheiro, Casa e Mente, cada uma de 0 a 100, a partir dos aspectos entre mapas (60%) e das sobreposições de casas (40%).
• scoring: a regra por trás das pontuações, informada na própria resposta. Ela descreve a geometria de dois mapas, não o futuro de uma relação.

Limites

• Apenas no API Pro. Com a chave grátis, o endpoint responde com 403 e um link para fazer upgrade.
• Nascimentos de 1800 a 2399. Zodíaco tropical, casas Placidus, os cinco aspectos maiores.
• Sem geocodificação: envie coordenadas. O fuso horário é determinado a partir delas, com as regras de horário de verão da data de nascimento.
• Os dados de nascimento são lidos, usados e esquecidos: o corpo das requisições nunca é armazenado.

Num assistente de IA

O servidor MCP em https://www.natalchart.ai/mcp oferece o mesmo cálculo como a ferramenta synastry, para que o Claude, o ChatGPT ou o Cursor possam comparar dois mapas antes de falar de compatibilidade.

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