Lancering van AstroWay API: complete stack astrologische berekeningen met precisie van Swiss Ephemeris

Vandaag kondigen we AstroWay API aan - een rekenbackend voor ontwikkelaars die astrologische apps, horoscoopproducten, compatibiliteitsfuncties voor dating en AI-agenten bouwen die moeten nadenken over geboortehoroscopen.

In dit artikel - wat er echt in de API zit, welke onconventionele keuzes we hebben gemaakt, wat we bewust tussen haakjes hebben gelaten en hoe we hier gekomen zijn. Zonder poespas.

🕓 Record van 2026-04-22, bijgewerkt 2026-05-09. Sommige cijfers zijn verouderd. Huidige status: 865 endpoints (en niet 87 op het moment van lancering), 888 CI snapshot-tests (en niet 183), MCP-server @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk leven nu allemaal op public registries. De nieuwste status vind je op /faq en changelog.

REST API gebaseerd op Swiss Ephemeris - nu ook met AI-interpretaties bovenop de echte berekeningen. Dezelfde motor die professionele astrologen al meer dan 30 jaar gebruiken in Solar Fire, Kepler, Astro Gold en Janus - nauwkeurigheid tot op een fractie van een boogseconde, geverifieerd met de NASA JPL-ephemeris en de officiële swetest-referentie van Astrodienst (Astro.com).

Cijfers:

• 865 endpoint: westerse natal astrologie, synastrie, transits, progressies, direc­ties, terugkeer, harmonics, vaste sterren, Arabische punten, astro‑cartografie plus de volledige Human Design set
• 183 snapshot-tests in CI tegen de echte output van swetest CGI en de NASA eclipscatalogus - worden uitgevoerd bij elke PR
• p50 < 100 ms, p95 < 500 ms voor typische reken‑endpoints
• MCP-server @astroway/mcp + drie SDK’s op public registries: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - dezelfde API in drie talen
• MCP-server: @astroway/mcp - levert de API als tools voor Claude, GPT, Cursor en andere LLM‑agents
• Credit‑based tarieven: gratis plan (10 000 credits / maand, zonder kaart), betaald - vanaf $5 / maand

Volledige documentatie: api.astroway.info/docs/api/. Live status: api.astroway.info/status.

Drie jaar geleden begonnen we met het bouwen van consumentgerichte astrologische apps. De rekenlaag bleek het moeilijkste deel te zijn - veel complexer dan UI of content. Bestaande diensten waren of:

1. Hadden een oppervlakkige dekking (10–30 endpoints, meestal alleen natal)
2. Waren duur op schaal ($0.02–$0.10 per request zonder volumekortingen)
3. Gebruikten gesloten motoren, waarvan de nauwkeurigheid niet te verifiëren is
4. Richtten zich op Vedische astrologie, terwijl westerse astrologie als secundair werd gepresenteerd

Dus hebben we Swiss Ephemeris zelf ge‑vendord en onze eigen rekenlaag geschreven - eerst voor het consumentproduct app.astroway.info, daarna voor de marketing‑site astroway.info, die dagelijks horoscopen levert aan honderdduizenden bezoekers per maand.

Na drie jaar productie van deze code kwamen we tot twee conclusies:

1. Diezelfde rekenmotor moet beschikbaar zijn voor andere ontwikkelaars: niet omdat ze het niet zelf kunnen bouwen, maar omdat de stack bibliotheek + caching + CI voor nauwkeurigheid een half jaar werk is dat niemand moet herhalen.
2. Onze dekking van Human Design (12 endpoints: kaart, type, autoriteit, profiel, poorten, kanalen, contouren, planetaire activaties, incarnation cross, definition) is echt uniek. Geen enkele concurrent biedt een volledige HD‑stack via API.

Dat is de lancering.

We hebben /nakshatras, /ashtakavarga en endpoints voor divisional‑kaarten, maar geen Dasha, Panchang, Ashtakoota, KP. Reden: in Vedische astrologie zijn er onopgeloste meningsverschillen tussen scholen (oorlogen over ayanamsa, discussies over KP‑cuspids, keuze van Dasha‑school). Een overhaaste Vedische component tegen Prokerala en VedicAstroAPI zou simpelweg kritiek krijgen.

De beslissing is vast: het Vedische pakket is fase 3, na een stabiele vraag naar de westerse en tijd om te valideren tegen Jagannatha Hora en Parashara’s Light. Beter om helemaal niet te lanceren dan slecht te lanceren.

Een oproep naar /chart kost ongeveer 50 keer minder berekeningen dan de 365‑daagse /forecast-calendar. Een vaste prijs per request zou lichte gebruikers afschrikken of zware gebruikers subsidiëren. Credits koppelen de kosten aan het werkelijke werk - zie de tabel per endpoint op de prijspagina.

Antwoorden op het gratis plan bevatten het veld _footer:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

Het kost ons niets, en geeft gratis gebruikers een kleine prikkel om te upgraden. In het Hobby+ plan wordt het verwijderd in de sleutelinstellingen. Het patroon is geleend van Zapier en RevenueCat.

/rectification (het bepalen van de geboortetijd op basis van levensgebeurtenissen via een likelihood‑grid zoekopdracht) - rekenintensief: één oproep duurt 10–60 seconden en voert tienduizenden tussenberekeningen van Swiss Ephemeris uit. We hebben het beperkt tot het Pro‑plan ($59 / maand) en een hoge credit‑prijs ingesteld, omdat misbruik de gedeelde infrastructuur voor iedereen zou belasten.

Endpoints /interpret/* werken via onze private AI‑gateway met automatische failover tussen meerdere modellen. We sluiten je niet af in onze prompts - elke respons met interpretatie bevat de onderliggende berekeningen, zodat je kunt overschakelen naar je eigen LLM als onze stem niet bij je past. Volledige prompts en outputs loggen we in een audit‑tabel voor B2B‑compliance (90 dagen opslag).

• Vedisch pakket: fase 3, na de eerste vraagbevestigingen (zie hierboven)
• Webhooks bij drempelbereiking: geïmplementeerd, maar UI is ruw; we werken eraan
• Publieke widgets (<script src="api.astroway.info/widget/natal.js">) - fase 7
• Plugin voor de hoofd‑Marketing‑site: apart project, gepland binnen de astroway.info‑ecosysteem

1. Lees de documentatie als je wilt begrijpen “waarom”: api.astroway.info/overview
2. Snelstart in 5 minuten met code: Astrology API Quick Start
3. Tarieven, inclusief de credit‑tabel per endpoint: api.astroway.info/pricing
4. Meld je aan: gratis, zonder kaart: api.astroway.info/dashboard/sign-up

Als je iets bouwt op de API - of een bug vindt, of een endpoint wilt dat we nog niet hebben - laat het ons weten. We horen liever honderd ontwikkelaars die iets vragen, dan features te lanceren die niemand gebruikt.

Vragen, verzoeken, vreemde edge‑cases: hello@astroway.info.

Open roadmap - PRODUCT-PLAN.md - wat er gedaan is, wat er volgt, wat uitgesteld is en waarom.

Welkom.