AstroWay/api v2.77.5 · production
усі системи в нормі
🚀 Founders' Lifetime Deal — перші 100 customers, $299 одноразово → Indie tier (50K кредитів/міс) назавжди →
v2.77.5 714 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

API астрологічних розрахунків · Swiss Ephemeris · Human Design · AstroWay

714 ендпоінтів. <0.1″ точність. 99.97% uptime. Натальні карти, прогнози, синастрія, Human Design — за один HTTP-запит.

Згенерувати API ключ Читати docs 10 000 кредитів безкоштовно · картка не потрібна
// 01 / playground · astrology api

Зробіть запит. Прямо тут.

● request.ts
1// native fetch — TS SDK auto-gen from OpenAPI 3.1 in dev23const chart = await fetch('https://api.astroway.info/v1/chart', {4 method: 'POST',5 headers: { 'X-Api-Key': process.env.AW_KEY!, 'Content-Type': 'application/json' },6 body: JSON.stringify({ date: '1991-08-24', time: '16:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, houseSystem: 'P' }),7}).then(r => r.json());89console.log(chart.data.planets[0]);
1# requests — Python SDK in dev, native HTTP works today2import os, requests34r = requests.post('https://api.astroway.info/v1/chart',5 headers={'X-Api-Key': os.environ['AW_KEY']},6 json={'date': '1991-08-24', 'time': '16:30:00', 'timezoneOffset': 3, 'latitude': 50.4501,7 'longitude': 30.5234, 'houseSystem': 'P'})89print(r.json()['data']['planets'][0])
1curl https://api.astroway.info/v1/chart \2 -H "X-Api-Key: $AW_KEY" \3 -H "Content-Type: application/json" \4 -d '{5 "date": "1991-08-24",6 "time": "16:30:00",7 "timezoneOffset": 3,8 "latitude": 50.4501,9 "longitude": 30.5234,10 "houseSystem": "P"11}'
● response.json 200 · <100ms
1{2 "planets": {3 "sun": { "sign": "virgo", "degree": 1.123847 },4 "moon": { "sign": "libra", "degree": 14.892731 }5 },6 "houses": [/* 12 cusps */],7 "aspects": [/* 24 items */],8 "meta": {9 "engine": "swisseph",10 "precision": "sub-arcsecond",11 "credits": 1012 }13}
1HTTP/2 200 OK2content-type: application/json; charset=utf-83cache-control: private, max-age=04x-credits-used: 105x-credits-remaining: 499906x-credits-limit: 500007x-credits-reset: 2026-06-01T00:00:00Z8x-request-id: 01HQYK7ZF2N8RB3WPM5JTVD9XE9server-timing: ephe;dur=12, houses;dur=3, aspects;dur=510x-robots-tag: noindex, nofollow11strict-transport-security: max-age=3153600012vary: Origin, Accept-Language
1// Server-Timing breakdown (ms)2dns 2 ▏3tls 8 ▎4ttfb 14 ▍5ephe 12 ▍ // Swiss Ephemeris WASM6houses 3 ▏ // Placidus7aspects 5 ▏ // 24 hits, 8° orb8serialize1 ▏9total 45 ▕▍ // well under 100ms budget1011// Validated against swetest CGI + NASA Eclipse Catalog12// in CI on every PR (183 snapshot fixtures).
credits 10
latency <100ms
cache MISS
engine swisseph
DEMO · 30 req/hr per IP · 6 commands
$
Tab autocomplete · ↵ run · click to try: — demo only; get a key for the full 706-endpoint surface

Спробуй зараз — без реєстрації

Живий запит до /v1/public/chart. 30 запитів/годину з твоєї IP, без ключа.

Powered by POST /v1/public/chart — IP-rate-limited, no auth required
Відповідь з'явиться тут
Заповни форму ліворуч і натисни "Побудувати карту"
// 02 / modules

8 основних + 8 спеціалізованих модулів. 714 ендпоінтів Astrology API.

// 01
40

Натальна & західна

Карта, аспекти, доми, диспозиції, мідпоінти, фіксовані зорі, календар циклів.

// 02
15

Прогностика

Транзити, прогресії, солар-арк, профекції, повернення в реальному часі.

// 03
12

Human Design

Bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross.

// 04
169

Ведична

16 Vargas, Panchang, Shadbala, 4 dasha-системи (Vimshottari/Yogini/Ashtottari/Kalachakra), Yogas, Doshas, Muhurat.

// 05
66

Таро

Rider-Waite-Smith, Marseille, Lenormand. Розклади + довідники для будь-якої колоди.

// 06
51

Нумерологія

