AstroWay/api v2.95.1 · pt
todos os sistemas normais
// astrology api · POST /v1/progressions

API de progressões secundárias

Avance o mapa natal de forma simbólica: um dia de efeméride de movimento planetário equivale a um ano de vida. Forneça um mapa natal e uma data-alvo e receba o mapa progredido — planetas, casas, aspetos — para essa idade. Precisão do Swiss Ephemeris, saída em JSON.

Endpoint
POST /v1/progressions
Custo
50 créditos
Latência
~64 ms
Nível
Tier 3
// 01 / O que calcula

API de progressões secundárias

O endpoint progressions aplica a clássica técnica secundária de "um dia por um ano". Recebe a data, hora, desvio UTC e local de nascimento, mede os anos decorridos até à data-alvo e avança o mapa esse número de dias de efeméride a partir do momento de nascimento — de modo que os trinta anos de idade correspondem ao céu trinta dias após o nascimento. Em seguida, converte esse momento progredido num dia juliano, extrai as posições e velocidades geocêntricas do motor Swiss Ephemeris e devolve os planetas progredidos com os seus signos e posições nas casas, as cúspides das casas e a grelha completa de aspetos com indicadores de aplicação e separação e orbes exatos. Como a Lua se desloca cerca de um grau por dia, avança aproximadamente um grau por ano de vida, fazendo da Lua progredida o marcador de movimento mais rápido e mais observado do desenvolvimento interior ao longo do mapa.

// 02 / Pedido ao vivo

POST/v1/progressions

curl -X POST https://api.astroway.info/v1/progressions \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-06-15"
}'
Resposta (excerto)
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 312.7,
        "sign": "Aquarius",
        "house": 5
      }
    ],
    "houses": {
      "ascendant": 160.4,
      "mc": 70.1,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}
// 03 / Parâmetros

Parâmetros

nametypeObrigatório
date string (YYYY-MM-DD) sim Birth date.
time string (HH:MM:SS) sim Local clock time at birth.
timezoneOffset number (hours) sim UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number sim Birth-place latitude, decimal degrees (north positive).
longitude number sim Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) sim Required date to progress the chart to (YYYY-MM-DD); the elapsed years set the day-for-a-year advance.
// 04 / Quando usar

Quando usar

Use as progressões secundárias para a história lenta e interior de uma vida, e não para o tempo do dia a dia dos trânsitos. Adequam-se a um relatório de "o que se desenrola este ano", um rastreador de fases da Lua progredida, uma funcionalidade de marcos etários, ou uma narrativa de AI que necessita do mapa interior em evolução num dado ponto. Onde os trânsitos descrevem a temporização externa a partir do céu atual, as progressões descrevem o amadurecimento psicológico — o mapa a amadurecer por dentro. Calcule-as para um aniversário, um ponto de viragem ou qualquer idade que queira caracterizar, e alimente as posições progredidas à interpretação juntamente com o mapa natal e os trânsitos atuais para um quadro de temporização em camadas. A técnica é simbólica, pelo que responde melhor a "que tema está a amadurecer" do que a "o que acontece nesta data exata".

// 05 / Notas

Notas

Este é o método secundário padrão, de um dia por um ano, avançando o mapa natal um dia de efeméride por ano de vida até à data-alvo. A Lua progredida desloca-se cerca de um grau por ano e é o marcador principal; os planetas exteriores mal se movem. As casas seguem o sistema escolhido; zodíaco tropical e Swiss Ephemeris ao longo de tudo.

Experimente a API de Progressões Secundárias

Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.

99.9% SLA · planos pagos · 30d status →