API αστρολογικών υπολογισμών · 714 endpoints · Swiss Ephemeris

v2.77.14 714 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

714 endpoints. <0.1″ ακρίβεια. 99.97% uptime. Ναтальικοί χάρτες, προβλέψεις, синаστρία, Human Design — όλα σε ένα HTTP request.

Δημιουργία κλειδιού API Διάβασε τη τεκμηρίωση 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, без ключа.

Відповідь з'явиться тут

Заповни форму ліворуч і натисни "Побудувати карту"

// 02 / modules

8 βασικά + 8 εξειδικευμένα modules. 714 endpoints Astrology API.

// 01

Ναταλική & Δυτική

Χάρτης, όψεις, οίκοι, διαθέσεις, midpoints, σταθερά αστέρια, ημερολόγιο κύκλων.

// 02

Προγνωστική

Μεταβάσεις, προόδους, solar-arc, προфекції, real-time επιστροφές.

// 03

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

Ταρό

Rider-Waite-Smith, Marseille, Lenormand. Διατάξεις + οδηγοί για οποιοδήποτε deck.

// 06

Αριθμολογία

5 συστήματα (Pythagorean, Chaldean, Kabbalistic ×2, Vedic) + Destiny Matrix.

// 07

Ωριαία & Γεωαστρολογία

Ωριαία, εκλογική, void-of-course Moon + αστροχαρτογραφία, συναστρία, σύνθετες χάρτες.

// 08

AI гороскоп

Ημερήσιες/εβδομαδιαίες + AI ερμηνείες, συνδεδεμένες με πραγματικές εφημερίδες — χωρίς幻觉 LLM.

// 02b / extras

Άλλα 8 εξειδικευμένα modules. Εξειδικευμένα σενάρια και λειτουργίες για developers.

Εκτός από τα 8 βασικά hero-modules, καλύπτουμε περίπου 311 endpoints σε 8 εξειδικευμένες κατηγορίες. Λεπτομέρειες για κάθε endpoint βρίσκονται στη σελίδα /credits/.

// 09

Σχολές Δυτικής

4 ελληνοποιημένες σχολές (Brennan, Greenbaum, Hand, Schmidt) × 10 + σύγχρονη ψυχολογική, εξελικτική, κοσμοβιολογία.

// 10

Μαντική & Οδηγός

Γεωμαντεία (16 σχήματα), Ρούνες Elder Futhark, Χειρομαντεία, I Ching, Sabian Symbols, Κρύσταλλα, Αγγελικοί αριθμοί, Όνειρα, Αναφορικά γλυφικά.

// 11

Κινεζική & Μάγια

BaZi (Τέσσερις Στύλοι), Zi Wei Dou Shu (12 παλάτια), Κινεζικό ζώδιο, Tzolkin / Haab / Long Count.

// 12

Εξειδικευμένα σενάρια

Wellness (ιατρική / διατροφή / γιόγκα), κατοικίδια, επιχειρήσεις / ιδρυτές, οικονομικά, οικογενειακή αστρολογία — με disclaimers.

// 13

PDF αναφορές

12 τύποι PDF ( natal / συναστρία / βεδικός kundli / lal kitab / human-design / tarot…) + 5 AI narratives. Puppeteer + Handlebars, 21 τοπικές.

// 14

Υποδομή για developers

Webhooks (10 γεγονότα), real-time status requests (10), iframe widgets για embed (10), extended MCP (multi-agent / RAG), white-label config PDF.

// 15

Οπτικοποίηση

SVG renders χαρτών, bodygraph, kundli, timeline μεταβάσεων — για embed και frontend.

// 16

Συστημικά

Health, status, OpenAPI 3.1 spec, τεκμηρίωση εντός εφαρμογής.

// 03 / human design

Κάλυψη HD, την οποία δεν υπάρχει πουθενά αλλού.

12 endpoints Human Design API. Όλα σε ένα API.

