724 Endpoints · live
API-Version v2.84.0

AstroWay Calculation API

Astrologische Berechnungen mit Swiss Ephemeris über REST API. 706+ Endpoints: Geburtshoroskope, Synastrie, Progressionen, vedische Astrologie, Human Design, Tarot, Numerologie, KI-Interpretationen, PDF-Berichte, White-Label.

Base URL
https://api.astroway.info/v1
Authentifizierung
X-Api-Key: aw_live_...
Antwort
{ "ok": true, "data": {...} }
Für Entwickler

API-Schlüssel in 60 Sekunden

10.000 Credits pro Monat kostenlos · keine Kreditkarte · Sandbox-Schlüssel (aw_test_*) sofort verfügbar

Authentifizierung

Alle abgerechneten Endpoints benötigen den X-Api-Key-Header. Sandbox-Schlüssel (aw_test_*) führen echte Berechnungen aus, ohne Credits abzuziehen.

free10 req/min
indie30 req/min
starter120 req/min
pro400 req/min
business1000 req/min
enterpriseCustom req/min

Schnellstart

Geburtshoroskop berechnen:

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3,"latitude":50.45,"longitude":30.52}'

Tarife & Pläne

Credit = ein abrechenbarer Aufruf. Cache und identische Wiederholungen werden nicht abgezogen. Überschreitung zu festem Tarif.

Vollständige Preisübersicht →
free
$0/mo

Prototypen, Sandbox · keine Karte

  • 10,000 Credits / Monat
  • 10 Anfragen / Min
  • 1 Schlüssel
Kostenlos starten
indie
$5/mo

Solo-Entwickler, Bots

  • 50,000 Credits / Monat
  • 30 Anfragen / Min
  • 3 Schlüssel
  • $5 / 10K Überschreitung
  • E-Mail-Support (48h)
Schlüssel holen
Beliebteste
starter
$19/mo

Kleine Apps, MVP · beliebt

  • 200,000 Credits / Monat
  • 120 Anfragen / Min
  • 5 Schlüssel
  • $3 / 10K Überschreitung
  • KI-Interpretationen
  • 99.9% SLA
  • Spend Cap
Schlüssel holen
pro
$59/mo

Produktion · Webhooks + MCP

  • 800,000 Credits / Monat
  • 400 Anfragen / Min
  • 20 Schlüssel
  • $3 / 10K Überschreitung
  • Webhooks + MCP
  • Priority-Queue
  • E-Mail-Support (4h)
Schlüssel holen
business
$199/mo

Hochlast-Services

  • 3.5M Credits / Monat
  • 1000 Anfragen / Min
  • Schlüssel
  • $2 / 10K Überschreitung
  • Unbegrenzte Schlüssel
  • 99.95% SLA
  • Slack-Kanal
  • E-Mail-Support (1h)
Schlüssel holen
enterprise
Custom

Dediziert · DPA · SOC 2

  • Credits / Monat
  • Custom Anfragen / Min
  • Schlüssel
  • Dedizierte Infrastruktur
  • GDPR DPA · SOC 2 (geplant)
  • White-Label
Kontakt aufnehmen

Add-on-Pakete

Nischen-Use-Cases — zu jedem Basistarif hinzufügbar.

HD Pack
$9/mo

Human Design ohne westliche Astrologie — Penta, Dream Rave, Hologenetic, Incarnation Cross.

50,000 credits · 12 Endpoints
Schlüssel holen
Esoteric Pack
$9/mo

180+ Endpoints: Tarot (RWS, Marseille, Lenormand), Numerologie (5 Systeme), Geomantie, Runen, Handlesen, I Ching.

200,000 credits · 180 Endpoints
Schlüssel holen
Vedic Pack
$19/mo

165+ vedische Endpoints: Vargas D1–D60, Panchang, Shadbala, Dashas (8 Systeme × 5 Ebenen), KP, Lal Kitab, Jaimini.

100,000 credits · 165 Endpoints
Schlüssel holen
Reports Pack
$99/mo

100 PDFs/Monat zu je $0,99 + White-Label (dein Logo auf PDFs) · 21 Sprachen · A4 · signed-URL CDN.

500,000 credits · 12 Endpoints
Schlüssel holen

Endpoint-Kosten

8 Stufen nach Komplexität und Antwortzeit.

