1. Docs
  2. Getting Started
  3. 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 callQuickstart
Use the typed SDK (TypeScript / Python)SDK
Connect Claude Code, Cursor, or any MCP agentMCP Setup
Build with AI (Cursor, Claude Code, Lovable, Bolt)AI Prompts
Clone a working app and ship todayStarter Apps
Pick the right endpoints for your featureDomain Guides
Browse and test every endpoint liveAPI Playground
Understand API keys and authAuthentication

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

  1. Get an API key at roxyapi.com/pricing. Instant delivery after checkout.
  2. Call any endpoint with your key. Send JSON, get structured JSON back.
  3. 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.