POST/api/astro/traditional/profections/1 crédito

Profecções

Profecções anuais, mensais e diárias, com o senhor de cada período. A principal técnica preditiva helenística, e a mais simples: o mapa avança um signo inteiro por ano de vida a partir do ascendente, então uma pessoa de 33 anos está em uma profecção da 10ª casa, e o regente desse signo se torna o Senhor do Ano — o planeta pelo qual o ano é lido. O mesmo movimento se repete mais rápido dentro do ano: um signo por mês e um a cada cerca de dois dias e meio. As três são retornadas juntas, com o início e o fim exatos de cada período, porque uma leitura normalmente usa a anual para o tema e a mensal para situá-lo. A mensal continua a partir do signo anual, em vez de recomeçar no ascendente, e a diária, a partir da mensal. A idade é contada pelo ANIVERSÁRIO, e não pela divisão dos dias decorridos: a profecção muda na revolução solar, então alguém que está onze meses depois do seu trigésimo terceiro aniversário ainda está no seu trigésimo quarto ano. Esse é o detalhe que a maioria das implementações erra. Todos os timestamps estão em UTC, então os períodos podem ser comparados e ordenados sem precisar convertê-los de novo.

https://api.occultapi.com/api/astro/traditional/profections/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

Campo	Tipo	Obrigatório	Observações
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
latitude	number (double)	obrigatório	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -89.9 · max 89.9
longitude	number (double)	obrigatório	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180
timezone_as_float	number (double)	obrigatório	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14
as_of	string (date-time)	opcional	A data para a qual calcular a profecção. Padrão: agora (UTC).
house_system	string	opcional	As profecções são tradicionalmente por signo inteiro; a opção está aqui porque só o SIGNO do ascendente é usado. `campanusequalkochplacidusporphyryregiomontanustopocentricwhole_sign`
keys	array	opcional	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/traditional/profections/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"as_of":"2026-09-09T12:00:00+00:00"}'

Resposta

{
  "data": {
    "zodiac": "tropical",
    "as_of": "2026-09-09T12:00:00+00:00",
    "age": 36,
    "ascendant": {
      "degree": 201.479077,
      "sign": "Libra",
      "sign_index": 7,
      "degree_in_sign": 21.4791,
      "formatted": "21°28' Libra"
    },
    "annual": {
      "period": "year",
      "house": 1,
      "sign": "Libra",
      "sign_index": 7,
      "lord": "venus",
      "lord_position": {
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 1.573,
        "formatted": "1°34' Leo",
        "retrograde": false
      },
      "from": "2026-08-15T05:00:00+00:00",
      "to": "2027-08-15T05:00:00+00:00"
    },
    "monthly": {
      "period": "month",
      "house": 1,
      "sign": "Libra",
      "sign_index": 7,
      "lord": "venus",
      "lord_position": {
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 1.573,
        "formatted": "1°34' Leo",
        "retrograde": false
      },
      "from": "2026-08-15T05:00:00+00:00",
      "to": "2026-09-14T15:00:00+00:00"
    },
    "daily": {
      "period": "day",
      "house": 10,
      "sign": "Cancer",
      "sign_index": 4,
      "lord": "moon",
      "lord_position": {
        "sign": "Gemini",
        "sign_index": 3,
        "degree_in_sign": 12.66,
        "formatted": "12°39' Gemini",
        "retrograde": false
      },
      "from": "2026-09-07T00:30:00+00:00",
      "to": "2026-09-09T13:20:00+00:00"
    },
    "lord_of_the_year": "venus",
    "note": "Age is counted by birthday, so the annual profection turns over on the solar return rather than on 1 January or on a 365-day division of elapsed time."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.