TierCreditsEndpoints
½5/reference/signs · /reference/planets · /esoteric/crystals
110/planets · /sun-times · /planetary-hours · /sabian-symbols
220/chart · /draconic · /heliocentric · /horary
350/synastry · /transits · /progressions · /acg · /human-design
4100/transit-calendar · /forecast-calendar · /group-synastry · /interpret/natal
5250/rectification/trutine · /reports/ai/natal-narrative
6500/rectification
75,000/reports/natal · /reports/synastry · /reports/vedic-kundli

Response-Cache

GET-Anfragen werden bis zu 1h gecacht (ETag + Cache-Control). KI-Interpretationen bei Cache-Hit kosten 50%. Cache-Key berücksichtigt Plan.

Spend Cap (Pro+)

Hartes monatliches USD-Limit. Bei Erreichen liefert die API 402 SPEND_CAP_EXCEEDED — nie eine unerwartete Rechnung.

Sandbox-Schlüssel

Schlüssel mit Präfix aw_test_ führen echte Berechnungen durch, ohne Credits abzuziehen. Tier 4+ auch im Free-Plan zugänglich.

Webhooks

Abonniere credit_usage / overage / plan_change-Events. HMAC-SHA256-Signierung. POST an deine URL.

Response-Header

Bei jeder abgerechneten Anfrage geliefert:

X-RateLimit-Limit120req/min for this key
X-RateLimit-Remaining95requests left this minute
X-RateLimit-Reset1715798460unix timestamp of next reset
X-Credits-Used50credits charged for this call
X-Credits-Remaining199,950monthly credits left
X-Credits-Reset2026-06-01T00:00:00Znext monthly reset
X-Request-Idreq_550e8400-...trace id for debugging
🕉

Vedic

169

️ Vedic endpoints

🃏

Tarot — Rider-Waite-Smith

35

Tarot — Rider-Waite-Smith endpoints

🃏

Tarot — Marseille

21

Tarot — Marseille endpoints

🔮

Esoteric

17

Esoteric endpoints. ⚠️ Cultural and spiritual associations only. Not medical, financial, or psychological advice.

🔮

Geomancy (Agrippa)

16

Geomancy (Agrippa) endpoints

🕐

Prognostics

15

Prognostics endpoints

📅

Calendar & Cycles

15

Calendar & Cycles endpoints

🪝

Webhooks

15

Webhooks endpoints

🧠

Modern Psychological

15

Modern Psychological endpoints

🖼

Visualization

14

️ Visualization endpoints

🐾

Pet Astrology

14

Pet Astrology endpoints. ⚠️ Pet astrology is entertainment-only — no canonical sources. Not a substitute for veterinary care.

📖

Reference

14

Reference endpoints

📄

Reports

14

Reports endpoints

🖼

Embeddable Widgets

14

️ Embeddable Widgets endpoints

🌍

Astro-Geography

13

Astro-Geography endpoints

💼

Business Astrology

12

Business Astrology endpoints. ⚠️ Strategic ideation only — not legal, tax, or investment advice.

Zi Wei Dou Shu (Purple Star) — MVP

12

Zi Wei Dou Shu (Purple Star) — MVP endpoints

🧬

Human Design

12

Human Design endpoints. ⚠️ AstroWay /api computes the BodyGraph mathematically and does not redistribute Jovian Archive's copyrighted interpretation content. End-user-facing readings should reference Jovian Archive trademarks where appropriate.

Zodiac Signs (Per-Sign Deep)

12

Zodiac Signs (Per-Sign Deep) endpoints

🀄

BaZi (Four Pillars)

11

BaZi (Four Pillars) endpoints

💰

Financial Astrology

10

Financial Astrology endpoints. ⚠️ ⚠️ NOT INVESTMENT ADVICE. Entertainment / heuristic only. Consult a licensed financial advisor before any trading decision.

🎯

Aspects & Points

10

Aspects & Points endpoints

🔢

Numerology — Pythagorean

10

Numerology — Pythagorean endpoints

🔢

Numerology — Chaldean

10

Numerology — Chaldean endpoints

🔢

Numerology — Kabbalistic (phonetic)

10

Numerology — Kabbalistic (phonetic) endpoints

🔢

Numerology — Kabbalistic (Mathers strict)

10

