/api/astro/chart_analysis/1 créditoAnálise do mapa
Catorze leituras estruturais de um mapa natal em uma única chamada, mais uma comparação entre um mapa natal e um mapa de trânsito. É a camada interpretativa acima de /api/astro/chart/: em vez das posições, ela diz o que essas posições significam. A resposta sempre traz os mesmos campos. `house_from_reference_chart` dá a casa em que `target_celestial`, no mapa de trânsito, cai quando contada a partir de `ref_celestial` no mapa natal. `kendras` agrupa os corpos natais por casa angular. `argala` e `virodhargala` dão, para cada corpo, os planetas que intervêm e os que obstruem, indexados respectivamente pela 2ª, 4ª, 5ª e 11ª e pela 12ª, 10ª, 9ª e 3ª. `bhava_arudhas` e `ghara_arudhas` são as imagens projetadas das casas e dos planetas. `temporary_relationships` e `compound_relationships` são as amizades próprias deste mapa. `karakas` são os chara karakas, `nakshatra_count` é a distância em estrelas a partir do corpo de referência, e `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` e `pachakadi_relations` são as verificações de dignidade. Os dois mapas são sempre mapas rashi: `chart_name_natal` e `chart_name_transit` são rótulos em formato livre e, apesar dos nomes, não selecionam um mapa divisional. `mode` escolhe entre oito ou sete chara karakas, e `rahu` escolhe nodos verdadeiros ou médios só para o bloco de karakas. É permitido definir `ref_celestial` como 'ascendant'; nesse caso, os dois campos de relacionamento, que por definição são de planeta para planeta, retornam null.
https://api.occultapi.com/api/astro/chart_analysis/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 |
|---|---|---|---|
| chart_name_natal | string | obrigatório | Rótulo em FORMATO LIVRE, NÃO um seletor de tipo de mapa. Apesar do nome, este endpoint sempre constrói um RashiChart; a string é armazenada como rótulo de exibição e nunca é validada. Qualquer string não vazia funciona. |
| chart_name_transit | string | obrigatório | Rótulo em FORMATO LIVRE, NÃO um seletor de tipo de mapa. Igual a chart_name_natal. |
| date_time_natal | string (date-time) | obrigatório | Restrição de FORMATO. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC). |
| date_time_transit | string (date-time) | obrigatório | Restrição de FORMATO. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC). |
| latitude_natal | number (double) | obrigatório | min -180 · max 180 |
| latitude_transit | number (double) | obrigatório | min -180 · max 180 |
| longitude_natal | number (double) | obrigatório | min -180 · max 180 |
| longitude_transit | number (double) | obrigatório | min -180 · max 180 |
| mode | integer | obrigatório | 78Inteiro, não string, mas restrito: 8 = oito chara karakas (inclui Pitri Karaka e Rahu), 7 = sete karakas (Rahu excluído). Apenas 7 e 8 fazem sentido. |
| rahu | string | obrigatório | truemeanDiferencia maiúsculas de minúsculas; em minúsculas. Apenas 'true' é testado explicitamente; qualquer outro valor (incluindo 'mean' segue o ramo else e se comporta como 'mean'. Afeta apenas o bloco `karakas`. |
| ref_celestial | string | obrigatório | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeDiferencia maiúsculas de minúsculas; tudo em minúsculas. 'ascendant' funciona para as partes house_from_reference_chart e nakshatra_count; quando ref_celestial='ascendant', os campos temporary_relationships e compound_relationships vêm null de propósito. Um nome não reconhecido retorna 400 (KeyError). |
| target_celestial | string | obrigatório | sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannodeAceita os mesmos valores que ref_celestial. |
| bhava_arudha_exceptions | boolean | opcional | |
| graha_arudha_exceptions | boolean | opcional | |
| nakshatras | string | opcional |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/chart_analysis/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"mercury","target_celestial":"mars","rahu":"true","mode":0}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"house_from_reference_chart\": {\"house_from_ref\": 9, \"zodiac_sign_in_ref\": \"Cn\"}, \"kendras\": [[\"venus\", \"jupiter\", \"pluto\"], [\"sun\", \"moon\", \"mercury\", \"mars\", \"uranus\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], [\"saturn\", \"neptune\"]], \"argala\": {\"sun\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"moon\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"mercury\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"venus\": {\"2\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"4\": [\"pluto\"], \"5\": [\"northtruenode\", \"northmeannode\"], \"11\": [\"southtruenode\", \"southmeannode\"]}, \"mars\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"jupiter\": {\"2\": [\"southtruenode\", \"southmeannode\"], \"4\": [\"venus\"], \"5\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"11\": [\"uranus\"]}, \"saturn\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"uranus\": {\"2\": null, \"4\": [\"southtruenode\", \"southmeannode\"], \"5\": null, \"11\": [\"saturn\", \"neptune\"]}, \"neptune\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"pluto\": {\"2\": [\"northtruenode\", \"northmeannode\"], \"4\": null, \"5\": [\"uranus\"], \"11\": [\"sun\", \"moon\", \"mercury\", \"mars\"]}, \"northtruenode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"northmeannode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"southtruenode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}, \"southmeannode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}}, \"virodhargala\": {\"sun\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"moon\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"mercury\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"venus\": {\"3\": null, \"9\": null, \"10\": [\"jupiter\"], \"12\": null}, \"mars\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"jupiter\": {\"3\": null, \"9\": [\"saturn\", \"neptune\"], \"10\": null, \"12\": null}, \"saturn\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"uranus\": {\"3\": [\"jupiter\"], \"9\": [\"pluto\"], \"10\": [\"northtruenode\", \"northmeannode\"], \"12\": null}, \"neptune\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"pluto\": {\"3\": [\"saturn\", \"neptune\"], \"9\": null, \"10\": [\"venus\"], \"12\": null}, \"northtruenode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"northmeannode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"southtruenode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}, \"southmeannode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}}, \"bhava_arudhas\": {\"A1\": \"Taurus\", \"A2\": \"Aries\", \"A3\": \"Scorpio\", \"A4\": \"Gemini\", \"A5\": \"Pisces\", \"A6\": \"Aries\", \"A7\": \"Pisces\", \"A8\": \"Scorpio\", \"A9\": \"Capricorn\", \"A10\": \"Cancer\", \"A11\": \"Leo\", \"A12\": \"Aquarius\"}, \"ghara_arudhas\": {\"A1\": \"Leo\", \"A2\": \"Leo\", \"A3\": \"Leo\", \"A4\": \"Cancer\", \"A5\": \"Leo\", \"A6\": \"Pisces\", \"A7\": \"Scorpio\", \"A8\": \"Pisces\", \"A9\": \"Scorpio\", \"A10\": \"Taurus\", \"A11\": \"Aries\", \"A12\": \"Aries\"}, \"temporary_relationships\": {\"friends\": [\"venus\", \"pluto\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], \"enemies\": [\"sun\", \"moon\", \"mars\", \"jupiter\", \"saturn\", \"uranus\", \"neptune\"]}, \"compound_relationships\": \"Satru\", \"karakas\": {\"ak\": {\"venus\": {\"degree\": 23, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 43}}, \"amk\": {\"mars\": {\"degree\": 17, \"sign\": \"Sc\", \"minutes\": 52, \"seconds\": 44}}, \"bk\": {\"moon\": {\"degree\": 15, \"sign\": \"Sc\", \"minutes\": 20, \"seconds\": 27}}, \"mk\": {\"northtruenode\""
}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.