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 de cómputo para desarrolladores que crean aplicaciones astrológicas, productos de horóscopo, funciones de compatibilidad para citas y agentes de IA que deben razonar sobre cartas natales.

En este artículo - qué hay realmente dentro de la API, qué decisiones no convencionales tomamos, qué dejamos intencionalmente fuera y cómo llegamos aquí. Sin relleno.

🕓 Registro del 2026-04-22, actualizado 2026-05-09. Algunas cifras están desactualizadas. Estado actual: 865 endpoints (no 87 en el lanzamiento), 888 pruebas snapshot de CI (no 183), MCP server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk ahora todos viven en registros públicos. Estado actualizado - en /faq y registro de cambios.

REST API basado en Swiss Ephemeris - ahora también con interpretaciones de IA sobre cálculos reales. El mismo motor que los astrólogos profesionales han usado 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 NASA JPL y la referencia oficial swetest de Astrodienst (Astro.com).

Cifras:

• 865 endpoint: astrología natal occidental, sinastria, tránsitos, progresiones, direcciones, retornos, armónicos, estrellas fijas, puntos árabes, astrocartografía más el conjunto completo de Human Design
• 183 pruebas snapshot en CI frente a la salida real de swetest CGI y el catálogo de eclipses de NASA - se ejecutan en cada PR
• p50 < 100 ms, p95 < 500 ms para endpoints de cómputo típicos
• MCP server @astroway/mcp + tres SDK en registros públicos: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - el mismo API en tres idiomas
• MCP server: @astroway/mcp - expone 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), de pago - desde $5 / mes

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

Hace tres años empezamos a construir aplicaciones astrológicas para consumidores. La capa de cómputo resultó ser la parte más compleja - significativamente más compleja que la UI o el contenido. Los servicios existentes o:

1. tenían cobertura superficial (10–30 endpoints, principalmente solo natal)
2. eran costosos 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 orientaban hacia la astrología védica y presentaban la occidental como secundaria

Así que vendimos Swiss Ephemeris de forma independiente y escribimos nuestra propia capa de cómputo - primero para el producto para consumidores app.astroway.info, luego para el sitio de marketing astroway.info, que publica horóscopos diarios a cientos de miles de visitantes al mes.

Tras tres años de funcionamiento de este código en producción, llegamos a dos conclusiones:

1. Ese mismo motor de cómputo debe estar disponible para otros desarrolladores: no porque no puedan escribirlo por sí mismos, sino porque la pila biblioteca + caché + CI de precisión representa 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 realmente única. Ningún competidor ofrece un stack completo de HD mediante API.

Esto es el lanzamiento.

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 ayanamsha, disputas sobre cúspides KP, elección de escuela de dasha). La parte védica hecha apresuradamente frente a Prokerala y VedicAstroAPI simplemente habría recibido críticas.

La decisión está fijada: el paquete védico - fase 3 separada, después de que haya una demanda estable para lo occidental y haya tiempo para validarse frente a Jagannatha Hora y Parashara’s Light. Es mejor no lanzar en absoluto que lanzar algo malo.

Una llamada a /chart cuesta aproximadamente 50 veces menos en cómputo que el /forecast-calendar de 365 días. Un precio fijo por solicitud o bien excluiría a los usuarios ligeros o subvencionaría a los pesados. Los créditos asignan el costo al trabajo real - véase la tabla por endpoint en la página de precios.

Las respuestas en el plan gratuito incluyen el campo _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Nosotros no tenemos costo alguno, y a los usuarios gratuitos les da un pequeño incentivo para actualizarse. En el plan Hobby+ se elimina en la configuración de la clave. El patrón lo tomamos de Zapier y RevenueCat.

/rectification (selección de la hora de nacimiento basada en eventos de vida mediante búsqueda likelihood-grid) - computacionalmente costoso: una llamada dura entre 10 y 60 segundos y realiza decenas de miles de cálculos intermedios de Swiss Ephemeris. Lo limitamos al plan Pro ($59 / mes) y le asignamos un alto costo en créditos, porque el abuso sobrecargaría la infraestructura compartida para todos los demás.

Los endpoints /interpret/* funcionan a través de nuestro AI-gateway privado con failover automático entre varios modelos. No te encerramos en nuestros prompts - cada respuesta con interpretación incluye los cálculos originales, así que puedes sobrescribirla con tu propio LLM si nuestra voz no te conviene. Los prompts completos y sus salidas los registramos en una tabla de auditoría para cumplimiento B2B (retención de 90 días).

• Paquete védico: fase 3, después de las primeras confirmaciones de demanda (ver arriba)
• Webhooks para alcanzar umbrales: implementados, pero la UI está cruda; los estamos mejorando
• Widgets públicos (<script src="api.astroway.info/widget/natal.js">) - fase 7
• Complemento para el sitio de marketing principal: proyecto separado, se planea dentro del ecosistema 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. Tarifas, incluida la tabla de créditos por endpoint: api.astroway.info/pricing
4. Regístrate: gratis, sin tarjeta: api.astroway.info/dashboard/sign-up

Si construyes algo con la API - o encuentras un bug, o deseas un endpoint que aún no tenemos - escríbenos. Nosotros preferimos escuchar a cien desarrolladores que piden algo, antes de lanzar características que nadie usa.

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

Roadmap público - PRODUCT-PLAN.md - lo hecho, lo próximo, lo pospuesto y por qué.

¡Bienvenido!