# Visión general

**AstroWay API** es un backend profesional para cálculos astrológicos como servicio.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints basados en Swiss Ephemeris (WASM), con cobertura de técnicas que no ofrece ningún competidor: armonías, cartas draconianas, CCG, sectores de Goklen, Human Design completo, rectificación.

## ¿Para quién es?

1. **Desarrolladores de aplicaciones astrológicas** (web, móvil), que necesitan cálculos precisos y variados sin infraestructura propia de cómputo.
2. **Empresas de IA**, que integran funciones astrológicas — hay un servidor MCP nativo para Claude, ChatGPT y otros agentes.
3. **Astrólogos profesionales**, que construyen sus propias herramientas o scripts para clientes.
4. **Investigadores**, que requieren acceso programático a cálculos para estudios estadísticos.
5. **Plataformas de contenido**, que añaden funciones astrológicas sobre productos existentes.

## ¿Para quién **no** es?

- Widgets de horóscopos genéricos como "hoy tu signo es..." sin control — las API de interpretaciones y horóscopos existen (`/interpret/*`, `/horoscope/*`), pero están diseñadas como APIs para desarrolladores, no como widgets listos para usar.
- Astrología védica como especialización principal — para proyectos Vedic-first (sistemas Dasha, Panchang, KP), Prokerala y VedicAstroAPI son más fuertes. Para astrología occidental + Human Design + técnicas raras (rectificación, armonías, CCG), AstroWay las supera. Consulta /compare/.
- Tarot/numerología — solo astrología y Human Design. I-Ching está disponible como endpoint bonus.

## ¿Qué hace único a AstroWay?

### 1. Técnicas raras en formato API

| Técnica | ¿Para qué sirve? |
|---|---|
| **Cartas de armonías** (H2–H180) | Astrología de investigación (método de John Addey) |
| **Carta draconiana** | Astrología kármica/astral |
| **CCG (Cyclo-Carto-Graphy)** | Astrocartografía progresiva — técnica premium de Jim Lewis |
| **Sectores de Goklen** | Astrología estadística, uso académico |
| **Progresiones terciarias** | Tercer tipo de progresiones — nicho pero valorado |
| **Antisciones / contra-antisciones** | Técnica clásica helenística — renacimiento de escuelas tradicionales |
| **Aspectos paralelos** | Aspectos por declinación — prácticas avanzadas |
| **Rectificación por API** | Corrección de hora de nacimiento — valor altísimo |
| **Ciclos planetarios** (conjunciones) | Astrología mundana — eventos globales |
| **Índice cíclico de Barbault** | Astrología mundana |
| **Mínimo de Algol** | Tiempos de estrellas fijas — astrología electiva |
| **Líneas de espacio local** | Astrología direccional similar al Feng Shui |
| **Cadenas de disposición** | Grafos de control — técnica clásica |
| **Almutén figuris** | Técnica medieval — renacimiento tradicional |

### 2. Precisión de Swiss Ephemeris — el mismo motor que usan Solar Fire ($495), Kepler ($995), Astro Gold

El mismo Swiss Ephemeris (LGPL) que utilizan los astrólogos profesionales en Solar Fire, Kepler, Astro Gold y Janus desde hace más de 30 años — pero en versión WASM y como REST API, sin intermediarios ni sobreprecios. Precisión:

- Posiciones planetarias: ±1 segundo de arco vs. efemérides JPL de la NASA
- Cúspides de casas: ±1 minuto de arco
- Validación contra Zet 9, Solar Fire (efemérides propietarias), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — diferencias dentro del margen de error del método (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — cobertura profunda de técnicas occidentales

{siteMeta.westernCount} endpoints de cálculo de astrología occidental (4 escuelas: helenística, psicológica moderna, evolutiva, cosmobiología) + interpretaciones con IA + Human Design completo. Profundidad en lugar de dispersión en docenas de direcciones.

## Arquitectura

```
Tu aplicación
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Cálculo y retorno en JSON
```

- Los cálculos se ejecutan **en el servidor** — sin blobs WASM en el frontend de tu aplicación, sin problemas de licencias de Swiss Ephemeris.
- El estado se mantiene en el servidor — cada solicitud es autónoma. Sin fugas de datos de clientes.
- Las claves API están vinculadas al plan, con límites de rate limit y saldo diario de créditos. Monitoreo a través del dashboard.

## Siguientes pasos

- [Guía de inicio rápido](/getting-started/) — primer request en 5 minutos
- [Autenticación](/authentication/) — cómo obtener y almacenar tu clave
- [Créditos y límites](/rate-limits-credits/) — cómo funciona la facturación
- [Documentación de la API](/docs/api/) — todos los endpoints con playground interactivo