AstroWay/api v2.77.14 · pl
wszystkie systemy w normie
🚀 Founders' Lifetime Deal — pierwsze 100 customers, $299 jednorazowo → Indie tier (50K kredytów/mies) na zawsze
v2.77.14 714 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

API obliczeń astrologicznych · Swiss Ephemeris · Human Design · AstroWay

714 punktów końcowych. <0.1″ dokładność. 99.97% uptime. Mapy natalne, prognozy, synastria, Human Design — w jednym żądaniu HTTP.

Wygeneruj klucz API Czytaj dokumentację 10 000 kredytów za darmo · karta nie jest potrzebna
// 01 / playground · astrology api

Zrób zapytanie. Tutaj.

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, без ключа.

Відповідь з'явиться тут
Заповни форму ліворуч і натисни "Побудувати карту"
// 02 / moduły

8 podstawowych + 8 specjalistycznych modułów. 714 punktów końcowych Astrology API.

// 01
40

Natalna & zachodnia

Mapa, aspekty, domy, dyspozycje, miedpointy, stałe gwiazdy, kalendarz cykli.

// 02
15

Prognozowanie

Tranzyty, progresje, solar-ark, profekcje, powroty w czasie rzeczywistym.

// 03
12

Human Design

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

// 04
169

Wedyjska

16 Vargas, Panchang, Shadbala, 4 systemy dasha (Vimshottari/Yogini/Ashtottari/Kalachakra), Yogas, Doshas, Muhurat.

// 05
66

Tarot

Rider-Waite-Smith, Marseille, Lenormand. Rozkłady + przewodniki dla każdej talii.

// 06
51

Numerologia

5 systemów (Pitagorejski, Chaldejski, Kabała ×2, Wedyjski) + Destiny Matrix.

// 07
28

Horarna & geoastrologia

Horarna, wyborcza, Księżyc w kursie + astrocartografia, synastria, mapy kompozytowe.

// 08
10

AI horoskop

Codzienne/tygodniowe + AI-interpretacje, związane z rzeczywistymi efemerydami — bez halucynacji LLM.

// 02b / dodatki

Jeszcze 8 specjalistycznych modułów. Specjalistyczne scenariusze i funkcje dla deweloperów.

Poza 8 głównymi modułami hero pokrywamy jeszcze 311 endpointów w 8 wyspecjalizowanych kategoriach. Szczegóły dotyczące każdego endpointu — na stronie /credits/.

// 09
70

Szkoły Zachodniej

4 hellenistyczne szkoły (Brennan, Greenbaum, Hand, Schmidt) × 10 + nowoczesna psychologiczna, ewolucyjna, kosmobiologia.

// 10
59

Dewinacja & przewodnik

Geomancja (16 figur), Runes Starego Futharku, Chiromancja, I Ching, Sabian Symbols, Kryształy, Liczby Aniołów, Sny, Glyphy referencyjne.

// 11
39

Chińska & majów

BaZi (Cztery filary), Zi Wei Dou Shu (12 pałaców), Chiński zodiak, Tzolkin / Haab / Long Count.

// 12
50

Niszowe scenariusze

Wellness (medyczna / dieta / joga), Zwierzęta, Biznes / Założyciel, Finanse, Astrologia rodzinna — z zastrzeżeniami.

// 13
18

Raporty PDF

12 typów PDF (natal / synastria / wedyjski kundli / lal kitab / human-design / tarot…) + 5 narracji AI. Puppeteer + Handlebars, 21 lokalizacji.

// 14
56

Infrastruktura dla deweloperów

Webhooks (10 zdarzeń), zapytania stanu w czasie rzeczywistym (10), iframe-widżety do osadzenia (10), rozszerzone MCP (multi-agent / RAG), white-label-konfiguracja PDF.

// 15
14

Wizualizacja

Renderowanie SVG map, bodygraph, kundli, oś czasu tranzytów — do osadzenia i frontendu.

// 16
5

Systemowe

Zdrowie, status, specyfikacja OpenAPI 3.1, dokumentacja w aplikacji.

// 03 / design ludzki

Pokrycie HD, którego nie ma nigdzie indziej.

12 punktów końcowych Human Design API. Wszystko w jednym API.

HumanDesign.ai obsługuje bodygraph + 4 podstawowe punkty końcowe. AstrologyAPI.io — tylko profil. Jesteśmy jedynymi, którzy mają Penta, Dream Rave, Hologenetic Profile i Incarnation Cross na tym samym Swiss Ephemeris, co zachodnia astrologia.

// również dostępny $9 pakiet HD-only

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

Agent AI, który nie wymyśla efemeryd.

@astroway/mcp — natywny serwer MCP

Podłącz do Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) lub dowolnego klienta MCP jednym poleceniem. Działa na GPT-4, Claude, Llama 3.3, DeepSeek, Gemini — AI ma dostęp do 714 narzędzi i gwarantuje wywołanie rzeczywistego API zamiast wymyślania dat.

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

