API de estrellas fijas
Más allá de los planetas en movimiento, la capa más antigua de la astrología lee las estrellas fijas —Régulo, Spica, Algol, Aldebarán y sus pares—. Este endpoint escanea una carta natal en busca de conjunciones ajustadas a esas estrellas mayores y devuelve cada contacto con su orbe, para que puedas incorporar el carácter atribuido a una estrella en una lectura.
API de estrellas fijas
A partir de la fecha, hora, desfase UTC y coordenadas de nacimiento suministrados, el endpoint calcula los puntos natales y luego recorre el catálogo de estrellas fijas mayores extraído de la tradición de Vivian Robson y Ptolomeo —las estrellas brillantes y astrológicamente ponderadas, no todo el cielo—. Para cada estrella prueba los puntos natales en busca de una conjunción, y donde una cae dentro del orbe registra el contacto junto con el orbe exacto de separación. La salida bajo data.stars es una lista de impactos estrella-a-punto: qué estrella, qué punto natal toca y cuán estrecha es la alineación, de modo que una conjunción de medio grado se lee como más potente que una en el borde del orbe. Solo se consideran las conjunciones: la técnica trata una estrella como significativa cuando un punto de la carta se sitúa sobre ella, no cuando forma los ángulos longitudinales que los planetas forman entre sí. Esto hace aflorar las estrellas nombradas que las fuentes clásicas singularizaron como afortunadas o peligrosas, listas para emparejarse con tu propio texto sobre el significado estelar.
POST/v1/fixed-stars
curl -X POST https://api.astroway.info/v1/fixed-stars \
-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
}'{
"ok": true,
"data": {
"stars": [
{
"star": "Regulus",
"point": "Mercury",
"orb": 0.4
},
{
"star": "Algol",
"point": "Mars",
"orb": 1.1
}
]
}
}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). |
Cuándo usarlo
Usa este endpoint cuando una lectura de carta quiera la textura adicional de las estrellas nombradas: un intérprete tradicional o consciente de las estrellas fijas, un generador de informes que señale un contacto llamativo con Algol o con la estrella real Régulo, o una herramienta educativa que enseñe la tradición tras las estrellas más brillantes. El diseño de orbe ajustado y solo de conjunciones mantiene la salida enfocada: obtienes el puñado de contactos que vale la pena mencionar en lugar de ruido, lo que facilita renderizarla como una breve lista destacada. Aliméntalo con los mismos datos de nacimiento que enviaste al endpoint natal-chart y los impactos estelares se alinearán con las posiciones planetarias y angulares que ya hay en tu carta, lo que te permite anotar un planeta o ángulo con su estrella colocalizada. Como el catálogo está curado para las estrellas tradicionalmente significativas, puedes adjuntar texto interpretativo preparado a cada una sin curar la lista tú mismo.
Notas
El catálogo de estrellas sigue la selección transmitida a través de Vivian Robson y Ptolomeo: las estrellas fijas mayores astrológicamente significativas, no un sondeo exhaustivo del cielo. Las posiciones natales y las longitudes estelares las calcula el motor WASM de Swiss Ephemeris (Astrodienst) en el zodíaco tropical, y solo se devuelven las conjunciones dentro del orbe.
Prueba la API de Estrellas fijas
Consigue una clave y haz tu primera llamada en menos de un minuto.