# Bauen Sie auf das Astrologie-API AstroWay

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

Astrologischer API · v1

700+ Endpunkte, drei eigene SDK, Genauigkeit Swiss Ephemeris. Anonymer Tarif - beginnen Sie ohne Schlüssel.

[Erhalten Sie einen kostenlosen Schlüssel](https://api.astroway.info/dashboard/sign-up) Schnellstart 10K Kredite/Monat · ohne Karte

## Schnellstart

Erhalten Sie das tägliche Horoskop ohne API-Schlüssel:

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

### Registrieren Sie den kostenlosen Schlüssel

[Erhalten Sie einen kostenlosen Schlüssel - 10K Credits/Monat, ohne Karte](https://api.astroway.info/dashboard/sign-up)

### Die erste Anfrage mit Ihrem Schlüssel

```
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"
```

Sehen Sie sich [Tarife](https://astroway.info/shop/) für die Tariflimits und Kreditkosten pro Endpunkt an.

## Authentifizierung

Drei Tarife. Wählen Sie Ihren.

| Tarif | Authentifizierung | Limits | Wasserzeichen |
| --- | --- | --- | --- |
| **Anonym** | ohne Schlüssel | nur /v1/embed/* · 30 Anfragen/Stunde pro IP | ja |
| **Kostenloser Schlüssel** | `X-Api-Key: aw_live_…` | 10.000 Credits/Monat | ja |
| **Bezahlt** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3,5M | nein (Pro+) |

### Domainbindung

Bezahlte Schlüssel sind bei der ersten Anfrage an eine Domain gebunden. Die Änderung ist bis zu 3 Mal pro Monat über das Benutzerkonto möglich. Die Installation des WordPress-Plugins sendet automatisch den Header X-AstroWay-Site-URL - ohne Code-Änderung.

### Fehlerbehandlung

- `401` — fehlender oder ungültiger X-Api-Key
- `402` — Der Tarif schließt diesen Endpunkt nicht ein (z.B. HD-Endpunkt ohne HD Pack)
- `403` — Domain-Abweichung (gebundene Domain ≠ Origin-Header)
- `429` — Anfragenlimit überschritten oder monatliche Kredite aufgebraucht (Header Retry-After festgelegt)

## Einbaufähige Widgets

Direkter iframe - funktioniert auf jeder HTML-Website, ohne JS-Loader. Anonymes Tarifpaket, 30 Anfragen/Stunde pro IP-Besucher.

### Tageshoroskop

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

### Radix-Wheel

```
<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>
```

### Tageskarte Tarot

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

### Mondphase

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

### Installation auf WordPress

Installiere [AstroWay-Plugin für WP ↗](https://wordpress.org/plugins/astroway/) - Tier-1-Widgets ohne Einstellungen, Shortcodes zum Kopieren, optionalen API-Schlüssel für Tier 2/3.

## Offizielle SDKs

Drei eigene SDKs. Vollständige Typsicherheit, generiert aus OpenAPI 3.1. MIT-Lizenz. Mit Wiederholungsversuchen, idempotent.

### 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 · generiert mit 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+ · sync + async · Pydantic-Modelle · 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+ · PSR-18 HTTP-Client · Guzzle-Promises

### WordPress

WordPress-Website? Das kostenlose Plugin [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) fügt Geburtshoroskope, Horoskope, Tarot, Numerologie und Human Design über Shortcodes und Gutenberg-Blöcke hinzu - ganz ohne Code. Funktioniert anonym oder mit Ihrem API-Schlüssel.

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

### LLM / KI-Agenten

Wir veröffentlichen [/llms.txt ↗](https://api.astroway.info/llms.txt) zur Erkennung durch KI-Agenten. Die Endpunkt-Familie `/v1/context/*` gibt optimiertes LLM-XML für die direkte Nutzung durch ChatGPT-/Claude-/Gemini-Integrationen zurück.

### MCP-Server (Pro+)

Nativer Model Context Protocol-Server auf mcp.astroway.info - verbinden Sie Claude Desktop oder einen beliebigen MCP-Client, um das gesamte API im Dialogmodus abzufragen. Enthalten in Pro- und Business-Tarifen.