# Construya con la API astrológica AstroWay

Source: https://astroway.info/es/developers/
Language: es
Updated: 2026-05-28

API Astrológica · v1

Más de 700 endpoints, tres SDK propios, precisión de Swiss Ephemeris. Plan anónimo - empiece sin clave.

[Obtener clave gratuita](https://api.astroway.info/dashboard/sign-up) Inicio rápido 10K créditos/mes · sin tarjeta

## Inicio rápido

Obtenga el horóscopo diario sin clave API:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### Registre una clave gratuita

[Obtenga una clave gratuita - 10K créditos/mes, sin tarjeta](https://api.astroway.info/dashboard/sign-up)

### Primera solicitud con su clave

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

Consulte [tarifas](https://astroway.info/shop/) para conocer los límites de tarifas y el costo de los créditos por punto final.

## Autenticación

Tres tarifas. Elige la tuya.

| Tarifa | Autenticación | Límites | Marca de agua |
| --- | --- | --- | --- |
| **Anónimo** | sin clave | solo /v1/embed/* · 30 solicitudes/hora por IP | sí |
| **Clave gratuita** | `X-Api-Key: aw_live_…` | 10K créditos/mes | sí |
| **Pago** | `X-Api-Key: aw_live_…` | Indie 50K / Principiante 200K / Pro 800K / Negocio 3.5M | no |

### Vinculación al dominio

Las claves de pago se vinculan a un solo dominio durante la primera solicitud. Se pueden cambiar manualmente en el panel de control hasta 3 veces al mes. La instalación del plugin de WordPress envía automáticamente el encabezado X-AstroWay-Site-URL sin necesidad de modificar el código.

### Procesamiento de errores

- `401` — X-Api-Key ausente o no válido
- `402` — la tarifa no incluye este endpoint (ej. endpoint HD sin el Pack HD)
- `403` — incongruencia de dominio (dominio vinculado ≠ encabezado Origin)
- `429` — límite de solicitudes excedido o créditos mensuales agotados (se establece el encabezado Retry-After)

## widgets incrustados

iframe directo - funciona en cualquier sitio web HTML, sin cargador JS. Tarifa anónima, 30 solicitudes/hora por IP del visitante.

### Horóscopo diario

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### Rueda de la carta natal

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### Carta del día del Tarot

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### Fase Lunar

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### Instalación en WordPress

Instale [plugin AstroWay para WP ↗](https://wordpress.org/plugins/astroway/) - widgets de Nivel 1 sin configuración, shortcodes para copiar, clave API opcional para Nivel 2/3.

## SDK oficiales

Tres SDK propios. Seguridad de tipos completa, generados a partir de OpenAPI 3.1. Licencia MIT. Con reintentos e idempotentes.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · generado con OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sincrónico + asincrónico · modelos Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · cliente HTTP PSR-18 · promesas Guzzle

### WordPress

¿Sitio en WordPress? El plugin gratuito [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) añade cartas natales, horóscopos, Tarot, numerología y Human Design mediante shortcodes y bloques de Gutenberg, sin código. Funciona de forma anónima o con su clave API.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### Agentes de LLM / IA

Publicamos [/llms.txt ↗](https://api.astroway.info/llms.txt) para detectar agentes de IA. La familia de puntos finales `/v1/context/*` devuelve XML optimizado para LLM para el consumo directo de integraciones ChatGPT / Claude / Gemini.

### Servidor MCP (Pro+)

Servidor nativo de Protocolo de Contexto de Modelo en mcp.astroway.info - conecte Claude Desktop o cualquier cliente MCP para consultar toda la API en modo de diálogo. Incluido en los planes Pro y Business.