API de mapa natal

O endpoint natal-chart converte a data de nascimento, a hora de relógio e o desvio UTC num dia juliano preciso e, em seguida, solicita ao motor Swiss Ephemeris a longitude, a latitude e a velocidade geocêntricas de cada corpo — os dez planetas clássicos mais os nodos lunares, Quíron e a Lua Negra Lilith. Deriva o Ascendente e o Meio-Céu a partir da latitude e da longitude de nascimento, divide as casas pelo sistema escolhido, atribui cada planeta ao seu signo e casa e calcula a grelha completa de aspetos com indicadores de aplicação/separação e orbes exatos. O movimento retrógrado é assinalado a partir da velocidade do corpo, e a seita do mapa (nascimento diurno ou noturno) é devolvida para que a interpretação subsequente possa ponderar corretamente os benéficos e os maléficos.

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "houseSystem": "P"
  }'

{
  "ok": true,
  "data": {
    "planets": [
      { "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
      { "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
    ],
    "houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
    "aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
  }
}

Recorra a este endpoint sempre que precisar do esqueleto estrutural de um horóscopo: um widget de mapa natal, um relatório natal, um fluxo de integração que personaliza conteúdos por Sol/Lua/Ascendente, ou um agente de AI que necessita das posições em bruto antes de interpretar seja o que for. É a chamada pré-requisito para sinastria, trânsitos, progressões e a maioria dos tipos de relatório — calcule o mapa uma vez, coloque o JSON em cache e alimente-o aos endpoints mais pesados em vez de o recalcular sempre. Como a resposta é dados puros (sem prosa, sem imagens), encaixa-se de forma limpa em qualquer stack: renderize-o você mesmo, passe-o a um LLM ou entregue-o a um dos nossos endpoints de renderização SVG.

Os valores predefinidos seguem a convenção ocidental dominante: zodíaco tropical, casas Placidus, o "Trio Principal" Sol–Lua–Ascendente. O motor é o Swiss Ephemeris (Astrodienst) compilado para WASM e partilhado com a calculadora no navegador, pelo que servidor e cliente concordam até ao segundo de arco. As casas recorrem a Porfírio acima do círculo polar, onde Placidus fica indefinido.