- Docs
- Getting Started
- Introduction
Introduction
One API for astrology, Vedic astrology, tarot, numerology, and more.
Ten domains. One key. Verified against NASA JPL Horizons.
The fastest way to add natal charts, kundli matching, daily horoscopes, tarot readings, and spiritual insights to your app. No domain expertise required. You send a birth date, a number, or a sign. You get structured JSON back, ready to render.
Find your path
| You want to... | Go here |
|---|---|
| Make your first API call | Quickstart |
| Use the typed SDK (TypeScript / Python) | SDK |
| Connect Claude Code, Cursor, or any MCP agent | MCP Setup |
| Build with AI (Cursor, Claude Code, Lovable, Bolt) | AI Prompts |
| Clone a working app and ship today | Starter Apps |
| Pick the right endpoints for your feature | Domain Guides |
| Browse and test every endpoint live | API Playground |
| Understand API keys and auth | Authentication |
What you can build
- Dating apps with zodiac compatibility and full synastry
- Daily horoscope widgets for web and mobile
- Tarot reading apps with 78-card spreads and card imagery
- Kundli and matchmaking products for the Indian astrology market
- Numerology calculators, dream journals, crystal guides, angel-number lookups
- AI chatbots that answer questions about birth charts, tarot, and dashas
- Wellness apps with biorhythm and life-phase features
Not sure where to start? Every domain guide lists the most-used endpoints in the order you are most likely to ship them, with copy-paste code.
How it works
- Get an API key at roxyapi.com/pricing. Instant delivery after checkout.
- Call any endpoint with your key. Send JSON, get structured JSON back.
- Render it. You handle the UI. Roxy handles the intelligence.
You never need to understand astrology, Jyotish, numerology, or any domain. Every calculation and interpretation is done server-side.
Next step
Head to the Quickstart for your first call in 60 seconds, or jump straight into the typed SDK if you are shipping production code.