Lanzamiento de la API de AstroWay: pila completa de cálculos astrológicos con precisión de Swiss Ephemeris

Hoy anunciamos AstroWay API — un backend computacional para desarrolladores que crean aplicaciones astrológicas, productos de horóscopos, funciones de compatibilidad para citas y agentes de IA que necesitan razonar sobre cartas de nacimiento.

En este artículo — qué hay realmente dentro de la API, qué soluciones inusuales adoptamos, qué dejamos conscientemente fuera y cómo llegamos aquí. Sin rodeos.

🕓 Registro del 2026-04-22, actualizado 2026-05-09. Algunos números están desactualizados. Estado actual: 723 endpoints (y no 87 en el momento del lanzamiento), 818 pruebas de instantáneas de CI (y no 183), el servidor MCP @astroway/mcp + el SDK de TypeScript @astroway/sdk + el SDK de Python astroway + el SDK de PHP astroway/sdk ahora viven en registros públicos. El estado actual se encuentra en /faq y changelog.

API REST basada en Swiss Ephemeris (LGPL), compilada en WASM y desplegada como servicio de Node.js — ahora también con interpretaciones de IA (cadena de failover GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) sobre cálculos reales. El mismo motor que los astrólogos profesionales han utilizado durante 30+ años en Solar Fire, Kepler, Astro Gold y Janus — precisión hasta una fracción de segundo de arco, verificada con la efeméride de la NASA JPL y la referencia de swetest oficial de Astrodienst (Astro.com).

Números:

• 723 endpoint — astrología natal occidental, sinastria, tránsitos, progresiones, direcciones, retornos, armónicos, estrellas fijas, puntos árabes, astrocartografía más un conjunto completo de Human Design
• 183 pruebas de instantáneas en CI contra la salida real de swetest CGI y el catálogo de eclipses de la NASA — se ejecutan en cada PR
• p50 < 100 ms, p95 < 500 ms para endpoints de cálculo típicos
• Servidor MCP @astroway/mcp + tres SDK en registros públicos: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) — la misma API en tres lenguajes
• Servidor MCP: @astroway/mcp — proporciona la API como herramientas para Claude, GPT, Cursor y otros agentes LLM
• Tarifas basadas en créditos: plan gratuito (10 000 créditos / mes, sin tarjeta), planes pagos — desde $5 / mes

Documentación completa: api.astroway.info/docs/api/. Estado en vivo: api.astroway.info/status.

Hace tres años, comenzamos a construir aplicaciones astrológicas de consumo. La capa de cálculo resultó ser la parte más complicada — mucho más complicada que la UI o el contenido. Los servicios existentes o:

1. Tenían una cobertura superficial (10–30 endpoints, principalmente solo natales)
2. Eran caros a escala ($0.02–$0.10 por solicitud sin descuentos por volumen)
3. Utilizaban motores cerrados, cuya precisión no se puede verificar
4. Se centraban en la astrología védica, y la astrología occidental se presentaba como secundaria

Así que nosotros mismos creamos el Swiss Ephemeris y escribimos nuestra propia capa de cálculo — primero para nuestro producto de consumo app.astroway.info, luego para nuestro sitio web de marketing astroway.info, que proporciona horóscopos diarios a cientos de miles de visitantes al mes.

Después de tres años de ejecutar este código en producción, llegamos a dos conclusiones:

1. El mismo motor de cálculo debe estar disponible para otros desarrolladores — no porque no puedan escribirlo ellos mismos, sino porque la pila biblioteca + WASM + caché + CI de precisión — es medio año de trabajo, que nadie debería repetir.
2. Nuestra cobertura de Human Design (12 endpoints — carta, tipo, autoridad, perfil, puertas, canales, contornos, activaciones planetarias, cruz de encarnación, definición) — es verdaderamente única. Ningún competidor ofrece un conjunto completo de HD a través de la API.

Eso es lo que lanzamos.

Tenemos /nakshatras, /ashtakavarga y endpoints para cartas divisionales, pero no hay Dasha, Panchang, Ashtakoota, KP. La razón: en la astrología védica, hay desacuerdos no resueltos entre escuelas (guerras de ayanamsa, disputas sobre cúspides KP, elección de la escuela de dasha). Una parte védica hecha apresuradamente contra Prokerala y VedicAstroAPI simplemente recibiría críticas.

La solución está fijada: el paquete védico es una fase 3, después de las primeras confirmaciones de demanda (ver arriba).

Una llamada a /chart cuesta ~50 veces menos cálculos que un /forecast-calendar de 365 días. Un precio plano por solicitud o descartaría a los usuarios ligeros, o subsidiaría a los usuarios pesados. Los créditos asignan el costo al trabajo real — ver la tabla de créditos por endpoint en la página de precios.

Las respuestas en el plan gratuito contienen un campo _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — obtén tu propia clave en api.astroway.info"
}

No nos cuesta nada, y a los usuarios gratuitos les da un pequeño incentivo para actualizar. En el plan Hobby+ se elimina en la configuración de la clave. El patrón lo tomamos prestado de Zapier y RevenueCat.

/rectification (selección de hora de nacimiento mediante likelihood-grid búsqueda) — es computacionalmente costoso: una llamada dura 10–60 segundos y realiza decenas de miles de cálculos intermedios de Swiss Ephemeris. Lo limitamos al plan Pro ($59 / mes) y establecimos un gran precio de crédito, porque el abuso agotaría la infraestructura compartida para todos los demás.

Los endpoints /interpret/* se enrutan a través de nuestra puerta de enlace de IA privada, que está sobre los mejores modelos del mercado (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) con failover automático. No te encerramos en nuestros prompts — cada respuesta con interpretación contiene los cálculos de origen, así que puedes volver a preguntar con tu propia LLM, si nuestra voz no te gusta. Los prompts y salidas completos los registramos en la tabla de auditoría para el cumplimiento B2B (almacenamiento de 90 días).

• Paquete védico — fase 3, después de las primeras confirmaciones de demanda (ver arriba)
• Webhooks de umbral — implementados, pero la UI es cruda; lo estamos perfeccionando
• Widgets públicos (<script src="api.astroway.info/widget/natal.js">) — fase 7
• Complemento para el sitio web de marketing principal — proyecto separado, planeado en el marco de la ecología astroway.info

1. Lee la documentación si quieres entender «por qué»: api.astroway.info/overview
2. Inicio rápido en 5 minutos con código: Inicio rápido de la API de astrología
3. Precios, incluyendo la tabla de créditos por endpoint: api.astroway.info/pricing
4. Regístrate — de forma gratuita, sin tarjeta: api.astroway.info/dashboard/sign-up

Si construyes algo sobre la API — o encuentras un error, o deseas un endpoint que aún no tenemos — escríbenos. Nos gusta escuchar a cien desarrolladores que piden algo, en lugar de lanzar características que nadie usa.

Preguntas, solicitudes, casos de borde extraños: hello@astroway.info.

Hoja de ruta pública — PRODUCT-PLAN.md — qué se ha hecho, qué sigue, qué se ha pospuesto y por qué.

Bienvenido.