API per calcoli astrologici · 714 endpoint · Swiss Ephemeris

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

714 endpoint. <0.1″ precisione. 99.97% uptime. Carte natali, previsioni, sinastria, Human Design — con una singola richiesta HTTP.

Genera chiave API Leggi la docs 10.000 crediti gratis · senza carta

// 01 / playground · astrology api

Fai una richiesta. Direttamente qui.

● 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 / moduli

8 moduli principali + 8 specializzati. 714 endpoint dell'Astrology API.

// 01

Natale & occidentale

Carta, aspetti, case, disposizioni, midpoints, stelle fisse, calendario dei cicli.

// 02

Prognostica

Transiti, progressioni, solar-arc, profezioni, rivoluzioni in tempo reale.

// 03

Human Design

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

// 04

169

Vedica

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

// 05

Tarocco

Rider-Waite-Smith, Marseille, Lenormand. Layout + manuali per qualsiasi mazzo.

// 06

Numerologia

5 sistemi (Pitagorica, Caldea, Cabalistica ×2, Vedica) + Matrice del Destino.

// 07

Ora & geoastrologia

Ora, elettiva, Luna void-of-course + astrocartografia, sinastria, carte composite.

// 08

Oroscopo AI

Previsioni giornaliere/settimanali + interpretazioni AI basate su effemeridi reali — senza allucinazioni LLM.

// 02b / extra

Altri 8 moduli specializzati. Scenari e funzioni specializzati per sviluppatori.

Oltre ai 8 moduli hero principali, copriamo altri 311 endpoint in 8 categorie specializzate. Dettagli su ogni endpoint — nella pagina /credits/.

// 09

Scuole occidentali

4 scuole ellenistiche (Brennan, Greenbaum, Hand, Schmidt) × 10 + psicologica moderna, evolutiva, cosmobiologia.

// 10

Divinazione & manuali

Geomanzia (16 figure), Rune dell'Elder Futhark, Chiromanzia, I Ching, Simboli Sabiani, Cristalli, Numeri Angelici, Sogni, Glifi di riferimento.

// 11

Cinese & maya

BaZi (Quattro Pilastri), Zi Wei Dou Shu (12 palazzi), Zodiaco cinese, Tzolkin / Haab / Long Count.

// 12

Scenari di nicchia

Benessere (medico/dieta/yoga), Animali, Business/Fondatore, Finanziario, Astrologia familiare — con disclaimer.

// 13

Report PDF

12 tipi di PDF (natale/sinastria/kundli vedica/lal kitab/human-design/tarocco…) + 5 narrazioni AI. Puppeteer + Handlebars, 21 localizzazioni.

// 14

Infrastruttura per sviluppatori

Webhook (10 eventi), richieste di stato in tempo reale (10), widget iframe per embed (10), MCP avanzato (multi-agent/RAG), configurazione white-label PDF.

// 15

Visualizzazione

Render SVG di carte, bodygraph, kundli, timeline dei transiti — per embed e frontend.

// 16

Sistemici

Health, stato, specifica OpenAPI 3.1, documentazione nell'app.

// 03 / human design

Copertura HD che non esiste altrove.

12 endpoint Human Design API. Tutti su un'unica API.

HumanDesign.ai gestisce bodygraph + 4 endpoint di base. AstrologyAPI.io offre solo il profile. Noi siamo gli unici a fornire Penta, Dream Rave, Hologenetic Profile e Incarnation Cross sullo stesso Swiss Ephemeris usato dall'astrologia occidentale.

// disponibile anche $9 pacchetto HD-only

AstroWay

HumanDesign.ai

RoxyAPI

AstrologyAPI.io

Prokerala

VedicAstroAPI

// 04 / mcp & ai

Agente AI che non inventa le effemeridi.

@astroway/mcp — server MCP nativo

Collegati a Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) o qualsiasi client MCP con un solo comando. Funziona su GPT-4, Claude, Llama 3.3, DeepSeek, Gemini — l'AI ottiene accesso a 714 strumenti e chiama in modo garantito l'API reale invece di inventare date.

$ npm install -g @astroway/mcp

https://mcp.astroway.info/mcp

Un LLM generico dirà «da qualche parte a luglio Saturno trigona...» — senza data precisa. Il nostro agente esegue tool_use POST /v1/transits e restituisce un timestamp UTC al secondo.

// funziona localmente · chiavi nel proprio config · senza telemetria da parte di AstroWay

// funziona su mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 714+ tools loaded

user

Quando sarà il prossimo transito di Saturno in trigono al Giove natale?

