AstroWay API Documentation

The technical documentation hub for AstroWay API. 722 endpoints powered by Swiss Ephemeris, a machine-readable OpenAPI spec, ready-to-import Postman/Insomnia collections, official SDKs for TypeScript, Python and PHP, plus an MCP server for Claude and Cursor.

Reference

API Reference Full catalogue of 722 endpoints — parameters, response schemas, error codes. Regenerated from the OpenAPI spec on every release.

OpenAPI specification Machine-readable spec. Import into Postman or Insomnia, or generate your own SDK with openapi-generator.

Postman collection Ready-to-import collection with examples for every endpoint.

Per-endpoint cost Cost in credits for every endpoint — from 0 to 500 credits per call.

Getting started

Quick start Sign up, grab a key, make your first call in 5 minutes.

Authentication X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*) keys, JWT for the dashboard.

Credits & rate limits Credit pooling, monthly quotas, rate limits per plan.

Language support 21 active languages. Response-text localisation via `Accept-Language` header.

SDKs and integrations

TypeScript SDK Official `@astroway/sdk` package on npm. ESM, Node 20+, browser-compatible.

Python SDK Official `astroway` package on PyPI. Sync and async clients, Python 3.9+.

PHP SDK Official `astroway/sdk` package on Packagist. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp` — Model Context Protocol server for Claude Desktop, Cursor and other MCP-compatible AI agents.

Engineering

Calculation accuracy Swiss Ephemeris arc-second precision. CI snapshot tests against the NASA Eclipse Catalog.

Errors Error codes, HTTP statuses, and the error envelope structure.

Idempotency `Idempotency-Key` header for safe POST retries.

Versioning How we bump versions, what breaks compatibility, how to read the changelog.

Use cases and examples

Products overview Four product groups — Birth Chart, Human Design, Synastry, Horoscope.

Vedic astrology 354+ endpoints for Vedic — Vargas, dashas (8 systems), Panchang, Shadbala, Yogas, Doshas.

Code examples Ready snippets for natal chart, synastry, transits, Human Design, MCP.

Use cases Integration scenarios for astrology apps, AI agents, and dating platforms.