AstroWay/api v2.325.2 · de
alle Systeme in Ordnung

Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)

pyswisseph vs a REST API for Swiss Ephemeris calculations - C dependencies, data files, licensing and deployment compared, with a decision guide.

Almost every “how do I do astrology in code” answer points at pyswisseph - the Python bindings for the Swiss Ephemeris C library. It’s excellent. But it’s a C extension you compile, data files you ship, and chart logic you write yourself. A REST API removes all three. Here’s an honest comparison so you pick the right one.

pyswisseph exposes the raw Swiss Ephemeris functions: swe_calc_ut, swe_houses, and friends. You get maximum control and offline operation. In return you take on:

  • A C extension. It compiles on install: fine on your laptop, a recurring source of CI and Docker friction (build tools, wheels per platform/arch).
  • Ephemeris data files. For full JPL precision you ship the .se1 files (tens of MB). The built-in Moshier mode avoids them at a small precision cost.
  • The astrology layer. swe_calc_ut returns a longitude. House systems, aspect detection, dignities, chart assembly - you build all of it.
  • Licensing. The Swiss Ephemeris is dual-licensed (AGPL or a paid professional license). If you ship it inside a closed-source product, that’s a question you have to answer.

AstroWay computes positions on its own servers, with no upstream API, and serves them over HTTP:

from astroway import Astroway, BirthData
aw = Astroway(api_key="aw_live_...")
chart = aw.chart.compute(BirthData(
date="1990-07-14", time="14:30:00", timezone_offset=3,
latitude=50.45, longitude=30.52,
))

No compile step, no data files, no house-system code. You add a network round-trip and an API key, and get 865 endpoints (houses, aspects, synastry, transits, Vedic, Human Design) instead of just planet longitudes.

pyswissephREST API
InstallCompiles a C extensionpip install, pure Python client
Data filesShip .se1 for full precisionNone - server-side
Chart logicYou write itEndpoints return it
OfflineYesNo (needs network)
Beyond longitudesBuild yourself865 endpoints
AccuracySwiss EphemerisArc-second, verified against NASA JPL Horizons
  • Use pyswisseph for an offline CLI, a notebook, a desktop app, or when you need the library to run with no network and you’re comfortable owning the data files, the chart code and the license question for your product.
  • Use a REST API for a web app, a serverless function, or any service where you don’t want a C build in your pipeline or ephemeris files in your image - and where you’d rather call synastry or transits than implement them.

Both give arc-second positions. The choice is about what you want to own.

MakSeong · AstroWay

Ich entwickle das AstroWay API: packe Astrologie-Mathematik auf die Bogensekunde in reines REST und schreibe über langweilige Details, die eigentlich wichtig sind.

// darauf aufbauen

Positionen auf die Bogensekunde in 4 Zeilen Code.

Kostenloser Schlüssel ohne Kreditkarte. 5.000 Aufrufe pro Monat vor der ersten Zahlung.

Mehr aus dem Blog alle Beiträge →

Ephemeris 2026-07-19

Wie wir die Genauigkeit unter Kontrolle halten: CI gegen swetest und NASA

In einer Astrologie-API verschlechtert sich die Genauigkeit leicht durch ein einziges Refactoring der Ephemeriden. Wir zeigen unseren Schutz: ein Swiss-Ephemeris-Kern für App und API, Hunderte eingefrorene Snapshots auf Referenzhoroskopen und die Triangulation jedes PR gegen swetest CGI, Kerykeion, Prokerala und den Finsterniskatalog der NASA.

Engineering 2026-07-15

Drei offizielle SDKs: TypeScript, Python, PHP statt rohem curl

Rohes HTTP funktioniert, aber ein typisierter Client spart Stunden: Autovervollständigung der Pfade, Request- und Response-Typen, eingebauter Retry bei 408/409/429/5xx und eine Fehlerhierarchie im Stainless-Stil. Wir gehen die drei offiziellen SDKs durch, @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist), und zeigen, wie sie aus einem einzigen OpenAPI-Vertrag generiert werden.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.