# AstroWay API

> Professional REST API for astrology calculations. 705 endpoints on Swiss Ephemeris (arc-second precision): natal chart, synastry, transits, Human Design, horoscopes, AI interpretations, Tarot (Rider-Waite/Marseille/Lenormand), Numerology (Pythagorean/Chaldean/Kabbalistic/Vedic), reference data, Hellenistic Lots, Destiny Matrix. Free tier — 10,000 credits/month, no card required.

Base URL: `https://api.astroway.info/v1` (production). `https://api.astroway.info/v1/sandbox/*` (sandbox — free, deterministic).

Authentication: `X-Api-Key` header. Live keys: `aw_live_*`. Sandbox keys: `aw_test_*`. Sign up at https://api.astroway.info/dashboard/sign-up. Exception: `/v1/reference/*` (14 lookup endpoints — signs, planets, houses, aspects, decans, nakshatras, lots, etc.) is public, no key required, 30 req/hour per IP.

OpenAPI spec: https://api.astroway.info/v1/openapi.json. Postman collection: https://api.astroway.info/postman/astroway-api.json.

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

Pricing: credits per request (10–500 depending on endpoint). Free 10,000/mo. Paid plans from $5/mo (Indie). See https://api.astroway.info/pricing/.

## Documentation Sets

- [Abridged documentation](https://api.astroway.info/llms-small.txt): a compact version of the documentation for AstroWay API, with non-essential content removed
- [Complete documentation](https://api.astroway.info/llms-full.txt): the full documentation for AstroWay API
- [Use Cases](https://api.astroway.info/_llms-txt/use-cases.txt): Integration guides for astrology apps, AI agents (MCP) and dating platforms.
- [Code Examples](https://api.astroway.info/_llms-txt/code-examples.txt): Practical examples: natal chart, synastry, transits, Human Design, common integration patterns.
- [Products](https://api.astroway.info/_llms-txt/products.txt): Per-product overview pages: Birth Chart, Human Design, Synastry, Horoscope APIs.

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [OpenAPI specification](https://api.astroway.info/v1/openapi.json): Machine-readable spec for all 705 endpoints — request/response schemas, parameters, error codes. Generate clients with openapi-generator or load directly into any SDK.
- [Postman collection](https://api.astroway.info/postman/astroway-api.json): Ready-to-import Postman collection covering every endpoint.
- [Pricing](https://api.astroway.info/pricing/): Credit pricing tiers and plan comparison.
- [Status page](https://api.astroway.info/status/): Real-time uptime and incident history.
- [Changelog](https://api.astroway.info/changelog/): API release notes and breaking changes.