AstroWay/api v2.19.0 · about
all systems operational
UA EN
// company · est. 2019 · made in ukraine

Infrastructure
that doesn't lie.

Astrology — a stack nobody loved to maintain. Astronomers thought it was unserious, engineers thought it was esoteric. Until 2019, every public API was copying one another and stacking 1 arc-second of error on every PR. We decided to do it differently.

// founded
2019
First prototype in Kyiv
// endpoints
705
production · OpenAPI 3.1
// CI tests
561
snapshot vs swetest + NASA Eclipse Catalog
// powering
100K+
readers · daily horoscopes · astroway.info
// 01 / mission

Make astrology calculations
reliable infrastructure.

Astrology calculations are science: ephemerides, precession of equinoxes, arc-time corrections. We move that into a flawless API so developers build products instead of arguing about timestamps.

Before 2019, every team that wanted to build an astro product went through one of three hells: writing their own ephemeris engine (3-6 months lost), buying Solar Fire (no API, manual copy-paste), or plugging in some public API (1″+ errors, 60% coverage, $11/thousand requests).

We saw that no one had done it right: full coverage, sub-arcsecond, transparent paywall, a proper OpenAPI. So we did it ourselves.

// 02 / team

Small team
from Ukraine.

Working since 2019.

AstroWay is built by a small team of engineers and astrologer-consultants from Ukraine. We're not a 50-person startup with VC funding — this is a product where every line of code came from a real use case in our LMS academy and consumer app.

If you want to reach us: hello@astroway.info. For an enterprise contract: enterprise@astroway.info.

// Ukrainian company, English support, servers in EU + US
// 03 / principles

What we actually believe.

/ 01

Math first, then UX.

Pretty docs and a slick dashboard are useless if a chart is off by 0.3°. Every release is diffed against the canonical Swiss Ephemeris reference and the NASA Eclipse Catalog with 561 regression tests. One regression — release blocked.

/ 02

One price, no traps.

No "starting at" prices. No "enterprise — email us" wall on entry tiers. No overage that wakes you up at night. The number on /pricing is the number on the invoice — locked for 12 months from signup.

/ 03

Email us. We answer.

No support bot. api@astroway.info reaches a real engineer. We read every message. If we're asleep — answer comes when we wake, usually with a code snippet.

/ 04

Boring tech, well-tuned.

Server-side stack chosen for predictability, not buzz. EU-hosted. The time saved on hype goes into load testing, observability, and SDK ergonomics. The API is fast because the code is small.

/ 05

Open about what is missing.

Public /changelog. Honest documentation of what every endpoint guarantees and where the edge cases live. We don't pretend rectification handles every birth time — the docs are explicit about precision.

/ 06

Astrology is a craft, not a vibe.

Built with a practicing astrologer (LMS-academy at astroway.info since 2019). Every interpretation traces to a tradition we can name. We don't generate text with an LLM and call it astrology.

// 04 / timeline

Seven years.
705 endpoints.

2019 · Q3

First prototype

Internal service for astroway.info — daily horoscope. 8 endpoints, Moshier ephemerides.

2021 · Q1

Switch to Swiss Ephemeris

Snapshot tests revealed 0.4″ drift on Pluto. Four-week refactor — rewrote ephemeris pipeline on Swiss Ephemeris.

2022 · Q2

Public beta — v1.0

23 endpoints, OpenAPI 3.0, first 50 alpha users from astroway.info.

2023 · Q4

Human Design module

12 endpoints — bodygraph, profile, penta, dream-rave, hologenetic, incarnation cross. Verified against Ra Uru Hu reference calculations.

2025 · Q1

MCP server

First astro API with native Model Context Protocol support. Integrations with Claude, Cursor, Windsurf.

2026 · Q1

705 endpoints · 561 CI tests

100% uptime 30 days in a row. Launched Hologenetic Profile, Penta for groups up to 5 people. Vedic Dashas, KP, Lal Kitab, Jaimini — full multi-tradition coverage.

2026 · Q3 → roadmap

AI horoscope with grounded ephemerides

Daily/weekly forecasts on LLM with mandatory tool-call to /v1/transits. No hallucinations.

// 05 / stack

How it is built.

// math engine

Calculation core

  • Swiss Ephemerisreference engine
  • NASA Eclipse Catalogexternal truth
  • 561 regression testsevery release
  • Sub-arcsecond accuracyplanet positions
  • Strict type-safety end-to-endno runtime surprises
// api surface

Public surface

  • REST + JSONone consistent contract
  • OpenAPI 3.1auto-generated spec
  • Idempotency-Keyevery POST
  • Per-key rate limitsfair sharing
  • x-request-id90-day replay window
// security & privacy

Posture

  • EU jurisdictiondata residency
  • HTTPS / TLS 1.3 onlyno plaintext
  • Hashed credentialsno plaintext at rest
  • IP-hash loggingGDPR-compliant
  • DPA availableon Pro+ tiers
// reliability

When it goes wrong

  • Health probes / minutecontinuous
  • Sub-minute rollbackevery deploy
  • Daily backups30-day retention
  • Public incident timelineon /status
  • Postmortem ≤ 5 dayssev-1 incidents
// SDKs & tooling

How you talk to it

  • @astroway/mcpMCP server · npm · shipped
  • @astroway/apiTypeScript SDK · roadmap (OpenAPI 3.1 codegen)
  • astroway pyPython SDK · roadmap (OpenAPI 3.1 codegen)
  • Postman collectionone-click import
  • cURL examplesin every doc
// frontend stack

Site & dashboard

  • Astro · Starlightsite · docs
  • React · Vitedashboard
  • Tailwind 4styles
  • Manrope · JetBrains Monotype
  • Rechartsusage graphs
// 06 / ecosystem

Three domains.
One engine.

100% uptime · Calculation API · 30d status →

Make your first request
in 5 minutes.

10,000 credits free. No card. No time limit.