/api/astro/western/harmonic/1 créditoMapa harmônico
O N-ésimo harmônico: cada longitude multiplicada por N e reconduzida ao círculo. Técnica de Addey. Multiplicar por N e tomar o resultado módulo 360 transforma uma divisão do círculo em uma conjunção, então planetas separados por exatamente um quinto do círculo ficam em conjunção no 5º harmônico. Assim, um padrão sutil fica fácil de enxergar. O 4º e o 8º são os mais interpretados, pois condensam os aspectos tensos; o 5º mostra quintis e o 9º, novis. Os aspectos harmônicos são calculados e retornados, porque encontrar as novas conjunções é justamente o objetivo.
https://api.occultapi.com/api/astro/western/harmonic/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. |
| harmonic | integer | opcional | Qual harmônico. 5 é o harmônico do quintil, 7 o do septil, 9 o do novil. O 4º e o 8º são os mais interpretados. min 2 · max 180 |
| 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/harmonic/ \
-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,"harmonic":5}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"zodiac\": \"tropical\", \"harmonic\": 5, \"note\": \"Every natal longitude multiplied by 5 and taken modulo 360. Bodies 5 apart in the natal circle become conjunct here.\", \"planets\": [{\"name\": \"sun\", \"natal_longitude\": 142.125097, \"longitude\": 350.625485, \"speed\": 0.960934, \"retrograde\": false, \"sign\": \"Pisces\", \"sign_index\": 12, \"degree_in_sign\": 20.6255, \"formatted\": \"20°37' Pisces\"}, {\"name\": \"moon\", \"natal_longitude\": 72.660043, \"longitude\": 3.300215, \"speed\": 14.262958, \"retrograde\": false, \"sign\": \"Aries\", \"sign_index\": 1, \"degree_in_sign\": 3.3002, \"formatted\": \"3°18' Aries\"}, {\"name\": \"mercury\", \"natal_longitude\": 169.176074, \"longitude\": 125.88037, \"speed\": 0.776615, \"retrograde\": false, \"sign\": \"Leo\", \"sign_index\": 5, \"degree_in_sign\": 5.8804, \"formatted\": \"5°52' Leo\"}, {\"name\": \"venus\", \"natal_longitude\": 121.572681, \"longitude\": 247.863405, \"speed\": 1.22118, \"retrograde\": false, \"sign\": \"Sagittarius\", \"sign_index\": 9, \"degree_in_sign\": 7.8634, \"formatted\": \"7°51' Sagittarius\"}, {\"name\": \"mars\", \"natal_longitude\": 51.217023, \"longitude\": 256.085115, \"speed\": 0.576982, \"retrograde\": false, \"sign\": \"Sagittarius\", \"sign_index\": 9, \"degree_in_sign\": 16.0851, \"formatted\": \"16°05' Sagittarius\"}, {\"name\": \"jupiter\", \"natal_longitude\": 119.336805, \"longitude\": 236.684025, \"speed\": 0.214649, \"retrograde\": false, \"sign\": \"Scorpio\", \"sign_index\": 8, \"degree_in_sign\": 26.684, \"formatted\": \"26°41' Scorpio\"}, {\"name\": \"saturn\", \"natal_longitude\": 289.878035, \"longitude\": 9.390175, \"speed\": -0.056381, \"retrograde\": true, \"sign\": \"Aries\", \"sign_index\": 1, \"degree_in_sign\": 9.3902, \"formatted\": \"9°23' Aries\"}, {\"name\": \"uranus\", \"natal_longitude\": 275.978113, \"longitude\": 299.890565, \"speed\": -0.023775, \"retrograde\": true, \"sign\": \"Capricorn\", \"sign_index\": 10, \"degree_in_sign\": 29.8906, \"formatted\": \"29°53' Capricorn\"}, {\"name\": \"neptune\", \"natal_longitude\": 282.198866, \"longitude\": 330.99433, \"speed\": -0.019063, \"retrograde\": true, \"sign\": \"Pisces\", \"sign_index\": 12, \"degree_in_sign\": 0.9943, \"formatted\": \"0°59' Pisces\"}, {\"name\": \"pluto\", \"natal_longitude\": 225.084319, \"longitude\": 45.421595, \"speed\": 0.011469, \"retrograde\": false, \"sign\": \"Taurus\", \"sign_index\": 2, \"degree_in_sign\": 15.4216, \"formatted\": \"15°25' Taurus\"}, {\"name\": \"north_node\", \"natal_longitude\": 307.233496, \"longitude\": 96.16748, \"speed\": 0.014476, \"retrograde\": false, \"sign\": \"Cancer\", \"sign_index\": 4, \"degree_in_sign\": 6.1675, \"formatted\": \"6°10' Cancer\"}, {\"name\": \"chiron\", \"natal_longitude\": 112.437645, \"longitude\": 202.188225, \"speed\": 0.099053, \"retrograde\": false, \"sign\": \"Libra\", \"sign_index\": 7, \"degree_in_sign\": 22.1882, \"formatted\": \"22°11' Libra\"}], \"aspects\": [{\"body_1\": \"mercury\", \"body_2\": \"north_node\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 0.2871, \"allowed_orb\": 2.0, \"separation\": 29.7129}, {\"body_1\": \"mars\", \"body_2\": \"pluto\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 0.6635, \"allowed_orb\": 3.0, \"separation\": 149.3365}, {\"body_1\": \"uranus\", \"body_2\": \"neptune\", \"aspect\": \"semisextile\", \"exact_angle\": 30.0, \"orb\": 1.1038, \"allowed_orb\": 2.0, \"separation\": 31.1038}, {\"body_1\": \"venus\", \"body_2\": \"saturn\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 1.5268, \"allowed_orb\": 8.0, \"separation\": 121.5268}, {\"body_1\": \"sun\", \"body_2\": \"chiron\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.5627, \"allowed_orb\": 3.0, \"separation\": 148.4373}, {\"body_1\": \"venus\", \"body_2\": \"north_node\", \"aspect\": \"quincunx\", \"exact_angle\": 150.0, \"orb\": 1.6959, \"allowed_orb\": 3.0, \"separation\": 151.6959}, {\"body_1\": \"mercury\", \"body_2\": \"venus\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 1.983, \"allowed_orb\": 8.0, \"separation\": 121.983}, {\"body_1\": \"moon\", \"body_2\": \"mercury\", \"aspect\": \"trine\", \"exact_angle\": 120.0, \"orb\": 2.5802, \"allowed_orb\": 8.0, \"separation\": 122.5802}, {\"body_1\": \"moon\", \"body_2\": \"north_node\", \"aspect\": \"square\", \"exact_angle\": 90.0, \"orb\": 2.8673, \"allowed_orb\": 8.0, \"separation\": 92.8673}, {\"body_1\": \"jupi"
}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.