Το HumanDesign.ai υποστηρίζει bodygraph + 4 βασικά endpoints. Το AstrologyAPI.io υποστηρίζει μόνο profile. Εμείς είμαστε οι μόνοι που έχουμε Penta, Dream Rave, Hologenetic Profile και Incarnation Cross πάνω στο ίδιο Swiss Ephemeris που χρησιμοποιείται και στη δυτική αστρολογία.

// επίσης διαθέσιμο $9 HD-only pack

AstroWay

HumanDesign.ai

RoxyAPI

AstrologyAPI.io

Prokerala

VedicAstroAPI

// 04 / mcp & ai

Ένας AI agent που δεν φαντάζεται τις επιμερίδες.

@astroway/mcp — native MCP server

Σύνδεσε τον 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

Ένας γενικός LLM θα πει «κάπου τον Ιούλιο ο Κρόνος κάνει τριγώνισμα...» — χωρίς ακριβή ημερομηνία. Ο agent μας κάνει tool_use POST /v1/transits και επιστρέφει timestamp UTC έως το δευτερόλεπτο.

// λειτουργεί τοπικά · κλειδιά στο δικό σας config · χωρίς τηλεμετρία από την πλευρά του AstroWay

// λειτουργεί στο mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 714+ tools loaded

user

Πότε είναι η επόμενη μετάβαση του Κρόνου σε τριγώνισμα με τον natal Δία;

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 για το δικό σας stack. TypeScript · Python · PHP.

Δεν θέλετε να καλείτε με το χέρι 714 εντός-σημείων? Τρία επίσημα clients με πλήρες τύπωμα, 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 clients. 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.

Provider	Entry	Credits	Western	HD	MCP	Unique	OpenAPI
AstroWay	$5	50K	✓ 175	✓ 12	✓	✓ 16	3.1
Astrology-API.io	$11	1K	✓ 130	— 1	✓	— 0	3.0
Prokerala	$19	100K	✓ 60	— 0	—	— 0	—
RoxyAPI	$39	5K	✓ 90	✓ 4	✓	— 2	3.0
HumanDesign.ai	$25	1K	—	✓ 4	—	— 0	—
VedicAstroAPI	$30	30K	✓ 50	— 0	—	— 0	—

// οι τιμές των ανταγωνιστών είναι χειροκίνητες εκτιμήσεις από δημόσιες σελίδες τιμών · Μάιος 2026 · ελέγχουμε κάθε τρίμηνο

// 06 / pricing

Πληρώνεις μόνο για τις κλήσεις.

δωρεάν

$0/mo

10.000 credits

Όλα τα 714 endpoints
HD pack πλήρες
1 API key
Χωρίς κάρτα

Ξεκίνα τώρα

indie

$5/mo

50.000 credits

Όλα από Free
3 API keys
Webhooks
Υποστήριξη email

Αγόρασε Indie

starter · δημοφιλές

$19/mo

200.000 credits

Όλα από Indie
10 API keys
MCP server
Τεχνικές Pro
Προτεραιότητα υποστήριξης

Αγόρασε Starter

pro

$59/mo

800.000 credits

Όλα από Starter
Απεριόριστα keys
Δεσμευμένη IP
SLA

Αγόρασε Pro

business

$199/mo

3M credits

Όλα από Pro
White-label
Προσαρμοσμένη σύμβαση
Υποστήριξη Slack

Μίλησε μαζί μας

// χρειάζεσαι περισσότερα; Enterprise · HD Pack $9 για εφαρμογές μόνο με bodygraph

99.9% SLA · επί πληρωμή πλάνα · 30 ημέρες κατάσταση →

// 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, γεωμαντεία, χειρομαντεία, αναφορά. Ένας κωδικός, $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 tests έναντι Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog σε κάθε PR.

// accuracy

< 0.1″

Υπο-arcsecond απόκλιση (≤0.1″) έναντι NASA JPL ephemeris και Astrodienst reference. Φάση 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.

API αστρολογικών υπολογισμών · Swiss Ephemeris · Human Design · AstroWay