Astrology API · 723 endpoints · Swiss Ephemeris

v2.96.0 723 endpoints 818 CI tests sub-arcsecond Swiss Ephemeris

723 endpoints. <0.1″ accuracy. 99.97% uptime. Natal charts, predictions, synastry, Human Design — in one HTTP request.

Generate API key Read docs 10,000 credits free · no card required

// 01 / playground · astrology api

Make a request. Right here.

● 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

Try it now — no signup

Live request to /v1/public/chart. 30 requests/hour from your IP, no key.

Response will appear here

Fill the form on the left and click "Build chart"

// 02 / modules

8 hero + 8 specialty modules. 723 Astrology API endpoints.

// 01

Natal & Western

Chart, aspects, houses, dispositors, midpoints, fixed stars, calendar cycles.

// 02

Predictive

Transits, progressions, solar-arc, profections, returns in real time.

// 03

Human Design

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

// 04

170

Vedic

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

// 05

Tarot

Rider-Waite-Smith, Marseille, Lenormand. Spreads + lookups for any deck.

// 06

Numerology

5 systems (Pythagorean, Chaldean, Kabbalistic ×2, Vedic) + Destiny Matrix.

// 07

Horary & Geography

Horary, electional, void-of-course Moon + astrocartography, synastry, composites.

// 08

AI horoscope

Daily/weekly + AI interpretations grounded on real ephemerides — no LLM hallucinations.

// 02b / extras

8 more specialty modules. Niche use cases & developer features.

Beyond the 8 hero modules, we cover 314 more endpoints across 8 specialty categories. Per-endpoint detail at /credits/.

// 09

Western schools

4 Hellenistic schools (Brennan, Greenbaum, Hand, Schmidt) × 10 + modern psychological, evolutionary, cosmobiology.

// 10

Divination & reference

Geomancy (16 figures), Elder Futhark runes, Palmistry, I Ching, Sabian Symbols, Crystals, Angel Numbers, Dreams, reference glyphs.

// 11

Chinese & Mayan

BaZi (Four Pillars), Zi Wei Dou Shu (12 palaces), Chinese Zodiac, Tzolkin / Haab / Long Count.

// 12

Niche use cases

Wellness (medical / diet / yoga), Pet, Business / Founder, Financial, Family astrology — with disclaimers.

// 13

PDF reports

12 PDF types (natal / synastry / vedic kundli / lal kitab / human-design / tarot…) + 5 AI narratives. Puppeteer + Handlebars, 21 locales.

// 14

Developer infra

Webhooks (10 events), Live-state queries (10), iframe Embed widgets (10), MCP advanced (multi-agent / RAG), white-label PDF config.

// 15

Visualization

SVG renders for charts, bodygraph, kundli, transit timeline — for embed and front-end.

// 16

System

Health, status, OpenAPI 3.1 spec, in-app docs.

// 03 / human design

HD coverage you won't find anywhere else.

12 Human Design API endpoints. All on one API.

HumanDesign.ai gives bodygraph + 4 base endpoints. AstrologyAPI.io — only profile. We're the only ones with Penta, Dream Rave, Hologenetic Profile, and Incarnation Cross on the same Swiss Ephemeris as Western astrology.

// also available as $9 HD-only pack

AstroWay

HumanDesign.ai

RoxyAPI

AstrologyAPI.io

Prokerala

VedicAstroAPI

// 04 / mcp & ai

AI agent that doesn't fabricate ephemerides.

@astroway/mcp — native MCP server

Connect to Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI), or any MCP-compatible client in one command. Sits on top of GPT-4, Claude, Llama 3.3, DeepSeek, Gemini — AI gets access to 723 tools and is guaranteed to call the real API instead of inventing dates.

$ npm install -g @astroway/mcp

https://mcp.astroway.info/mcp

Generic LLM will say "sometime in July, Saturn trines..." without an exact date. Our agent performs tool_use POST /v1/transits and returns a UTC-timestamp to the second.

// runs locally · keys in your own config · no AstroWay-side telemetry per call

// runs on mcp.astroway.info · Streamable HTTP · Bearer auth · multi-tenant

claude · @astroway/mcp · 723+ tools loaded

user

