# Overview

**AstroWay API** is a professional backend for astrology calculations as a service.

<GetApiKeyBlock variant="compact" /> {siteMeta.endpoints} endpoints powered by Swiss Ephemeris (WASM), covering techniques no competitor offers: harmonics, draconic charts, CCG, Gauquelin sectors, full Human Design, rectification.

## Who it's for

1. **Astrology app developers** (web, mobile) who need precise and diverse calculations without maintaining their own computational infrastructure.
2. **AI companies** embedding astrology features — native MCP server for Claude, ChatGPT and other agents.
3. **Professional astrologers** building custom tools or client scripts.
4. **Researchers** who need programmatic access to calculations for statistical studies.
5. **Content platforms** adding astrology features on top of an existing product.

## Who it's **not** for

- Widget horoscopes ("Cancer today") without backend control — AI interpretations and horoscopes exist (`/interpret/*`, `/horoscope/*`), but they're designed as APIs for developers, not drop-in widgets.
- Vedic astrology as main specialty — for Vedic-first projects (Dasha systems, Panchang, KP) Prokerala and VedicAstroAPI are stronger. For Western astrology + Human Design + rare techniques (rectification, harmonics, CCG), AstroWay beats them. See /en/compare/.
- Tarot / numerology — only astrology and Human Design. I-Ching is a bonus endpoint.

## What makes AstroWay unique

### 1. Rare techniques in API form

| Technique | Why it matters |
|---|---|
| **Harmonic charts** (H2–H180) | Research astrology (John Addey method) |
| **Draconic chart** | Karmic / soul astrology |
| **CCG (Cyclo-Carto-Graphy)** | Progressed astrocartography — Jim Lewis premium technique |
| **Gauquelin sectors** | Statistical astrology, academic use |
| **Tertiary progressions** | Third type of progressions — niche but valued |
| **Antiscia / contra-antiscia** | Classical Hellenistic technique — traditional revival |
| **Parallel aspects** | Declination-based aspects — advanced practices |
| **Rectification via API** | Birth time correction — extremely high value |
| **Planetary cycles** (conjunctions) | Mundane astrology — world events |
| **Barbault cyclic index** | Mundane astrology |
| **Algol minimum** | Fixed star times — electional astrology |
| **Local space lines** | Feng shui-like directional astrology |
| **Disposition chains** | Rulership graphs — classical technique |
| **Almuten figuris** | Medieval technique — traditional revival |

### 2. Swiss Ephemeris precision — same engine as Solar Fire ($495), Kepler ($995), Astro Gold

The same Swiss Ephemeris (LGPL) that has powered professional astrologers in Solar Fire, Kepler, Astro Gold and Janus for 30+ years — only as a WASM build and a REST API, with no middleman markup. Precision:

- Planet positions: ±1 arcsecond vs NASA JPL ephemeris
- House cusps: ±1 arcminute
- Validated against Zet 9, Solar Fire (proprietary ephemeris), Astrodienst swetest CGI (Astro.com), Kepler, Astro Gold — discrepancies within method tolerance (≤0.1″).

### 3. {siteMeta.endpoints} endpoints — deep coverage of Western techniques

{siteMeta.westernCount} compute endpoints for Western astrology (4 Hellenistic schools, modern psychological, evolutionary, cosmobiology) + AI interpretations + full Human Design. Depth instead of spreading thin across dozens of directions.

## Architecture

```
Your application
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
Node.js + Express + Swiss Ephemeris (WASM)
     ↓
Calculation and JSON response
```

- Calculations happen **server-side** — no WASM blobs on your frontend, no Swiss Ephemeris licensing concerns for you.
- No server-side state — each request is self-contained. No client data leakage.
- API keys are bound to plan, rate limit, and daily credit balance. Monitoring via dashboard.

## Next

- [Quick start](/en/getting-started/) — first request in 5 minutes
- [Authentication](/en/authentication/) — how to get and store a key
- [Credits & Rate Limits](/en/rate-limits-credits/) — how billing works
- [API documentation](/docs/api/) — all endpoints with interactive playground