API de carta natal
Convierte un único momento de nacimiento en una carta natal completa y estructurada —planetas, cúspides de casas, aspectos y datos angulares— en un solo POST. Zodíaco tropical, trece sistemas de casas, precisión de Swiss Ephemeris, salida en JSON.
API de carta natal
El endpoint natal-chart resuelve la fecha de nacimiento, la hora del reloj y el desfase UTC a un día juliano preciso, y luego solicita al motor Swiss Ephemeris la longitud, latitud y velocidad geocéntricas de cada cuerpo —los diez planetas clásicos más los nodos lunares, Quirón y la Luna Negra Lilith—. Deriva el Ascendente y el Medio Cielo a partir de la latitud y longitud de nacimiento, divide las casas según el sistema que elijas, asigna cada planeta a su signo y casa, y calcula la malla completa de aspectos con indicadores de aplicación/separación y orbes exactos. El movimiento retrógrado se señala a partir de la velocidad del cuerpo, y se devuelve la secta de la carta (nacimiento diurno o nocturno) para que la interpretación posterior pondere correctamente los benéficos y los maléficos.
POST/v1/chart
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 } ]
}
}Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sí | Birth date. |
| time | string (HH:MM:SS) | sí | Local clock time at birth. |
| timezoneOffset | number (hours) | sí | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | sí | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | sí | Birth-place longitude, decimal degrees (east positive). |
| houseSystem | string | no | One-letter Swiss Ephemeris code — P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
Cuándo usarlo
Recurre a este endpoint siempre que necesites la columna vertebral estructural de un horóscopo: un widget de carta natal, un informe natal, un flujo de onboarding que personalice el contenido por Sol/Luna/Ascendente, o un agente de IA que necesite las posiciones en bruto antes de interpretar nada. Es la llamada previa para sinastría, tránsitos, progresiones y la mayoría de los tipos de informe: calcula la carta una vez, almacena el JSON en caché y aliméntalo a los endpoints más pesados en lugar de recalcularla cada vez. Como la respuesta son datos puros (sin prosa ni imágenes), encaja limpiamente en cualquier stack: renderízala tú mismo, pásala a un LLM o entrégala a uno de nuestros endpoints de renderizado SVG.
Notas
Los valores por defecto siguen la convención occidental dominante: zodíaco tropical, casas de Placidus, el «Big Three» Sol–Luna–Ascendente. El motor es Swiss Ephemeris (Astrodienst) compilado a WASM y compartido con la calculadora del navegador, de modo que servidor y cliente coinciden hasta el segundo de arco. Las casas recurren a Porphyry por encima del círculo polar, donde Placidus no está definido.
Prueba la API de Carta natal
Consigue una clave y haz tu primera llamada en menos de un minuto.