API de revolução solar

Requisição

Uma requisição real: a revolução do mapa de demonstração em 2027, no local de nascimento.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

Resposta

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

O que retorna

• exactMomentUtc: o momento em que o Sol volta a atingir sua longitude natal, em UTC.
• location: onde o mapa é calculado; o local de nascimento, a menos que você envie outro.
• natalSun: a longitude do Sol natal a partir da qual a revolução é medida.
• chart: o mapa completo daquele momento e lugar, no mesmo formato do endpoint do mapa natal.

Limites

• Apenas no API Pro. Com a chave grátis, o endpoint responde com 403 e um link para fazer upgrade.
• A hora de nascimento é obrigatória.
• Zodíaco tropical e casas Placidus, as mesmas configurações do mapa natal.
• 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 a ferramenta solar_return e leem o ano à frente a partir de um mapa calculado.

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