AstroWay API Documentation
The technical documentation hub for AstroWay API. 865 endpoints at arc-second precision, 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
Section titled “Reference” API Reference Full catalogue of 865 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
Section titled “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
Section titled “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
Section titled “Engineering” Calculation accuracy Arc-second precision, verified against NASA JPL Horizons. 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
Section titled “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.