API de trânsitos

Requisição

Uma requisição real com o mapa de demonstração, para um período de um mês:

curl -X POST https://api.natalchart.ai/v1/transits \
  -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},"from":"2026-09-18","to":"2026-10-18"}'

Resposta

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

O que retorna

• window: as datas que você pediu.
• events: até 60 aspectos exatos de corpos em trânsito com corpos natais, ingressos em signos e estações, em ordem cronológica, cada um com seu momento em UTC, sua posição e as casas envolvidas. Quando um período tem mais, ficam os mais importantes.
• activeOnFirstDay: os trânsitos que já estão dentro do orbe no primeiro dia, com os orbes usados.
• Cada evento indica sua importância (alta, média ou baixa), que depende dos corpos envolvidos.

Limites

• Apenas no API Pro, com no máximo 92 dias e 60 eventos por requisição. Com a chave grátis, o endpoint responde com 403 e um link para fazer upgrade.
• Nascimentos de 1800 a 2399. As casas de um trânsito precisam da hora de nascimento; sem ela, ficam de fora.
• Cada momento exato é buscado com o Swiss Ephemeris e informado em UTC.
• 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 transits para um período e daily_transits para um único dia, e leem trânsitos reais em vez de adivinhá-los.

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