709 ендпоінтів · live
версія API v2.62.2

AstroWay Calculation API

Астрологічні розрахунки на базі Swiss Ephemeris через REST API. 706+ ендпоінтів: натальні карти, синастрія, прогресії, ведична астрологія, Human Design, Tarot, Numerology, AI-інтерпретації, PDF-репорти, white-label.

Base URL
https://api.astroway.info/v1
Авторизація
X-Api-Key: aw_live_...
Відповідь
{ "ok": true, "data": {...} }
Для розробників

Отримай API-ключ за 60 секунд

10 000 кредитів на місяць безкоштовно · без банківської картки · sandbox-ключі (aw_test_*) видаються миттєво

Авторизація

Усі billed-ендпоінти вимагають заголовок X-Api-Key. Sandbox-ключі (aw_test_*) працюють як live, але кредити не списуються.

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

Швидкий старт

Розрахувати натальну карту:

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

Тарифи й плани

Кредит = один платний виклик. Кеш і повтори ідентичних запитів не списують. Перевитрата за фіксованою ставкою.

Повна сторінка тарифів →
free
$0/mo

Прототипи, sandbox · без картки

  • 10,000 кредитів / міс
  • 10 запитів / хв
  • 1 ключів
Почати безкоштовно
indie
$5/mo

Соло-розробники, боти

  • 50,000 кредитів / міс
  • 30 запитів / хв
  • 3 ключів
  • $5 / 10K Перевитрата
  • Email-підтримка (48h)
Отримати ключ
Найпопулярніше
starter
$19/mo

Малі застосунки, MVP · популярний

  • 200,000 кредитів / міс
  • 120 запитів / хв
  • 5 ключів
  • $3 / 10K Перевитрата
  • AI-інтерпретації
  • 99.9% SLA
  • Spend cap
Отримати ключ
pro
$59/mo

Production · webhooks + MCP

  • 800,000 кредитів / міс
  • 400 запитів / хв
  • 20 ключів
  • $3 / 10K Перевитрата
  • Webhooks + MCP
  • Priority queue
  • Email-підтримка (4h)
Отримати ключ
business
$199/mo

Високонавантажені сервіси

  • 3.5M кредитів / міс
  • 1000 запитів / хв
  • ключів
  • $2 / 10K Перевитрата
  • Безлімітні ключі
  • 99.95% SLA
  • Slack-канал
  • Email-підтримка (1h)
Отримати ключ
enterprise
Custom

Виділена · DPA · SOC 2

  • кредитів / міс
  • Custom запитів / хв
  • ключів
  • Виділена інфраструктура
  • GDPR DPA · SOC 2 (planned)
  • White-label
Зв'язатися

Add-on пакети

Нішеві use case — додавай до будь-якого базового тарифу.

HD Pack
$9/mo

Human Design без західної астрології — Penta, Dream Rave, Hologenetic, Incarnation Cross.

50,000 credits · 12 ендпоінтів
Отримати ключ
Esoteric Pack
$9/mo

180+ ендпоінтів: Tarot (RWS, Marseille, Lenormand), Numerology (5 систем), Geomancy, Runes, Palmistry, I Ching.

200,000 credits · 180 ендпоінтів
Отримати ключ
Vedic Pack
$19/mo

165+ ведичних ендпоінтів: Vargas D1–D60, Panchang, Shadbala, Dashas (8 систем × 5 рівнів), KP, Lal Kitab, Jaimini.

100,000 credits · 165 ендпоінтів
Отримати ключ
Reports Pack
$99/mo

100 PDF/міс по $0.99 + white-label (свій логотип на PDF) · 21 локалізація · A4 · signed-URL CDN.

500,000 credits · 12 ендпоінтів
Отримати ключ

Вартість ендпоінтів

8 рівнів за складністю та часом виконання.

TierCreditsендпоінти
½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-запити кешуються до 1 год (ETag + Cache-Control). AI-інтерпретації при cache-hit списують 50%. Кеш-ключ враховує план.

Spend cap (Pro+)

Жорсткий місячний USD-ліміт. При досягненні API повертає 402 SPEND_CAP_EXCEEDED — жодних несподіваних рахунків.

Sandbox-ключі

Ключі з префіксом aw_test_ роблять реальні розрахунки, але кредити не списуються. Доступні Tier 4+ навіть на Free плані.

Webhooks

Підписка на події credit_usage / overage / plan_change. HMAC-SHA256 signing. POST до твоєї URL.

Response headers

Сервер повертає для всіх billed-запитів:

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.

ID планет

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

Системи будинків

"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

Коди помилок

HTTPКодОпис
400BAD_JSONНевалідний JSON у тілі запиту
400VALIDATION_ERRORПомилка валідації Zod
401MISSING_API_KEYНемає заголовка X-Api-Key
401INVALID_API_KEYКлюч не знайдено або неактивний
402PLAN_UPGRADE_REQUIREDЕндпоінт недоступний на цьому плані
402PLAN_PACK_MISMATCHПотрібен інший add-on пакет (HD/Vedic/Esoteric/Reports)
402INSUFFICIENT_CREDITSНедостатньо кредитів для виклику
402SPEND_CAP_EXCEEDEDДосягнуто місячного USD-ліміту
403DOMAIN_MISMATCHКлюч прив'язано до іншого домена (wp-plugin)
403UNAUTHORIZEDAdmin-ендпоінт, недостатньо прав
429RATE_LIMITEDПеревищено ліміт запитів/хв
429RATE_LIMITED_IPПеревищено IP-ліміт для public ендпоінтів
500INTERNAL_ERRORВнутрішня помилка сервера
503SERVICE_UNAVAILABLESwiss Ephemeris WASM не готовий