5 систем (Pythagorean, Chaldean, Kabbalistic ×2, Vedic) + Destiny Matrix.

// 07
28

Горарна & геоастрологія

Horary, electional, void-of-course Moon + астрокартографія, синастрія, композитні карти.

// 08
10

AI гороскоп

Щоденні/щотижневі + AI-інтерпретації, прив'язані до справжніх ефемерид — без галюцинацій LLM.

// 02b / extras

Ще 8 спеціалізованих модулів. Спеціалізовані сценарії та функції для розробників.

Поза 8 основними hero-модулями ми покриваємо ще 311 ендпоінтів у 8 спеціалізованих категоріях. Деталі по кожному ендпоінту — на сторінці /credits/.

// 09
70

Школи Західної

4 елліністичні школи (Brennan, Greenbaum, Hand, Schmidt) × 10 + сучасна психологічна, еволюційна, космобіологія.

// 10
59

Дивінація & довідник

Геомантія (16 фігур), Руни Старшого Футарку, Хіромантія, I Ching, Sabian Symbols, Crystals, Angel Numbers, Dreams, Reference glyphs.

// 11
39

Китайська & майянська

BaZi (Чотири стовпи), Zi Wei Dou Shu (12 палаців), Китайський зодіак, Tzolkin / Haab / Long Count.

// 12
50

Нішеві сценарії

Wellness (медична / дієта / йога), Pet, Business / Founder, Financial, Family astrology — з дисклеймерами.

// 13
18

PDF репорти

12 типів PDF (natal / synastry / vedic kundli / lal kitab / human-design / tarot…) + 5 AI-наративів. Puppeteer + Handlebars, 21 локалізація.

// 14
56

Інфра для розробників

Webhooks (10 подій), запити стану в реальному часі (10), iframe-віджети для embed (10), розширений MCP (multi-agent / RAG), white-label-конфіг PDF.

// 15
14

Візуалізація

SVG-рендери карт, bodygraph, kundli, таймлайн транзитів — для embed та фронтенду.

// 16
5

Системні

Health, status, OpenAPI 3.1 spec, документація у застосунку.

// 03 / human design

HD-покриття, якого немає більше ніде.

12 ендпоінтів Human Design API. Усі на одному API.

HumanDesign.ai вміє bodygraph + 4 базові ендпоінти. AstrologyAPI.io — лише profile. Ми єдині, хто має Penta, Dream Rave, Hologenetic Profile та Incarnation Cross на той самий Swiss Ephemeris, що й західна астрологія.

// також доступний $9 HD-only pack

AstroWay
12
HumanDesign.ai
4
RoxyAPI
4
AstrologyAPI.io
1
Prokerala
0
VedicAstroAPI
0
// 04 / mcp & ai

AI-агент, що не вигадує ефемериди.

@astroway/mcp — нативний MCP сервер

Підключи до Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) або будь-якого MCP-клієнта однією командою. Працює поверх GPT-4, Claude, Llama 3.3, DeepSeek, Gemini — AI отримує доступ до 714 інструментів і гарантовано викликає реальний API замість того, щоб вигадувати дати.

$ npm install -g @astroway/mcp
https://mcp.astroway.info/mcp

Generic LLM скаже «десь у липні Сатурн тригонує...» — без точної дати. Наш агент робить tool_use POST /v1/transits і повертає UTC-timestamp до секунди.

// працює локально · ключі у власному конфізі · без телеметрії з AstroWay-боку

// працює на mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 714+ tools loaded
user
Коли наступний транзит Сатурна тригон до натал Юпітера?
claude
Виконую розрахунок ефемерид…
POST /v1/transits ✓
→ saturn_to_natal_jupiter · trine · exact: 2026-07-12T14:23:08Z
grounded · 4 credits · <100ms · sub-arcsecond
gpt-4 (без MCP)
hallucinated«Близько липня 2026 року Сатурн утворить тригон…»
no tool call · ±15 діб дрифт · текстова галюцинація
// 04b / sdks

Офіційні SDK під ваш стек. TypeScript · Python · PHP.

Не хочете руками викликати 714 ендпоінтів? Три офіційних клієнти з повним типуванням, retry на 429/5xx, ідемпотентність і єдиною ієрархією помилок. Один паттерн у всіх трьох.

// @astroway/sdk

TypeScript / Node

Обгортка над `openapi-fetch`, ~6 КБ runtime. Path autocomplete + типи запитів/відповідей для кожного ендпоінту. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk
import { Astroway } from '@astroway/sdk'; Відкрити на registry →
// astroway

Python

