AstroWay App
759 endpoints · live
API version v2.149.15

AstroWay Calculation API

Swiss Ephemeris powered astrology calculations via REST API. 706+ endpoints: natal charts, synastry, progressions, Vedic, Human Design, Tarot, Numerology, AI interpretations, PDF reports, white-label.

Base URL
https://api.astroway.info/v1
Authentication
X-Api-Key: aw_live_...
Response
{ "ok": true, "data": {...} }
For developers

Get your API key in 60 seconds

10,000 credits per month free · no credit card · sandbox keys (aw_test_*) issued instantly

Start freeSee all plans →

Authentication

All billed endpoints require X-Api-Key header. Sandbox keys (aw_test_*) run real calculations but skip billing.

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

Quick Start

Compute a natal chart:

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}'

Pricing & Plans

Credits = one billable call. Cached and identical replays don't deduct. Overage at a fixed rate.

Full pricing details →
free
$0/mo

Prototypes, sandbox · no card

  • 10,000 credits / month
  • 10 req / min
  • 1 keys
Start free
indie
$5/mo

Solo developers, bots

  • 50,000 credits / month
  • 30 req / min
  • 3 keys
  • $5 / 10K Overage
  • Email support (48h)
Get key
Most popular
starter
$19/mo

Small apps, MVP · popular

  • 200,000 credits / month
  • 120 req / min
  • 5 keys
  • $3 / 10K Overage
  • AI interpretations
  • 99.9% SLA
  • Spend cap
Get key
pro
$59/mo

Production · webhooks + MCP

  • 800,000 credits / month
  • 400 req / min
  • 20 keys
  • $3 / 10K Overage
  • Webhooks + MCP
  • Priority queue
  • Email support (4h)
Get key
business
$199/mo

High-traffic services

  • 3.5M credits / month
  • 1000 req / min
  • ∞ keys
  • $2 / 10K Overage
  • Unlimited keys
  • 99.95% SLA
  • Slack channel
  • Email support (1h)
Get key
enterprise
Custom

Dedicated · DPA · SOC 2

  • ∞ credits / month
  • Custom req / min
  • ∞ keys
  • Dedicated infrastructure
  • GDPR DPA · SOC 2 (planned)
  • White-label
Contact sales

Add-on packs

Niche use cases — stack on top of any base plan.

HD Pack
$9/mo

Human Design without Western astrology — Penta, Dream Rave, Hologenetic, Incarnation Cross.

50,000 credits · 12 endpoints
Get key
Esoteric Pack
$9/mo

180+ endpoints: Tarot (RWS, Marseille, Lenormand), Numerology (5 systems), Geomancy, Runes, Palmistry, I Ching.

200,000 credits · 180 endpoints
Get key
Vedic Pack
$19/mo

165+ Vedic endpoints: Vargas D1–D60, Panchang, Shadbala, Dashas (8 systems × 5 levels), KP, Lal Kitab, Jaimini.

100,000 credits · 165 endpoints
Get key
Reports Pack
$99/mo

100 PDFs/month at $0.99 each + white-label (your logo on PDFs) · 21 locales · A4 · signed-URL CDN.

500,000 credits · 12 endpoints
Get key

Endpoint costs

8 tiers by complexity and response time.

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 requests cached up to 1h (ETag + Cache-Control). AI interpretations on cache-hit charge 50%. Cache key includes plan.

Spend cap (Pro+)

Hard monthly USD limit. When reached the API returns 402 SPEND_CAP_EXCEEDED — never an unexpected invoice.

Sandbox keys

Keys prefixed aw_test_ run real computations but don't deduct credits. Access Tier 4+ even on the Free plan.

Webhooks

Subscribe to credit_usage / overage / plan_change events. HMAC-SHA256 signing. POSTed to your URL.

Response headers

Returned on every billed request:

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
OpenAPI 3.1 Spec
/v1/openapi.json

Import into Postman, Insomnia, or generate SDKs

Swagger UI
/v1/docs

Interactive playground — test any endpoint

Full documentation
api.astroway.info/docs

Starlight docs site with cURL / Node / Python / PHP examples per endpoint

🕉

Vedic

174

️ Vedic endpoints

🃏

Tarot: Rider-Waite-Smith

35

Tarot: Rider-Waite-Smith endpoints

🃏

Tarot: Marseille

21

Tarot: Marseille endpoints

🌍

Astro-Geography

19

Astro-Geography endpoints

📄

Reports

18

Reports 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

🐉

Chinese: Zodiac & Feng Shui

14

Chinese: Zodiac & Feng Shui 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

🖼

Embeddable Widgets

14

️ Embeddable Widgets endpoints

⭐

Zi Wei Dou Shu (Purple Star): MVP

13

Zi Wei Dou Shu (Purple Star): MVP endpoints

💼

Business Astrology

12

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

🧬

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

🎯

Aspects & Points

11

Aspects & Points endpoints

🤝

Comparisons

10

Comparisons endpoints

🌿

Wellness

10

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

💰

Financial Astrology

10

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

🔢

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

🌽

Mayan Calendars

8

Mayan Calendars endpoints

🔹

Public

8

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

🤖

AI & MCP

7

AI & MCP endpoints

👑

Dignities & Receptions

6

Dignities & Receptions endpoints

❓

Horary

6

Horary endpoints

🔹

System

6

System endpoints

🔮

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

🌐

Content Localization

4

Content Localization endpoints

🕎

Kabbalah

3

Kabbalah endpoints. ⚠️ The Latin transliterations of the angel names, their el/yah suffixes and any birth-angel attribution are deliberately absent: no source states them as a table with provenance.

🪐

Destiny Matrix

1

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

🤖

Agent Platform

1

Agent Platform endpoints

Planet IDs

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

House Systems

"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

Error Codes

HTTPCodeDescription
400BAD_JSONInvalid JSON in request body
400VALIDATION_ERRORZod validation failed
401MISSING_API_KEYNo X-Api-Key header
401INVALID_API_KEYKey not found or inactive
402PLAN_UPGRADE_REQUIREDEndpoint not available on this plan
402PLAN_PACK_MISMATCHRequires different add-on pack (HD/Vedic/Esoteric/Reports)
402INSUFFICIENT_CREDITSNot enough credits for this call
402SPEND_CAP_EXCEEDEDMonthly USD spend limit reached
403DOMAIN_MISMATCHKey bound to different domain (wp-plugin)
403UNAUTHORIZEDAdmin endpoint, insufficient permissions
429RATE_LIMITEDPer-minute rate limit exceeded
429RATE_LIMITED_IPIP rate limit exceeded for public endpoints
500INTERNAL_ERRORInternal server error
503SERVICE_UNAVAILABLESwiss Ephemeris WASM not ready