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 не готов