🕓 Bericht van 2026-04-14, bijgewerkt 2026-05-09. TS / Python / PHP SDK zijn nu live op public registries —
@astroway/sdk(npm),astroway(PyPI),astroway/sdk(Packagist). Details in changelog.
Je wilt een geboortehoroscoop berekenen vanuit code. Hier is de kortste weg — van nul tot een werkende JSON in 5 minuten.
Stap 1: API-sleutel verkrijgen (30 seconden)
Section titled “Stap 1: API-sleutel verkrijgen (30 seconden)”Registreer je op api.astroway.info/dashboard/sign-up. Gratis plan: 10 000 credits / maand. Geen creditcard nodig.
In dashboard klik je op «Create key» → «Production» → kopieer. Sleutels zien eruit als aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR.
Tip: er zijn ook sandbox-sleutels met het voorvoegsel aw_test_ — deze gebruiken geen credits. Gebruik ze tijdens de ontwikkeling.
Stap 2: SDK installeren
Section titled “Stap 2: SDK installeren”TypeScript
Section titled “TypeScript”npm install @astroway/sdkPython
Section titled “Python”pip install astrowayBeide SDK’s dekken alle 723 endpoints met getypeerde aanvragen en antwoorden.
Stap 3: Eerste geboortehoroscoop
Section titled “Stap 3: Eerste geboortehoroscoop”TypeScript
Section titled “TypeScript”import { Astroway } from '@astroway/sdk';
const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY!,});
const chart = await client.chart({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, // UTC+3, zomer in Kiev latitude: 50.4501, longitude: 30.5234, houseSystem: 'P', // Placidus});
console.log(`Zon: ${chart.planets[0].sign} op ${chart.planets[0].longitude}°`);console.log(`ASC: ${chart.houses.ascendant}°`);console.log(`Aspecten: ${chart.aspects.length}`);Start:
ASTROWAY_API_KEY=aw_live_... npx tsx chart.tsPython
Section titled “Python”from astroway import Astroway
client = Astroway(api_key="aw_live_your_key_here")
chart = client.chart( date="1990-07-14", time="14:30:00", timezone_offset=3, latitude=50.4501, longitude=30.5234, house_system="P",)
print(f"Zon: {chart['planets'][0]['sign']} op {chart['planets'][0]['longitude']}°")print(f"ASC: {chart['houses']['ascendant']}°")print(f"Aspecten: {len(chart['aspects'])}")Start:
ASTROWAY_API_KEY=aw_live_... python3 chart.pyWat retourneert de API
Section titled “Wat retourneert de API”Terugkomt een JSON-object met vier hoofdonderdelen:
planets
Section titled “planets”Een array met 12 objecten (Zon, Maan, Mercurius, Venus, Mars, Jupiter, Saturnus, Uranus, Neptunus, Pluto, Noordknoop, Chiron):
{ "name": "Zon", "longitude": 111.87, // ecliptische lengte in graden "latitude": 0.0, "speed": 0.955, // graden per dag (negatief = retrograde) "sign": "kreeft", "signIndex": 3, "house": 10, "retrograde": false}houses
Section titled “houses”Cuspen van huizen (12 stuks), evenals asc en MC:
{ "system": "P", "cusps": [12.34, 43.21, ...], // 12 waarden "ascendant": 12.34, "mc": 280.12}aspects
Section titled “aspects”Een array van aspecten tussen planeten:
{ "planet1": "Zon", "planet2": "Maan", "type": "sextiel", // conjunctie, oppositie, driehoek, vierkant, sextiel, quincunx "orb": 1.36, // afwijking van exact in graden "applying": true}chartSect
Section titled “chartSect”"diurnaal" (Zon boven de horizon bij geboorte) of "nocturnaal" (onder de horizon). Wordt gebruikt in klassieke astrologie.
Wat verder
Section titled “Wat verder”Wat nog meer te proberen:
Synastrie — compatibiliteit van twee personen:
const synastry = await client.synastry({ chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 }, chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },});console.log(`Compatibiliteitsscore: ${synastry.compatibility.score}/100`);Huidige transits op geboortehoroscoop:
const transits = await client.transits({ // geboortedata date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, // transitsdatum transitDate: '2026-04-14',});Dagelijkse horoscoop met echte transits:
const horoscope = await client.horoscopeDaily({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(horoscope.text);Volledige Human Design-kaart:
const hd = await client.humanDesign({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});console.log(`${hd.type} — ${hd.strategy} — Profiel ${hd.profile}`);Kosten in credits
Section titled “Kosten in credits”- Geboortehoroscoop (
/chart): 20 credits - Synastrie: 50 credits
- Transits: 50 credits
- Dagelijkse horoscoop: 20 credits
- Human Design: 50 credits
Gratis plan: 10 000 credits / maand = 500 geboortehoroscopen, of 200 synastrieën, of gemengde belasting.
Foutafhandeling
Section titled “Foutafhandeling”Elk antwoord bevat headers met credits:
X-Credits-Used: 20X-Credits-Remaining: 4980X-Credits-Reset: 2026-05-01T00:00:00ZWanneer credits op zijn — krijg je 402 Payment Required. Wanneer je de rate-limit raakt (Free: 10 verzoeken / min) — 429 Too Many Requests met header Retry-After.
SDK gooit getypeerde fouten, die je kunt vangen:
try { const chart = await client.chart({ ... });} catch (err) { if (err.code === 'credits_exhausted') { console.log('Upgrade plan of wacht tot reset'); } else if (err.code === 'rate_limit_exceeded') { console.log(`Herprobeer in ${err.retryAfter} seconden`); }}En dat is alles
Section titled “En dat is alles”Nu heb je:
- Werkende API-sleutel
- Geïnstalleerde SDK
- Eerste geboortehoroscoop
- Voldoende voorbeelden om synastrie, transits, horoscopen toe te voegen
Lees verder:
- Volledige handleiding «van waar te beginnen» — meer details
- Voorbeeld: geboortehoroscoop — diepere walkthrough
- API-referentie — alle 723 endpoints
Dezelfde Swiss Ephemeris als in Solar Fire — in 4 regels code.
Gratis sleutel zonder kaart. 5.000 calls per maand tot de eerste betaling.