AstroWay/api v2.325.2 · about
all systems operational
// company · made in ukraine

Infrastructure
that doesn't lie.

An astrology calculation is easy to get roughly right and hard to get exactly right. So every release is checked against Astrodienst's swetest and the NASA eclipse catalogue, and we publish the difference.

// endpoints
865
production · OpenAPI 3.1
// CI tests
888
snapshot vs swetest + NASA Eclipse Catalog
// MCP tools
843
hosted · mcp.astroway.info
// SDKs
3
TypeScript · Python · PHP
// 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.

A team that wanted to build an astro product had three ways to go: write its own ephemeris engine, buy desktop software with no API, or plug in a public API and accept its accuracy and coverage as they came.

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.

Engineers and astrologers.

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 the EU
// 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 NASA JPL Horizons, the swetest reference output and the NASA Eclipse Catalog with 888 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). Every interpretation traces to a tradition we can name. Where a language model writes the text, it writes on top of positions already calculated and does not invent them.

// 04 / timeline

From 13 endpoints
865 endpoints.

2026-03-01

Calculation core

Planets, houses, aspects and charts. The same core calculates in the app.astroway.info app and in this API.

2026-03-19

Public API

13 endpoints, API keys and the first documentation.

2026-04-11

A product of its own

The API moved to api.astroway.info: its own site, documentation and developer dashboard.

2026-05-06

MCP server

@astroway/mcp on npm: the calculations reachable by agents in Claude, Cursor and other MCP clients.

2026-05-09

Three SDKs

TypeScript, Python and PHP on the same day, generated from the same OpenAPI spec.

now

865 endpoints · 888 CI tests

Every release runs the regression tests against swetest and the NASA eclipse catalogue. One regression and the release does not go out.

// 05 / stack

How it is built.

// math engine

Calculation core

  • NASA JPL Horizonsexternal truth
  • NASA Eclipse Catalogexternal truth
  • 888 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-idin logs for 30 days
// security & privacy

Posture

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

When it goes wrong

  • Health checkdaily
  • Rollback on failed healthevery 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/sdkTypeScript SDK · npm
  • astrowayPython SDK · PyPI
  • astroway/sdkPHP SDK · Packagist
  • Postman collectionone-click import
  • cURL examplesin every doc
// 06 / ecosystem

Three domains.
One engine.

99.9% SLA · paid plans · 30d status →

Make your first request
in 5 minutes.

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