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

Vandaag kondigen we AstroWay API aan - een computationele backend voor ontwikkelaars die astrologische apps, horoscooptoepassingen, compatibiliteitsfuncties voor dating en AI-agents maken die over geboortekaarten moeten nadenken.

In dit artikel - wat er echt in de API zit, welke ongebruikelijke oplossingen we hebben genomen, wat we bewust buiten de haak hebben gelaten en hoe we hier zijn gekomen. Zonder water.

🕓 Notitie van 2026-04-22, bijgewerkt 2026-05-09. Sommige cijfers zijn verouderd. De huidige status: 723 eindpunten (en niet 87 op het moment van lancering), 818 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 openbare registers. De meest recente status - op /faq en changelog.

Een REST API op basis van Swiss Ephemeris (LGPL), samengesteld in WASM en geïmplementeerd als Node.js-service - nu ook met AI-interpretaties (failover-keten GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral) bovenop echte berekeningen. Dezelfde motor die professionele astrologen 30+ jaar gebruiken in Solar Fire, Kepler, Astro Gold en Janus - nauwkeurigheid tot een fractie van een hoekseconde, geverifieerd met de ephemeris van NASA JPL en de officiële swetest-referentie van Astrodienst (Astro.com).

Cijfers:

• 723 eindpunt - westerse geboortehoroscoop, synastrie, transits, progressies, directies, terugkeer, harmonieën, vaste sterren, Arabische punten, astrocartografie plus een complete set Human Design
• 183 snapshot-tests in CI tegen de echte uitvoer van swetest CGI en de catalogus van NASA-eclipsen - worden uitgevoerd op elke PR
• p50 < 100 ms, p95 < 500 ms voor typische berekenings-eindpunten
• MCP-server @astroway/mcp + drie SDK’s op openbare registers: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - dezelfde API in drie talen
• MCP-server: @astroway/mcp - levert API als tools voor Claude, GPT, Cursor en andere LLM-agents
• Credit-based tarieven: gratis plan (10 000 credits / maand, geen creditcard), betaalde - 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 consumentenastrologische toepassingen. De berekeningslaag bleek het moeilijkste deel - veel moeilijker dan UI of inhoud. Bestaande diensten hadden:

1. Oppervlakkige dekking (10-30 eindpunten, meestal alleen geboortehoroscoop)
2. Waren duur op grote schaal ($0,02-$0,10 per verzoek zonder bulkdiscounts)
3. Gebruikten gesloten motoren, waarvan de nauwkeurigheid niet kon worden gecontroleerd
4. Richtten zich op vedische astrologie, terwijl westerse astrologie als tweede werd aangeboden

Dus hebben we Swiss Ephemeris zelf geïmplementeerd en onze eigen berekeningslaag geschreven - eerst voor ons consumentenproduct app.astroway.info, toen voor onze marketingsite astroway.info, die dagelijkse horoscopen aan honderdduizenden bezoekers per maand levert.

Na drie jaar werking van deze code in productie zijn we tot twee conclusies gekomen:

1. Dezelfde berekeningsmotor moet beschikbaar zijn voor andere ontwikkelaars - niet omdat ze hem zelf niet kunnen schrijven, maar omdat de stap bibliotheek + WASM + caching + CI op nauwkeurigheid een half jaar werk is, dat niemand moet herhalen.
2. Ons Human Design-dekking (12 eindpunten - kaart, type, autoriteit, profiel, poorten, kanalen, contouren, planetaire activaties, incarnatiekruis, definitie) - is echt uniek. Geen enkele concurrent biedt een complete Human Design-stap via API.

Dit is de lancering.

We hebben /nakshatras, /ashtakavarga en eindpunten voor divisional-kaarten, maar geen Dasha, Panchang, Ashtakoota, KP. Reden: in vedische astrologie zijn er onopgeloste meningsverschillen tussen scholen (oorlogen over ayanamsha, discussies over kuipen van KP, keuze van school voor dasha). Een haastig gemaakte vedische component tegen Prokerala en VedicAstroAPI zou alleen maar kritiek hebben gekregen.

Beslissing is vastgelegd: vedische pakket - aparte fase 3, nadat er eerst vraag naar westerse astrologie is en er tijd is om te valideren tegen Jagannatha Hora en Parashara’s Light. Beter om het niet te lanceren, dan om het slecht te lanceren.

Een enkel verzoek /chart kost ~50 keer minder berekeningen dan een 365-dagen /forecast-calendar. Een platte prijs per verzoek zou ofwel lichte gebruikers hebben buitengesloten, ofwel zware gebruikers hebben gesubsidieerd. Credits kaarten de kosten naar de werkelijke werklast - zie de tabel per eindpunt op de prijzenpagina.

Antwoorden op het gratis plan bevatten een _footer-veld:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — krijg je eigen sleutel op api.astroway.info"
}

Dit kost ons niets, en geeft gratis gebruikers een kleine stimulans om te upgraden. Op het Hobby+-plan kan dit worden uitgeschakeld in de instellingen van de sleutel. Patroon geleend van Zapier en RevenueCat.

/rectification (zoeken naar geboortetijd op basis van levensgebeurtenissen via likelihood-grid) - is berekeningsintensief: één verzoek duurt 10-60 seconden en doet duizenden tussentijdse berekeningen van Swiss Ephemeris. We hebben het beperkt tot het Pro-plan ($59 / maand) en hebben een hoge creditprijs ingesteld, omdat misbruik de gedeelde infrastructuur voor alle anderen zou hebben belast.

Eindpunten /interpret/* worden gerouteerd via onze privé-AI-gateway, die best-of-breed-modellen van de markt gebruikt (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) met automatische failover. We sluiten je niet op in onze prompts - elk antwoord met interpretatie bevat de oorspronkelijke berekeningen, zodat je het zelf kunt interpreteren met je eigen LLM, als onze stem je niet bevalt. Volledige prompts en uitvoer loggen we in een audit-tabel voor B2B-compliancy (90 dagen bewaren).

• Vedisch pakket - fase 3, na de eerste bevestigingen van vraag (zie boven)
• Webhook voor drempelwaarden - geïmplementeerd, maar UI is ruw; worden bijgewerkt
• Openbare widgets (<script src="api.astroway.info/widget/natal.js">) - fase 7
• Plugin voor hoofdmarketingsite - apart project, gepland in het kader van de astroway.info-ecosysteem

1. Lees de documentatie als je wilt begrijpen “waarom”: api.astroway.info/overview
2. Snel starten in 5 minuten met code: Astrology API Quick Start
3. Prijzen, inclusief tabel met credits per eindpunt: api.astroway.info/pricing
4. Registreer je - gratis, geen creditcard: api.astroway.info/dashboard/sign-up

Als je iets bouwt op de API - of je vindt een bug, of je wilt een eindpunt dat we nog niet hebben - schrijf ons dan. We vinden het beter om honderd ontwikkelaars te horen die iets vragen, dan om functies te lanceren die niemand gebruikt.

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

Roadmap is openbaar - PRODUCT-PLAN.md - wat is gedaan, wat is het volgende, wat is uitgesteld en waarom.

Welkom.