Overview
AstroWay API is a professional backend for astrology calculations as a service.
865 endpoints at arc-second precision, covering techniques no competitor offers: harmonics, draconic charts, CCG, Gauquelin sectors, full Human Design, rectification.
Who it’s for
Section titled “Who it’s for”- Astrology app developers (web, mobile) who need precise and diverse calculations without maintaining their own computational infrastructure.
- AI companies embedding astrology features: native MCP server for Claude, ChatGPT and other agents.
- Professional astrologers building custom tools or client scripts.
- Researchers who need programmatic access to calculations for statistical studies.
- Content platforms adding astrology features on top of an existing product.
Who it’s not for
Section titled “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. - Street-level geocoding: location search turns a city or town name into coordinates and a time zone, but not an address. A chart takes latitude and longitude, and a
0,0pair is refused rather than quietly charted for the Gulf of Guinea. - A finished product: this is an API and fourteen embeddable widgets, not a chart editor, not an account area for your clients and not billing on your behalf.
- Free unlimited use: 10,000 credits a month covers a prototype and a small site, and past that it is a paid service.
What makes AstroWay unique
Section titled “What makes AstroWay unique”1. Rare techniques in API form
Section titled “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. Arc-second precision, verified against NASA JPL Horizons
Section titled “2. Arc-second precision, verified against NASA JPL Horizons”Every calculation runs on our own servers, with no upstream API, and is served as a REST API with no middleman markup. Precision:
- Planet positions: ±1 arcsecond vs NASA JPL ephemeris
- House cusps: ±1 arcminute
- Measured against Astrodienst swetest CGI (Astro.com): median 0.0013″, maximum 0.561″ (Chiron), see accuracy.
3. 865 endpoints: deep coverage of Western techniques
Section titled “3. endpoints: deep coverage of Western techniques”186 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
Section titled “Architecture”Your application ↓ HTTPS + X-Api-Keyapi.astroway.info/v1/* ↓AstroWay API ↓Calculation and JSON response- Calculations happen server-side: nothing to build or ship in your frontend.
- 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.
- Quick start: first request in 5 minutes
- Authentication: how to get and store a key
- Credits & Rate Limits: how billing works
- API documentation: all endpoints with interactive playground