claude

Calcolo delle effemeridi in corso…

POST /v1/transits ✓

→ saturn_to_natal_jupiter · trine · exact: 2026-07-12T14:23:08Z

grounded · 4 credits · <100ms · sub-arcsecond

gpt-4 (senza mcp)

hallucinated«Verso luglio 2026 Saturno formerà un trigono...»

nessuna chiamata tool · ±15 giorni di drift · allucinazione testuale

// 04b / sdks

SDK ufficiali per il tuo stack. TypeScript · Python · PHP.

Non vuoi chiamare manualmente 714 endpoint? Tre client ufficiali con tipizzazione completa, retry su 429/5xx, idempotenza e una sola gerarchia di errori. Un solo pattern in tutti e tre.

// @astroway/sdk

TypeScript / Node

Wrapper su `openapi-fetch`, ~6 KB runtime. Path autocomplete + tipi di richiesta/risposta per ogni endpoint. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk

import { Astroway } from '@astroway/sdk'; Apri su registry →

// astroway

Python

Client sincroni + asincroni. PEP 561 stubs, modelli Pydantic v2, trasporto httpx, retry automatico. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway

from astroway import Astroway Apri su registry →

// astroway/sdk

PHP

Client HTTP PSR-18, logger PSR-3, factory PSR-17. Friendly con Symfony / Laravel. PHP 8.1+. Packagist autoload.

$ composer require astroway/sdk

use Astroway\Astroway; Apri su registry →

// servono altre lingue? Tutti gli SDK

// 05 / versus

Profondità come Solar Fire. Prezzo come un 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	—

// cifre dei competitor — stime manuali da pagine pubbliche dei prezzi · maggio 2026 · verificate ogni trimestre

// 06 / prezzi

Paga solo per le chiamate.

gratis

$0/mo

10.000 crediti

Tutti 714 endpoint
Pacchetto HD completo
1 API key
Nessuna carta richiesta

Inizia ora

indie

$5/mo

50.000 crediti

Tutto incluso in Free
3 API keys
Webhook
Supporto email

Acquista Indie

starter · più popolare

$19/mo

200.000 crediti

Tutto incluso in Indie
10 API keys
Server MCP
Tecniche Pro
Supporto prioritario

Acquista Starter

pro

$59/mo

800.000 crediti

Tutto incluso in Starter
Chiavi illimitate
IP dedicato
SLA

Acquista Pro

business

$199/mo

3M di crediti

Tutto incluso in Pro
White-label
Contratto personalizzato
Supporto Slack

Contattaci

// ti serve di più? Enterprise · Pacchetto HD $9 per app con solo bodygraph

99.9% SLA · piani a pagamento · 30d stato →

// 06b / add-ons

Pacchetti tematici. Paga solo per quello che utilizzi in prod.

Abbonamenti add-on orizzontali per applicazioni con un focus ristretto — invece di acquistare un piano completo. HD Pack descritto in una sezione separata sopra; gli altri tre — sotto.

// hd-pack

$9/mo

HD Pack

12 endpoint Human Design: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. Lo stesso Swiss Ephemeris della astrologia occidentale.

Acquista HD Pack →

// esoteric-pack

$9/mo

Esoteric Pack

164 endpoint: Tarot, numerologia (5 sistemi), rune, I Ching, geomanzia, chiromanzia, reference. Una chiave, $9/mese.

Acquista Esoteric Pack →

// vedic-pack

$19/mo

Vedic Pack

169 endpoint vedici: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 sistemi), KP, Lal Kitab, Jaimini.

Acquista Vedic Pack →

// reports-pack

$99/mo

Reports Pack

18 endpoint PDF: natal, sinastria, vedic kundli, HD, tarot e altri. White-label + 21 localizzazioni. 100 PDF/mese.

Acquista Reports Pack →

// 07 / affidabilità

Precisione del software astrologico professionale su Swiss Ephemeris.

// motore

Swiss Ephemeris

Lo stesso Swiss Ephemeris usato da Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold e Janus — software astrologico professionale da oltre 30 anni.

// validazione

NASA Catalogo delle Eclissi

818 test snapshot contro Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog per ogni PR.

// accuratezza

< 0.1″

Drift sub-arcosecondo (≤0.1″) vs NASA JPL ephemeris e reference di Astrodienst. Fasi 1-5 completate.

// alimenta

100K+ i lettori

Oroscopi quotidiani su astroway.info e 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 per calcoli astrologici · Swiss Ephemeris · Human Design · AstroWay