/api/astro/western/heliocentric/1 créditoMapa heliocêntrico
O sistema solar visto a partir do Sol, e não da Terra. A Terra assume o lugar do Sol: passa a ser o corpo que tem uma posição, e o Sol fica no centro. Por isso, não existe Sol, Lua nem nodo lunar heliocêntrico — são construções centradas na Terra, e aparecem listados em `omitted` em vez de retornados com um número inventado. Aqui, nenhum corpo fica retrógrado. A retrogradação é uma ilusão causada por observar um planeta em movimento a partir de outro; por isso, todo `retrograde` é false, e essa é a resposta correta, não um recurso ausente.
https://api.occultapi.com/api/astro/western/heliocentric/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/jsonCampos 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. |
| 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. |
| latitude | number (double) | opcional | 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. |
| longitude | number (double) | opcional | 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. |
| orb_factor | number (double) | opcional | Multiplica todos os orbes de aspecto. 0.5 os reduz à metade; 2 os dobra. min 0.1 · max 2 |
| timezone_as_float | number (double) | opcional | 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 |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/western/heliocentric/ \
-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}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"zodiac\": \"tropical\", \"centre\": \"sun\", \"planets\": [{\"name\": \"earth\", \"longitude\": 322.125097, \"speed\": 0.960932, \"retrograde\": false, \"sign\": \"Aquarius\", \"sign_index\": 11, \"degree_in_sign\": 22.1251, \"formatted\": \"22°07' Aquarius\"}, {\"name\": \"mercury\", \"longitude\": 266.048574, \"speed\": 2.767625, \"retrograde\": false, \"sign\": \"Sagittarius\", \"sign_index\": 9, \"degree_in_sign\": 26.0486, \"formatted\": \"26°02' Sagittarius\"}, {\"name\": \"venus\", \"longitude\": 91.966766, \"speed\": 1.616741, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 1.9668, \"formatted\": \"1°58' Cancer\"}, {\"name\": \"mars\", \"longitude\": 4.703217, \"speed\": 0.621477, \"retrograde\": false, \"sign\": \"Aries\", \"sign_index\": 1, \"degree_in_sign\": 4.7032, \"formatted\": \"4°42' Aries\"}, {\"name\": \"jupiter\", \"longitude\": 115.042891, \"speed\": 0.082106, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 25.0429, \"formatted\": \"25°02' Cancer\"}, {\"name\": \"saturn\", \"longitude\": 292.969663, \"speed\": 0.030364, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 22.9697, \"formatted\": \"22°58' Capricorn\"}, {\"name\": \"uranus\", \"longitude\": 278.129858, \"speed\": 0.011499, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 8.1299, \"formatted\": \"8°07' Capricorn\"}, {\"name\": \"neptune\", \"longitude\": 283.428057, \"speed\": 0.005989, \"retrograde\": false, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 13.4281, \"formatted\": \"13°25' Capricorn\"}, {\"name\": \"pluto\", \"longitude\": 227.099255, \"speed\": 0.007081, \"retrograde\": false, \"sign\": \"Scorpio\", \"sign_index\": 8, \"degree_in_sign\": 17.0993, \"formatted\": \"17°05' Scorpio\"}, {\"name\": \"chiron\", \"longitude\": 109.782224, \"speed\": 0.028755, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 19.7822, \"formatted\": \"19°46' Cancer\"}], \"aspects\": [{\"body_1\": \"earth\", \"body_2\": \"saturn\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 0.8446, \"allowed_orb\": 2.0, \"separation\": 29.1554}, {\"body_1\": \"mercury\", \"body_2\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.0057, \"allowed_orb\": 3.0, \"separation\": 151.0057}, {\"body_1\": \"jupiter\", \"body_2\": \"saturn\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 2.0732, \"allowed_orb\": 8.0, \"separation\": 177.9268}, {\"body_1\": \"earth\", \"body_2\": \"chiron\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 2.3429, \"allowed_orb\": 3.0, \"separation\": 147.6571}, {\"body_1\": \"pluto\", \"body_2\": \"chiron\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 2.683, \"allowed_orb\": 8.0, \"separation\": 117.317}, {\"body_1\": \"venus\", \"body_2\": \"mars\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 2.7365, \"allowed_orb\": 8.0, \"separation\": 87.2635}, {\"body_1\": \"earth\", \"body_2\": \"jupiter\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 2.9178, \"allowed_orb\": 3.0, \"separation\": 152.9178}, {\"body_1\": \"saturn\", \"body_2\": \"chiron\", \"aspect\": \"opposition\", \"exact_angle\": 180.0, \"orb\": 3.1874, \"allowed_orb\": 8.0, \"separation\": 176.8126}, {\"body_1\": \"mars\", \"body_2\": \"uranus\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 3.4266, \"allowed_orb\": 8.0, \"separation\": 86.5734}, {\"body_1\": \"neptune\", \"body_2\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 3.6712, \"allowed_orb\": 6.0, \"separation\": 56.3288}, {\"body_1\": \"earth\", \"body_2\": \"mercury\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 3.9235, \"allowed_orb\": 6.0, \"separation\": 56.0765}, {\"body_1\": \"earth\", \"body_2\": \"pluto\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 5.0258, \"allowed_orb\": 8.0, \"separation\": 95.0258}, {\"body_1\": \"jupiter\", \"body_2\": \"chiron\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 5.2607, \"allowed_orb\": 8.0, \"separation\": 5.2607}, {\"body_1\": \"uranus\", \"body_2\": \"neptune\", \"aspect\": \"conjunction\", \"exact_angle\": 0.0, \"orb\": 5.2982, \"allowed_orb\": 8.0, \"separation\": 5.2982}, {\"body_1\": \"saturn\", \"body_2\": \"pluto\", \"aspect\": \"sextile\", \"exact_angle\": 60.0, \"orb\": 5.8704, \"allowed_orb\": 6.0, \"separati"
}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.