POST/api/astro/western/planets/1 crédito

Planetas ocidentais (tropicais)

Posições tropicais dos dez planetas, do nodo norte e de Quíron. TROPICAL, não sideral. Todos os outros endpoints de mapa desta API subtraem o ayanamsa — cerca de 24 graus atualmente —, o que desloca quase todos os planetas para o signo anterior. Quem nasceu em 15 de agosto é de Leão aqui e de Câncer em /api/astro/chart/. Ambos estão corretos em sua própria tradição; escolha o que seu produto usa e não os misture. Doze corpos: os dez planetas ocidentais, o nodo norte verdadeiro e Quíron. Cada um retorna sua longitude, o signo e os graus dentro dele, uma posição formatada, seu movimento diário e se está retrógrado. Envie uma data, uma hora e um local. Nada mais — o zodíaco é fixado pela rota.

https://api.occultapi.com/api/astro/western/planets/

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
ayanamsa	string	opcional	TROPICAL (o padrão) ou um nome de ayanamsa como LAHIRI, KRISHNAMURTI, RAMAN ou FAGAN_BRADLEY, sem diferenciar maiúsculas de minúsculas. Com um ayanamsa sideral, o valor dele em cada momento é subtraído de todas as longitudes retornadas.
include_asteroid_lilith	boolean	opcional	Adiciona o asteroide (1181) Lilith, um corpo diferente de Lilith (Lua Negra), com o nome "asteroid_lilith", depois dos demais corpos.
include_lilith	boolean	opcional	Adiciona Lilith (Lua Negra, o apogeu lunar médio) como um corpo com o nome "lilith", depois dos demais corpos.
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/western/planets/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873}'

Resposta

{
  "data": {
    "zodiac": "tropical",
    "planets": [
      {
        "name": "sun",
        "longitude": 142.125,
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 22.125,
        "formatted": "22°07' Leo",
        "speed": 0.960934,
        "retrograde": false
      },
      {
        "name": "moon",
        "longitude": 72.66,
        "sign": "Gemini",
        "sign_index": 3,
        "degree_in_sign": 12.66,
        "formatted": "12°39' Gemini",
        "speed": 14.262958,
        "retrograde": false
      },
      {
        "name": "mercury",
        "longitude": 169.176,
        "sign": "Virgo",
        "sign_index": 6,
        "degree_in_sign": 19.176,
        "formatted": "19°10' Virgo",
        "speed": 0.776615,
        "retrograde": false
      },
      {
        "name": "venus",
        "longitude": 121.573,
        "sign": "Leo",
        "sign_index": 5,
        "degree_in_sign": 1.573,
        "formatted": "1°34' Leo",
        "speed": 1.22118,
        "retrograde": false
      },
      {
        "name": "mars",
        "longitude": 51.217,
        "sign": "Taurus",
        "sign_index": 2,
        "degree_in_sign": 21.217,
        "formatted": "21°13' Taurus",
        "speed": 0.576982,
        "retrograde": false
      },
      {
        "name": "jupiter",
        "longitude": 119.337,
        "sign": "Cancer",
        "sign_index": 4,
        "degree_in_sign": 29.337,
        "formatted": "29°20' Cancer",
        "speed": 0.214649,
        "retrograde": false
      },
      {
        "name": "saturn",
        "longitude": 289.878,
        "sign": "Capricorn",
        "sign_index": 10,
        "degree_in_sign": 19.878,
        "formatted": "19°52' Capricorn",
        "speed": -0.056381,
        "retrograde": true
      },
      {
        "name": "uranus",
        "longitude": 275.978,
        "sign": "Capricorn",
        "sign_index": 10,
        "degree_in_sign": 5.978,
        "formatted": "5°58' Capricorn",
        "speed": -0.023775,
        "retrograde": true
      },
      {
        "name": "neptune",
        "longitude": 282.199,
        "sign": "Capricorn",
        "sign_index": 10,
        "degree_in_sign": 12.199,
        "formatted": "12°11' Capricorn",
        "speed": -0.019063,
        "retrograde": true
      },
      {
        "name": "pluto",
        "longitude": 225.084,
        "sign": "Scorpio",
        "sign_index": 8,
        "degree_in_sign": 15.084,
        "formatted": "15°05' Scorpio",
        "speed": 0.011469,
        "retrograde": false
      },
      {
        "name": "north_node",
        "longitude": 307.233,
        "sign": "Aquarius",
        "sign_index": 11,
        "degree_in_sign": 7.233,
        "formatted": "7°13' Aquarius",
        "speed": 0.014476,
        "retrograde": false
      },
      {
        "name": "chiron",
        "longitude": 112.438,
        "sign": "Cancer",
        "sign_index": 4,
        "degree_in_sign": 22.438,
        "formatted": "22°26' Cancer",
        "speed": 0.099053,
        "retrograde": false
      }
    ]
  },
  "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.