# Astro Engine API

> Multi-tradition astrological calculation API. Deterministic, explainable, edge-native — Vedic, Western, Chinese, Numerology, Human Design, Synastry, Transits, Horoscope, Biorhythm, Divination.

- Docs (interactive, OpenAPI-driven): https://astro-vibe-api.pages.dev/docs
- Live API tester (Console): https://astro-vibe-api.pages.dev/console
- Health: https://astro-vibe-engine.gauravapproved.workers.dev/v1/health
- OpenAPI 3.1 spec: https://astro-vibe-engine.gauravapproved.workers.dev/v1/openapi.json
- Pricing & plans: https://astro-vibe-api.pages.dev/#pricing

## Quick start

```
POST https://astro-vibe-engine.gauravapproved.workers.dev/v1/chart/universal
x-api-key: av_...
{
  "date": "1990-06-15",
  "time": "14:30:00",
  "tz": "Asia/Kolkata",
  "lat": 28.6139,
  "lon": 77.209,
  "traditions": ["vedic", "western", "chinese"]
}
```

## Endpoint groups (192 endpoints)

- `/v1/chart/universal` — full Vedic + Western + Chinese + Numerology chart
- `/v1/ephemeris/positions` — raw L1 planetary longitudes & house cusps
- `/v1/vedic/*` — panchang, dasha, shadbala, ashtakavarga, yogas, muhurtha
- `/v1/numerology/chart` — life path, expression, soul urge, pinnacles, challenges
- `/v1/synastry/compatibility` — Ashta Kuta (36 pts) + Western aspects
- `/v1/forecast/transits`, `/v1/horoscope/reading`, `/v1/biorhythm/calculate`
- `/v1/humandesign/profile`, `/v1/chinese/bazi`, `/v1/astrology/moon-phase/current`
- `/v1/divination/*` — tarot, iching, crystals, dreams, angel-numbers

## Key management

- Create keys via CLI (`scripts/manage-keys.ts`) or the operator console (admin only).
- Authenticate with header `x-api-key: <key>`.
- Free plan: 100 req/day. B2B plans: daily/monthly limits with 429 on exceed.