709 endpoints · live
API version v2.62.2

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

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
🕉

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

🪝

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

🌍

Astro-Geography

13

Astro-Geography endpoints

📄

Reports

13

Reports 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

📅

Calendar & Cycles

12

Calendar & Cycles 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

🖼

Embeddable Widgets

10

️ Embeddable Widgets 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

🔮

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

🔹

System

5

System 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.

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