When is the next Saturn-trine-natal-Jupiter transit?

claude

Computing ephemerides…

POST /v1/transits ✓

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

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

gpt-4 (no MCP)

hallucinated"Around July 2026 Saturn will form a trine…"

no tool call · ±15 day drift · text hallucination

// 04b / sdks

Official SDKs for your stack. TypeScript · Python · PHP.

Don't want to wire 723 endpoints by hand? Three official clients with full typing, retries on 429/5xx, idempotency, and matching error hierarchy. One pattern across all three.

// @astroway/sdk

TypeScript / Node

`openapi-fetch` wrapper, ~6 KB runtime. Path autocomplete + request/response types for every endpoint. ESM + CJS, Node 18+, Cloudflare Workers / Deno / Bun.

$ npm install @astroway/sdk

import { Astroway } from '@astroway/sdk'; Open on registry →

// astroway

Python

Sync + async clients. PEP 561 stubs, Pydantic v2 models, httpx transport, automatic retry. Python 3.10+. PyPI Trusted Publisher.

$ pip install astroway

from astroway import Astroway Open on 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; Open on registry →

// other languages? See all SDKs

// 05 / versus

Depth like Solar Fire. Price like a side-project.

Provider	Entry	Credits	Western	HD	MCP	Unique	OpenAPI
AstroWay	$5	50K	✓ 176	✓ 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	—

// competitor numbers — manual estimates from public pricing pages · May 2026 · re-verified quarterly

// 06 / pricing

Pay only for calls.

free

$0/mo

10,000 credits

All 723 endpoints
Full HD
1 API key
No card

Get started

indie

$5/mo

50,000 credits

Everything in Free
3 API keys
Webhooks
Email support

Buy Indie

starter · popular

$19/mo

200,000 credits

Everything in Indie
10 API keys
MCP server
Pro techniques
Priority support

Buy Starter

pro

$59/mo

800,000 credits

Everything in Starter
Unlimited keys
Dedicated IP
SLA

Buy Pro

business

$199/mo

3M credits

Everything in Pro
White-label
Custom contract
Slack support

Talk to us

// need more? Enterprise · HD Pack $9 for bodygraph-only apps

99.9% SLA · paid plans · 30d status →

// 06b / add-ons

Thematic packs. Pay for what you ship.

Horizontal add-on subscriptions for apps with a narrow focus — instead of buying a full tier. HD Pack is described in its own section above; the other three sit below.

// hd-pack

$9/mo

HD Pack

12 Human Design endpoints: bodygraph, Penta, Dream Rave, Hologenetic Profile, Incarnation Cross. Same Swiss Ephemeris stack as the Western side.

Buy HD Pack →

// esoteric-pack

$9/mo

Esoteric Pack

164 endpoints: Tarot, numerology (5 systems), runes, I Ching, geomancy, palmistry, reference. One key, $9/mo.

Buy Esoteric Pack →

// vedic-pack

$19/mo

Vedic Pack

170 Vedic endpoints: vargas D1-D60, panchang, shadbala, yogas, doshas, dashas (8 systems), KP, Lal Kitab, Jaimini.

Buy Vedic Pack →

// reports-pack

$99/mo

Reports Pack

21 PDF endpoints: natal, synastry, vedic kundli, HD, tarot and more. White-label + 21 locales. 100 PDF/mo.

Buy Reports Pack →

// 07 / trust

The accuracy of professional astro software on Swiss Ephemeris.

// engine

Swiss Ephemeris

Same Swiss Ephemeris as Solar Fire, Astrodienst (Astro.com), Kepler, Astro Gold and Janus — the professional astrology software trusted for 30+ years.

// validation

NASA Eclipse Catalog

818 snapshot tests against Astrodienst swetest CGI + NASA 5-Millennium Eclipse Catalog on every PR.

// accuracy

< 0.1″

Sub-arcsecond drift (≤0.1″) vs NASA JPL ephemeris and Astrodienst reference. Phases 1-5 closed.

// powering

100K+ readers

Daily horoscopes on astroway.info and 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 723 endpoints, all from one API key.

How many endpoints does AstroWay have?

723 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.

Astrology API — 723 Endpoints on Swiss Ephemeris