Schnellstart für Astrologie-API: TypeScript und Python in 5 Minuten

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, Sommer in Kiew
  latitude: 50.4501,
  longitude: 30.5234,
  houseSystem: 'P',       // Placidus
});

console.log(`Sonne: ${chart.planets[0].sign} bei ${chart.planets[0].longitude}°`);
console.log(`ASC: ${chart.houses.ascendant}°`);
console.log(`Aspekte: ${chart.aspects.length}`);

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"Sonne: {chart['planets'][0]['sign']} bei {chart['planets'][0]['longitude']}°")
print(f"ASC: {chart['houses']['ascendant']}°")
print(f"Aspekte: {len(chart['aspects'])}")

{
  "name": "Sonne",
  "longitude": 111.87,      // ekliptische Länge in Grad
  "latitude": 0.0,
  "speed": 0.955,           // Grad pro Tag (negativ = rückläufig)
  "sign": "Krebs",
  "signIndex": 3,
  "house": 10,
  "retrograde": false
}

{
  "system": "P",
  "cusps": [12.34, 43.21, ...],   // 12 Werte
  "ascendant": 12.34,
  "mc": 280.12
}

{
  "planet1": "Sonne",
  "planet2": "Mond",
  "type": "Sextil",        // Konjunktion, Opposition, Trigon, Quadrat, Sextil, Quinkunx
  "orb": 1.36,              // Abweichung vom exakten Wert in Grad
  "applying": true
}

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(`Kompatibilitätswert: ${synastry.compatibility.score}/100`);

const transits = await client.transits({
  // Geburtsdaten
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
  // Transitsdatum
  transitDate: '2026-04-14',
});

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);

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} — Profil ${hd.profile}`);

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z

try {
  const chart = await client.chart({ ... });
} catch (err) {
  if (err.code === 'credits_exhausted') {
    console.log('Upgrade-Plan oder warten bis zur Rücksetzung');
  } else if (err.code === 'rate_limit_exceeded') {
    console.log(`Wiederholen in ${err.retryAfter} Sekunden`);
  }
}