AstroWay/api v2.19.0 · about
усі системи в нормі
UA EN
// company · est. 2019 · made in ukraine

Інфраструктура,
яка не помиляється.

Астрологія — це стек, який ніхто не любив підтримувати. Астрономи вважали несерйозним, інженери — езотеричним. Так до 2019-го всі публічні API копіювали один одного й накладали 1 кутову секунду помилки на кожен PR. Ми вирішили зробити по-іншому.

// founded
2019
Перший прототип у Києві
// endpoints
705
production · OpenAPI 3.1
// CI tests
561
snapshot vs swetest + NASA Eclipse Catalog
// powering
100K+
readers · daily horoscopes · astroway.info
// 01 / mission

Зробити астрологічні обчислення
надійною інфраструктурою.

Астрологічні обчислення — це наука: ефемериди, прецесія рівнодення, дугові часові поправки. Ми виносимо це в безпомилковий API, щоб розробники будували продукти, а не сперечалися про знаки часу.

До 2019-го кожна команда, яка хотіла побудувати астро-продукт, проходила через одне з трьох пекл: писала свій ефемерис-движок (3-6 місяців втрачено), купувала Solar Fire (відсутність API, ручне копіювання), або підключала якийсь публічний API (1″+ помилки, 60% покриття, ціна $11/тис запитів).

Ми побачили, що ніхто не зробив правильно: повне покриття, sub-arcsecond, прозорий пейволл, нормальний OpenAPI. Тому зробили самі.

// 02 / team

Невелика команда
з України.

Працюємо з 2019 року.

AstroWay побудована маленькою командою інженерів і астрологів-консультантів з України. Ми не стартап з 50 людей і VC-раундом — це продукт, де кожна лінія коду прийшла з реального сценарію використання у нашій LMS-академії та споживчому застосунку.

Якщо хочеш зв'язатися: hello@astroway.info. Якщо потрібен корпоративний контракт: enterprise@astroway.info.

// українська компанія, англійська підтримка, сервери в EU + US
// 03 / principles

У що ми насправді віримо.

/ 01

Спершу математика, потім UX.

Гарна документація і красивий дешборд марні, якщо карта помиляється на 0.3°. Кожен реліз звіряється проти референсного Swiss Ephemeris і каталогу затемнень NASA через 561 регресійних тестів. Одна регресія — реліз блокується.

/ 02

Одна ціна, без пасток.

Жодних «starting at», жодного «enterprise — пиши нам» на стартових тарифах, жодних сюрпризів з перевитратою. Цифра на /pricing — цифра в інвойсі. Заблокована на 12 місяців від моменту реєстрації.

/ 03

Email — і ми відповімо.

Без бота-помічника. api@astroway.info йде напряму інженеру. Ми читаємо кожен лист. Якщо спимо — відповідь буде, коли прокинемось, переважно з фрагментом коду.

/ 04

Нудний стек, добре налаштований.

Серверний стек обраний за передбачуваність, не за хайп. Хостинг у ЄС. Зекономлений на хайпі час іде в навантажувальне тестування, спостережуваність і ергономіку SDK. API швидкий, бо код малий.

/ 05

Чесно про те, чого бракує.

Публічний /changelog. Чесна документація — що гарантує кожен ендпоінт і де живуть граничні випадки. Ми не вдаємо, що ректифікація відпрацьовує будь-який час народження — у документації явно вказана точність.

/ 06

Астрологія — ремесло, не настрій.

Будуємо разом з практикуючим астрологом (LMS-академія на astroway.info з 2019-го). Кожна інтерпретація походить з конкретної традиції, яку ми можемо назвати. Ми не генеруємо текст LLM-ом і не називаємо це астрологією.

// 04 / timeline

Сім років.
705 ендпоінтів.

2019 · Q3

Перший прототип

Внутрішній сервіс для astroway.info — щоденного гороскопу. 8 ендпоінтів, Moshier ефемериди.

2021 · Q1

Перехід на Swiss Ephemeris

Snapshot-тести виявили 0.4″ дрифт на Pluto. Чотири тижні рефакторингу — переписали ефемерис-pipeline на Swiss Ephemeris.

2022 · Q2

Public beta — v1.0

23 ендпоінти, OpenAPI 3.0, перші 50 alpha-користувачів з astroway.info.

2023 · Q4

Human Design модуль

12 ендпоінтів — bodygraph, profile, penta, dream-rave, hologenetic, incarnation cross. Перевірено проти Ra Uru Hu reference calculations.

2025 · Q1

MCP сервер

Перший астро-API з нативною підтримкою Model Context Protocol. Інтеграції з Claude, Cursor, Windsurf.

2026 · Q1

705 ендпоінтів · 561 CI тести

100% uptime 30 днів поспіль. Запуск Hologenetic Profile, Penta для груп до 5 людей. Vedic Dashas, KP, Lal Kitab, Jaimini — повне multi-tradition покриття.

2026 · Q3 → у дорожній карті

AI-гороскоп з прив'язкою до ефемерид

Щоденні/щотижневі прогнози на LLM з обов'язковим викликом інструменту до /v1/transits. Без галюцинацій.

// 05 / stack

Як воно влаштоване.

// math engine

Обчислювальне ядро

  • Swiss Ephemerisreference engine
  • NASA Eclipse Catalogзовнішня істина
  • 561 regression-тестівкожен реліз
  • Sub-arcsecond точністьпозиції планет
  • Строга type-safety end-to-endбез runtime-сюрпризів
// api surface

Публічна поверхня

  • REST + JSONодин консистентний контракт
  • OpenAPI 3.1auto-generated spec
  • Idempotency-Keyкожен POST
  • Per-key rate-limitsчесний шерінг
  • x-request-id90-day replay window
// security & privacy

Позиція

  • EU jurisdictiondata residency
  • HTTPS / TLS 1.3 onlyбез plaintext
  • Hashed credentialsбез plaintext at rest
  • IP-hash loggingGDPR-compliant
  • DPA доступнана Pro+ тарифах
// reliability

Коли щось ламається

  • Health-проби / хвилинабезперервно
  • Sub-minute rollbackкожен деплой
  • Щоденні бекапи30-day retention
  • Публічна incident-стрічкана /status
  • Postmortem ≤ 5 днівsev-1 інциденти
// SDKs & tooling

Як з ним говорити

  • @astroway/mcpMCP сервер · npm · зрелізено
  • @astroway/apiTypeScript SDK · roadmap (OpenAPI 3.1 codegen)
  • astroway pyPython SDK · roadmap (OpenAPI 3.1 codegen)
  • Postman collectionone-click import
  • cURL прикладиу кожному doc
// frontend stack

Сайт і dashboard

  • Astro · Starlightсайт · docs
  • React · Vitedashboard
  • Tailwind 4стилі
  • Manrope · JetBrains Monoшрифти
  • Rechartsграфіки usage
// 06 / ecosystem

Три домени.
Один движок.

100% uptime · Calculation API · 30d status →

Зробіть перший запит
за 5 хвилин.

10 000 кредитів безкоштовно. Без картки. Без часового обмеження.