POST/api/astro/planet-positions/1 crédito

Posições planetárias

Posições siderais dos nove grahas para um momento e um local: longitude, signo, nakshatra, pada e casa de cada um, além do ascendente e do ayanamsa efetivamente aplicado. Os planetas vêm como uma LISTA na ordem tradicional, com `name` em cada entrada, em vez de aninhados sob um nome de mapa e indexados por planeta, então você pode iterar sobre eles ou renderizar uma tabela diretamente. Derivado de /api/astro/chart/, que exige chart_name, notation, ayanamsa e ascendant_pos em toda chamada. Aqui, os padrões são RashiChart, degree, LAHIRI e cusp - envie uma data e um local e nada mais. Ainda assim, vale a pena escolher `ayanamsa` de forma consciente: ele desloca todas as longitudes da resposta, e Lahiri e Raman diferem em cerca de um grau, o que basta para levar um planeta a outro nakshatra. Todos os 48 ayanamsas suportados pelo endpoint de mapa são aceitos aqui.

https://api.occultapi.com/api/astro/planet-positions/

Testar requisição

Dados de Posições planetárias exibidos numa interface — Os dados deste endpoint exibidos numa interface real. A API entrega os valores; o layout é você quem monta.

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
chart_name	string	obrigatório
datetime	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. Equivale a date_time, nome que outros endpoints usam para o mesmo valor.
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
aberration	boolean	opcional
apply_correction	boolean	opcional
ascendant_pos	string	opcional	`cuspstartend`
ayanamsa	string	opcional
background_color	string	opcional	Cor hexadecimal do fundo do SVG.
chart_style	string	opcional	Estilo do diagrama quando render='svg'. 'north' é o layout em losango, com casas fixas e signos que giram; 'south' é a grade de signos fixos, com casas que giram. `northsouth`
correction_deg	integer	opcional	min 0
correction_direction	string	opcional	`addsubtract`
correction_min	integer	opcional	min 0 · max 59
correction_sec	integer	opcional	min 0 · max 59
extended_bodies	array	opcional	Grupos de corpos a incluir: 'asteroids', 'planetary_moons', 'fictitious_bodies'.
label_style	string	opcional	Como os planetas são rotulados: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) ou 'symbol' (☉, ☽, ...). `englishsanskritsymbol`
line_color	string	opcional	Cor hexadecimal das linhas de grade do mapa.
notation	string	opcional	`astrologicaldegree`
nutation	boolean	opcional
planet_color	string	opcional	Cor hexadecimal dos rótulos dos planetas, por exemplo '#111827'. Padrão: a própria cor do tema.
rahu	string	opcional	Tipo de nodo a incluir. 'true' retorna apenas os nodos verdadeiros, 'mean' retorna apenas os nodos médios, 'both' retorna ambos. `truemeanboth`
refraction	boolean	opcional
render	string	opcional	Defina como 'svg' para receber também um diagrama renderizado do mapa (veja chart_style) e a geometria usada para desenhá-lo. Sem este campo, a resposta não muda. `nonesvg`
show_degrees	boolean	opcional	Exibe, ao lado do rótulo, o grau de cada corpo dentro do signo.
sign_color	string	opcional	Cor hexadecimal dos números/abreviações dos signos.
svg_size	integer	opcional	Largura e altura do viewBox quadrado do SVG, em pixels. min 100 · max 2000
theme	string	opcional	`lightdark`
true_mean	string	opcional	`TrueMean`
use_28_nakshatras	boolean	opcional

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'

Resposta

{
  "data": {
    "planets": [
      {
        "name": "sun",
        "longitude": 134.381,
        "latitude": 0,
        "nakshatra": "Poorva Phalguni",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "moon",
        "longitude": 1.478,
        "latitude": 4.37,
        "nakshatra": "Ashwini",
        "pada": 1,
        "kakshya": "saturn",
        "zodiac_name": "Aries",
        "house": 9
      },
      {
        "name": "mars",
        "longitude": 79.175,
        "latitude": 0.535,
        "nakshatra": "Aardra",
        "pada": 4,
        "kakshya": "Mercury",
        "zodiac_name": "Gemini",
        "house": 11
      },
      {
        "name": "mercury",
        "longitude": 138.508,
        "latitude": 1.574,
        "nakshatra": "Poorva Phalguni",
        "pada": 2,
        "kakshya": "venus",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "jupiter",
        "longitude": 109.472,
        "latitude": 0.529,
        "nakshatra": "Aasresha",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Cancer",
        "house": 12
      },
      {
        "name": "venus",
        "longitude": 178.956,
        "latitude": -3.391,
        "nakshatra": "Chitra",
        "pada": 2,
        "kakshya": "ascendant",
        "zodiac_name": "Virgo",
        "house": 2
      },
      {
        "name": "saturn",
        "longitude": 349.447,
        "latitude": -2.651,
        "nakshatra": "Revati",
        "pada": 1,
        "kakshya": "Mercury",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "northtruenode",
        "longitude": 305.566,
        "latitude": 0,
        "nakshatra": "Dhanishtha",
        "pada": 4,
        "kakshya": "jupiter",
        "zodiac_name": "Aquarius",
        "house": 7
      },
      {
        "name": "southtruenode",
        "longitude": 125.56599999999996,
        "latitude": 0,
        "nakshatra": "Makha",
        "pada": 2,
        "kakshya": "jupiter",
        "zodiac_name": "Leo",
        "house": 1
      },
      {
        "name": "uranus",
        "longitude": 41.424,
        "latitude": -0.154,
        "nakshatra": "Rohini",
        "pada": 1,
        "kakshya": "sun",
        "zodiac_name": "Taurus",
        "house": 10
      },
      {
        "name": "neptune",
        "longitude": 339.433,
        "latitude": -1.412,
        "nakshatra": "Uttaraabhaadra",
        "pada": 2,
        "kakshya": "mars",
        "zodiac_name": "Pisces",
        "house": 8
      },
      {
        "name": "pluto",
        "longitude": 279.279,
        "latitude": -4.3,
        "nakshatra": "Uttaraashaadha",
        "pada": 4,
        "kakshya": "mars",
        "zodiac_name": "Capricorn",
        "house": 6
      }
    ],
    "ascendant": {
      "longitude": 132.1878846274937,
      "zodiac_name": "Leo",
      "nakshatra": "Makha",
      "pada": 4
    },
    "ayanamsa": {
      "name": "LAHIRI",
      "corrected": false,
      "value_degrees": 24.229599,
      "formatted": "24°13'47\""
    }
  },
  "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.