Generic LLM powie „gdzieś w lipcu Saturn trigonu...” — bez dokładnej daty. Nasz agent wykonuje tool_use POST /v1/transits i zwraca UTC-timestamp do sekundy.

// działa lokalnie · klucze w własnym konfigu · bez telemetrii z AstroWay-boku

// działa na mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 714+ tools loaded
user
Kiedy następny tranzyt Saturna w trygonie do natalnego Jowisza?
claude
Wykonuję obliczenia efemeryd…
POST /v1/transits
→ saturn_to_natal_jupiter · trine · exact: 2026-07-12T14:23:08Z
grounded · 4 credits · <100ms · sub-arcsecond
gpt-4 (bez MCP)
hallucinated„W okolicach lipca 2026 roku Saturn utworzy trygon…”
brak wywołania narzędzia · ±15 dni dryfu · halucynacja tekstowa
// 04b / sdks

Oficjalne SDK pod Twoje środowisko. TypeScript · Python · PHP.

Nie chcesz ręcznie wywoływać 714 endpointów? Trzy oficjalne klienci z pełnym typowaniem, retry na 429/5xx, idempotencją i jedną hierarchią błędów. Jeden wzorzec we wszystkich trzech.

// @astroway/sdk

TypeScript / Node

Obudowa nad `openapi-fetch`, ~6 KB runtime. Path autocomplete + typy żądań/odpowiedzi dla każdego endpointu. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk
import { Astroway } from '@astroway/sdk'; Otwórz w rejestrze →
// astroway

Python

Sync + async klienci. PEP 561 stubs, Pydantic v2 modele, httpx transport, automatyczny retry. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway
from astroway import Astroway Otwórz w rejestrze →
// 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; Otwórz w rejestrze →

// potrzebne inne języki? Wszystkie SDK

// 05 / versus

Głębokość jak w Solar Fire. Cena jak w 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

// liczby konkurentów — ręczne oceny z publicznych stron cenowych · maj 2026 · sprawdzamy co kwartał

// 06 / cennik

Płać tylko za wywołania.

darmowy
$0/mo
10 000 kredytów
  • Wszystkie 714 endpointy
  • HD pełne
  • 1 klucz API
  • Bez karty
Zacznij
indie
$5/mo
50 000 kredytów
  • Wszystko z Free
  • 3 klucze API
  • Webhooks
  • Wsparcie e-mail
Kup Indie
starter · popularny
$19/mo
200 000 kredytów
  • Wszystko z Indie
  • 10 kluczy API
  • Serwer MCP
  • Pro-techniki
  • Wsparcie priorytetowe
Kup Starter
pro
$59/mo
800 000 kredytów
  • Wszystko z Starter
  • Nieograniczone klucze
  • Dedykowany IP
  • SLA
Kup Pro
biznes
$199/mo
3M kredytów
  • Wszystko z Pro
  • White-label
  • Umowa niestandardowa
  • Wsparcie Slack
Porozmawiaj z nami

// potrzebujesz więcej? Enterprise · Pakiet HD $9 dla aplikacji tylko z bodygraph

99.9% SLA · plany płatne · 30d status →
// 06b / add-ons

Pakiety tematyczne. Płacisz tylko za to, co używasz w prod.

Pionowe subskrypcje add-on dla aplikacji o wąskim zakresie — zamiast kupowania pełnego planu. HD Pack opisany jest w oddzielnej sekcji powyżej; pozostałe trzy — poniżej.

// hd-pack
$9/mo

HD Pack

12 endpointów Human Design: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. Ten sam Swiss Ephemeris, co zachodnia astrologia.

Kup HD Pack →
// esoteric-pack
$9/mo

Esoteric Pack

164 endpointów: Tarot, numerologia (5 systemów), runy, I Ching, geomancja, chiromancja, reference. Jeden klucz, $9/mies.

Kup Esoteric Pack →
// vedic-pack
$19/mo

Vedic Pack

169 wedyckich endpointów: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 systemów), KP, Lal Kitab, Jaimini.

Kup Vedic Pack →
// reports-pack
$99/mo

Reports Pack

18 endpointów PDF: natal, synastry, wedycki kundli, HD, tarot i inne. White-label + 21 lokalizacji. 100 PDF/mies.

Kup Reports Pack →
// 07 / zaufanie

Dokładność profesjonalnego oprogramowania astrologicznego na Swiss Ephemeris.

// silnik
Swiss Ephemeris
Ten sam Swiss Ephemeris, co w Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold i Janus — profesjonalne oprogramowanie astrologiczne od 30+ lat.
// walidacja
NASA Katalog zaćmień
818 testów snapshot przeciwko Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog na każdy PR.
// dokładność
< 0.1″
Dryf sub-arcsecond (≤0.1″) w porównaniu do efemeryd NASA JPL i referencji Astrodienst. Faza 1-5 zamknięta.
// zasilanie
100K+ czytelnicy
Codzienne horoskopy na astroway.info oraz 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.