Numerology — Kabbalistic (Mathers strict) endpoints

🔢

Numerology — Vedic

10

Numerology — Vedic endpoints

🃏

Tarot — Lenormand

10

Tarot — Lenormand endpoints

🏛

Hellenistic — Brennan tradition

10

️ Hellenistic — Brennan tradition endpoints

🏛

Hellenistic — Hand tradition

10

️ Hellenistic — Hand tradition endpoints

🏛

Hellenistic — Greenbaum tradition

10

️ Hellenistic — Greenbaum tradition endpoints

🏛

Hellenistic — Schmidt tradition

10

️ Hellenistic — Schmidt tradition endpoints

🎯

Cosmobiology / Hamburg School

10

Cosmobiology / Hamburg School endpoints

📡

Real-time Streaming

10

Real-time Streaming endpoints

🤝

Comparisons

9

Comparisons endpoints

🌿

Wellness

9

Wellness endpoints. ⚠️ All wellness endpoints are educational/informational only. Consult a licensed health professional for medical concerns.

🐉

Chinese — Zodiac & Feng Shui

8

Chinese — Zodiac & Feng Shui endpoints

🌽

Mayan Calendars

8

Mayan Calendars endpoints

🤖

AI & MCP

7

AI & MCP endpoints

👑

Dignities & Receptions

6

Dignities & Receptions endpoints

Horary

6

Horary endpoints

🔹

System

6

System endpoints

🔹

Public

6

Public, no-auth read endpoints (IP-rate-limited 30/hr). Every response carries a free-tier `_footer` watermark — no API key required.

🔮

Horoscope

5

Horoscope endpoints

🧠

AI Interpretations

5

AI Interpretations endpoints

🎨

White-label

5

White-label endpoints

🤖

AI Reports

5

AI Reports endpoints

👨‍👩‍👧

Family Astrology

5

Family Astrology endpoints

🔹

Evolutionary Astrology

5

♇ Evolutionary Astrology endpoints

🔌

MCP Advanced

5

MCP Advanced endpoints

🔹

Elder Futhark Runes

5

ᚠ Elder Futhark Runes endpoints

Palmistry (Cheiro)

5

Palmistry (Cheiro) endpoints

I Ching (Standalone)

5

️ I Ching (Standalone) endpoints

Core

4

Core endpoints

🧭

Specialized Charts

4

Specialized Charts endpoints

🪐

Destiny Matrix

1

Destiny Matrix endpoints. ⚠️ Single-author method (Natalia Ladini, CIS market). Not historically attested in classical traditions.

Planeten-IDs

0Sun
1Moon
2Mercury
3Venus
4Mars
5Jupiter
6Saturn
7Uranus
8Neptune
9Pluto
10Mean Node
11True Node
12Mean Lilith
13True Lilith
15Chiron

Haussysteme

"P"Placidus
"K"Koch
"O"Porphyry
"R"Regiomontanus
"C"Campanus
"A"Equal (ASC)
"W"Whole Sign
"M"Morinus
"B"Alcabitius
"T"Polich/Page
"X"Hindu Bhava
"V"Vehlow

Fehlercodes

HTTPCodeBeschreibung
400BAD_JSONUngültiges JSON im Request-Body
400VALIDATION_ERRORZod-Validierung fehlgeschlagen
401MISSING_API_KEYKein X-Api-Key-Header
401INVALID_API_KEYSchlüssel nicht gefunden oder inaktiv
402PLAN_UPGRADE_REQUIREDEndpoint im aktuellen Plan nicht verfügbar
402PLAN_PACK_MISMATCHAnderes Add-on-Paket erforderlich (HD/Vedic/Esoteric/Reports)
402INSUFFICIENT_CREDITSNicht genügend Credits für diesen Aufruf
402SPEND_CAP_EXCEEDEDMonatliches USD-Limit erreicht
403DOMAIN_MISMATCHSchlüssel an anderen Domain gebunden (wp-plugin)
403UNAUTHORIZEDAdmin-Endpoint, unzureichende Rechte
429RATE_LIMITEDAnfragelimit pro Minute überschritten
429RATE_LIMITED_IPIP-Limit für public Endpoints überschritten
500INTERNAL_ERRORInterner Serverfehler
503SERVICE_UNAVAILABLESwiss Ephemeris WASM nicht bereit