Sync + async клієнти. PEP 561 stubs, Pydantic v2 моделі, httpx transport, автоматичний retry. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway
from astroway import Astroway Відкрити на registry →
// astroway/sdk

PHP

PSR-18 HTTP client, PSR-3 logger, PSR-17 factories. Symfony / Laravel friendly. PHP 8.1+. Packagist autoload.

$ composer require astroway/sdk
use Astroway\Astroway; Відкрити на registry →

// потрібні інші мови? Усі SDK

// 05 / versus

Глибина як у Solar Fire. Ціна як у side-project.

ProviderEntryCreditsWesternHDMCPUniqueOpenAPI
AstroWay$550K✓ 175✓ 12✓✓ 163.1
Astrology-API.io$111K✓ 130— 1✓— 03.0
Prokerala$19100K✓ 60— 0—— 0—
RoxyAPI$395K✓ 90✓ 4✓— 23.0
HumanDesign.ai$251K—✓ 4—— 0—
VedicAstroAPI$3030K✓ 50— 0—— 0—

// цифри конкурентів — ручні оцінки з публічних сторінок цін · травень 2026 · перевіряємо щоквартально

// 06 / pricing

Платіть лише за виклики.

free
$0/mo
10 000 credits
  • Усі 714 ендпоінтів
  • HD повне
  • 1 API key
  • Без картки
Get started
indie
$5/mo
50 000 credits
  • Все з Free
  • 3 API keys
  • Webhooks
  • Email support
Buy Indie
starter · popular
$19/mo
200 000 credits
  • Все з Indie
  • 10 API keys
  • MCP server
  • Pro-техніки
  • Priority support
Buy Starter
pro
$59/mo
800 000 credits
  • Все з Starter
  • Unlimited keys
  • Dedicated IP
  • SLA
Buy Pro
business
$199/mo
3M credits
  • Все з Pro
  • White-label
  • Custom contract
  • Slack support
Talk to us

// потрібно більше? Enterprise · HD Pack $9 для застосунків тільки з bodygraph

99.9% SLA · платні плани · 30d status →
// 06b / add-ons

Тематичні пакети. Платіть лише за те, що везете в прод.

Горизонтальні add-on підписки для застосунків із вузьким фокусом — замість того, щоб купувати повний тариф. HD Pack описаний окремою секцією вище; решта три — нижче.

// hd-pack
$9/mo

HD Pack

12 ендпоінтів Human Design: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. Той самий Swiss Ephemeris, що й західна астрологія.

Купити HD Pack →
// esoteric-pack
$9/mo

Esoteric Pack

164 ендпоінтів: Tarot, нумерологія (5 систем), руни, I Ching, геомансія, хіромантія, reference. Один ключ, $9/міс.

Купити Esoteric Pack →
// vedic-pack
$19/mo

Vedic Pack

169 ведичних ендпоінтів: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 систем), KP, Lal Kitab, Jaimini.

Купити Vedic Pack →
// reports-pack
$99/mo

Reports Pack

18 PDF-ендпоінтів: natal, synastry, vedic kundli, HD, tarot та інші. White-label + 21 локалізація. 100 PDF/міс.

Купити Reports Pack →
// 07 / trust

Точність професійного астрософту на Swiss Ephemeris.

// engine
Swiss Ephemeris
Той самий Swiss Ephemeris, що в Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold і Janus — професійний астрософт за 30+ років.
// validation
NASA Eclipse Catalog
818 snapshot-тестів проти Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog на кожен PR.
// accuracy
< 0.1″
Sub-arcsecond дрифт (≤0.1″) vs NASA JPL ephemeris і Astrodienst reference. Phase 1-5 закрито.
// powering
100K+ readers
Daily horoscopes на astroway.info та app.astroway.info.
// 08 / questions

Frequently asked questions about the API.

What is the AstroWay astrology API?

A REST API for astrology calculations on the Swiss Ephemeris engine — natal charts, synastry, transits, Human Design, Vedic and AI interpretations across 714 endpoints, all from one API key.

How many endpoints does AstroWay have?

714 endpoints spanning Western astrology, Vedic, Human Design, numerology, tarot and AI interpretation. New endpoints ship continuously and appear in the OpenAPI 3.1 spec.

Is there a free tier?

Yes — 10,000 credits every month, no credit card required. That covers roughly 500 full natal charts per month on the free plan.

Which SDKs are available?

Official TypeScript, Python and PHP SDKs, plus an MCP server so AI agents like Claude can call the API directly as tools.

How accurate are the calculations?

Planetary positions are accurate to under 0.1 arcsecond using the Swiss Ephemeris, verified against Astrodienst swetest, Kerykeion and the NASA eclipse catalog.