- Docs
- Getting Started
- Introduction
Introduction
Roxy is the intelligence layer for apps that need astrology, tarot, numerology, I-Ching, dream interpretation, angel numbers, and crystal healing. You send a birth date, a card position, or a number. You get structured data back with full interpretations, ready to display in your app. No domain expertise required.
One API key. 8 domains. 110+ endpoints. Instant activation, no approval queue.
Find your path
| I want to... | Go here |
|---|---|
| Make my first API call right now | Quickstart |
| Build with AI (Cursor, Lovable, Claude) | AI Prompts |
| Clone a working app and ship today | Starter Apps |
| Connect an AI agent via MCP | MCP Setup |
| Understand how API keys and auth work | Authentication |
| Learn which endpoints to call for my use case | Domain Guides |
| Browse all endpoints and test them live | API Reference |
What you can build
- Dating apps with zodiac compatibility and synastry scoring
- Daily horoscope widgets for any website or mobile app
- Tarot reading apps with full 78-card spreads and card imagery
- Numerology calculators for Life Path, Expression, and compatibility
- AI chatbots that answer questions about birth charts, tarot, and more
- Dream journals with 2,000+ symbol interpretations
- Kundli and matchmaking platforms for the Indian astrology market
- Wellness apps using crystals, angel numbers, and numerology as engagement features
Not sure which endpoints you need? Each Domain Guide explains what you can build, which endpoints to call in what order, with working code you can copy-paste.
How it works
- Get an API key at roxyapi.com/pricing. Instant delivery after checkout.
- Call any endpoint with your key. You send data, you get structured JSON back.
- Build your app. You handle the UI, Roxy handles the intelligence.
You do not need to understand astrology, tarot, numerology, or any domain. The API handles all calculations and interpretations. The Quickstart walks you through your first call in 60 seconds, including what a terminal is and how API requests work.
Next steps
Ready? Head to the Quickstart.