v2.19.0 705 endpoints 561 CI tests sub-arcsecond Swiss Ephemeris

705 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({ birthDate: '1991-08-24T16:30:00+03:00', latitude: 50.4501, longitude: 30.5234, houseSystem: 'placidus' }),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={'birthDate': '1991-08-24T16:30:00+03:00', 'latitude': 50.4501,7 'longitude': 30.5234, 'houseSystem': 'placidus'})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 "birthDate": "1991-08-24T16:30:00+03:00",6 "latitude": 50.4501,7 "longitude": 30.5234,8 "houseSystem": "placidus"9}'

● 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}

credits 10

latency <100ms

cache MISS

engine swisseph

 [12:47:03] $ aw chart --birth 1991-08-24T16:30 --place "Kyiv, UA" [12:47:03] → POST api.astroway.info/v1/chart [12:47:03] → X-Api-Key: aw_live_***...uM2x [12:47:03] ✓ 200 OK · <100ms · 10 credits used · sub-arcsecond accuracy [12:47:03] i validated against swetest + NASA Eclipse Catalog (561 CI snapshots) $  

// 02 / modules

8 hero + 8 specialty modules. 705 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

169

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 ~320 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 705 tools and is guaranteed to call the real API instead of inventing dates.

$ npm install -g @astroway/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.

claude · @astroway/mcp · 705+ 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

// 05 / versus

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

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

100% uptime · Calculation API · 30d status →

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

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

Astrology Calculation API · Swiss Ephemeris · Human Design · AstroWay