GET/api/astro/ayanamsa_value/1 crédito

Valor del ayanamsa

El ayanamsa es la diferencia entre el zodíaco tropical, ligado al equinoccio, y el zodíaco sideral de la astrología védica, ligado a las estrellas. Aumenta unos cincuenta segundos de arco al año, así que todo cálculo sideral depende del ayanamsa que adoptes y de la fecha. Este endpoint devuelve solo ese número. Es un GET con parámetros de consulta: `ayanamsa`, un nombre como LAHIRI, RAMAN, KRISHNAMURTI o TRUE_CITRA (se aceptan 47 definiciones estándar de ayanamsa, sin distinguir mayúsculas y minúsculas), y `date`, una fecha ISO que por defecto es la de hoy. Úsalo para indicar en una carta con qué ayanamsa se levantó, o para ver cuánto se separan dos definiciones en una fecha de nacimiento concreta. La respuesta da el valor de dos formas: `value_degrees`, como número con seis decimales, y `degrees`, `minutes` y `seconds`, junto con una cadena `formatted` lista para mostrar. También repite el nombre y la fecha que se ha usado. Un nombre desconocido, y también el pseudoayanamsa 'USER', devuelven 400.

https://api.occultapi.com/api/astro/ayanamsa_value/

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…

Parámetros de consulta (2)

Van en la URL. Son opcionales salvo que se indique lo contrario y se pueden combinar: primero se filtra, luego se pagina y al final se ordena.

Parámetro	Tipo		Ejemplo	Para qué sirve
ayanamsa	string		—	Nombre del ayanamsa (p. ej., LAHIRI). Valor por defecto: LAHIRI. Parámetro de consulta GET. No distingue mayúsculas y minúsculas (.strip.upper). Valor por defecto: 'LAHIRI'. Este endpoint rechaza explícitamente 'USER' aunque el motor de efemérides lo reconozca. Los valores desconocidos devuelven 400 {"error": "Unknown ayanamsa..."}. uno de: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC
date	string		—	Cadena de fecha ISO (p. ej., 1990-05-14). Valor por defecto: hoy. Restricción de FORMATO, no un enum. Cualquier valor que acepte datetime.fromisoformat de Python: 'YYYY-MM-DD' o un datetime ISO 8601 completo, p. ej., '1990-05-14' / '1990-05-14T12:30:00'. Si la cadena incluye una diferencia horaria, se DESCARTA y se sustituye por UTC. Valor por defecto: hoy (UTC). Un formato no válido devuelve 400.

Ejemplo de solicitud

curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
  -H "X-API-Key: $OCCULT_API_KEY"

Respuesta

{
  "ayanamsa": "LAHIRI",
  "date": "2026-09-07",
  "value_degrees": 24.229844,
  "degrees": 24,
  "minutes": 13,
  "seconds": 47,
  "formatted": "24°13'47\""
}

Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data.

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.