Metodología

Las posiciones planetarias se calculan a partir de las efemérides de NASA JPL: el conjunto completo de 105 MB, no una versión reducida, con 735 estrellas fijas y una cobertura de 500–2999 d. C. Nada se interpola a partir de una tabla de almanaque precalculada y no hay resultados en caché: cada respuesta se calcula para el instante y las coordenadas exactos de la solicitud.

Ese rango importa en dos casos reales: las cartas históricas y los análisis de dashas y tránsitos a largo plazo, que se extienden décadas más allá del presente. Una librería limitada a la era moderna pierde precisión en los extremos sin avisar.

El mismo motor de cálculo hace funcionar Yoga Panchang, nuestro sitio gratuito de panchang y Jyotish, así que las cifras que sus lectores ven cada día salen del código que se describe aquí.

La mayor fuente de discrepancia entre dos cálculos védicos no es la aritmética, sino el ayanamsa. Las tradiciones indias discrepan de verdad sobre él, y una diferencia de un grado basta para que un planeta cruce el límite de un nakshatra.

Por eso ofrecemos 48: la familia Surya Siddhanta, true Citra, true Revati, true Pushya, Raman, KP, Yukteshwar y el resto, y puedes corregir cualquiera de ellos en grados, minutos y segundos. No ofrecemos uno solo y lo declaramos el correcto. Si nuestro resultado no coincide con otra fuente, lo primero que debes comprobar es si las dos usan el mismo ayanamsa.

Esto es lo que la mayoría de las documentaciones de API no puede decir. Nuestra referencia no se escribe a mano: build_api_catalogue la genera a partir de los propios serializadores y después verify_api_catalogue la comprueba contra un servidor en funcionamiento, enviando cada solicitud de ejemplo documentada y verificando que devuelve un 2xx.

El resultado es lo que de verdad importa: 255 de las 299 páginas de endpoints muestran una respuesta real capturada, no una inventada, y las demás aparecen marcadas como pendientes de verificar en lugar de hacerlas pasar por funcionales. Un campo no puede desaparecer de la documentación sin que nadie lo note, como pasa con una hoja de cálculo mantenida a mano. Si cambia un serializador y la documentación no se regenera, la verificación falla en lugar de publicar algo falso.

El mismo catálogo genera la especificación OpenAPI, la colección de Postman y el archivo llms.txt, así que los cuatro describen por construcción la misma API.

El backend tiene 1783 funciones de test repartidas en 87 módulos. Donde más se concentran es en la medición del consumo, porque es ahí donde un error le cuesta dinero a alguien: que una llamada correcta descuente exactamente lo que cuesta el endpoint, que un 4xx o un 5xx no descuenten nada, que dos solicitudes simultáneas por el último crédito no puedan dejar el saldo en negativo y que el registro contable cuadre con el saldo tras una secuencia aleatoria de abonos y gastos.

Publicamos una mediana de 62 ms y un 76 % por debajo de 100 ms. Esas cifras salen de llamar a 254 ejemplos publicados el 22 de octubre de 2026, cada uno con su propia solicitud de ejemplo, contra una instancia local de la API (una vez para calentar y otra cronometrada), no de cronometrar un endpoint rápido y redondear. El chat con IA queda fuera: su tiempo es el del modelo de lenguaje.

Por eso también decimos esto: unos pocos endpoints son mucho más lentos, y así lo indica la documentación. Un barrido completo de varshaphal o un año de raasi dasha tardan segundos, no milisegundos, porque son un análisis y no una consulta. La mediana lo esconde; publicar la distribución junto a ella, no.

mediana  62 ms      la mitad de los endpoints responde más rápido
<100 ms  76 %       la mayoría de las consultas habituales
lentos   segundos   análisis profundos, señalados en la referencia

Dos cosas que nos gustaría publicar y todavía no hemos publicado. Te lo decimos claramente para que no tengas que suponerlo:

• Una comparativa independiente de posiciones. Calculamos a partir de las efemérides de JPL, pero aún no hemos publicado una prueba que compare nuestros resultados con JPL Horizons en una variedad de fechas y cuerpos celestes, con las desviaciones y el código para reproducirla. Hasta entonces, entiende nuestra afirmación sobre la precisión como «calculado a partir de esta fuente» y no como «verificado dentro de este margen».
• Disponibilidad a largo plazo. Solo desde octubre de 2026 publicamos la disponibilidad en la página de estado, así que aún no hay un historial largo que citar. Consulta la página de transparencia para ver a qué sí nos comprometemos.

Las dos cosas están en la lista. Ninguna es difícil; las dos son trabajo que preferimos hacer bien antes que de forma aproximada.

El Playground hace llamadas reales con tu propia clave, y una llamada fallida no cuesta nada, así que puedes comparar nuestros resultados con la fuente en la que ya confías. Si encuentras una discrepancia que no se explique por el ayanamsa, queremos saberlo.