# Fast, reliable data APIs

> > **Base URL:** `https://roxyapi.com/api/v2`  

Developer-focused APIs with flexible subscription plans and transparent pricing. No user accounts required - just checkout to get your API key instantly.

## Quick Start

For detailed guides on authentication, rate limits, and error handling, see the Full API Docs (Markdown) link below.

## Information

- [Pricing](https://roxyapi.com/pricing): Detailed plan information and billing options (2.0.0)
- [Get API Key](https://roxyapi.com/checkout): Instant API key delivery upon checkout
- [Interactive API Documentation](https://roxyapi.com/docs): Human-friendly Scalar interface for testing endpoints
- [Privacy Policy](https://roxyapi.com/policy/privacy): How we collect and protect your data
- [Terms of Service](https://roxyapi.com/policy/terms): Legal terms and conditions

## Support

- [FAQ](https://roxyapi.com/faq): Common questions about pricing, rate limits, and usage
- [Contact](https://roxyapi.com/contact): Get help, report issues, or request API key recovery

## API Reference

- [OpenAPI Specification](https://roxyapi.com/api/v2/openapi.json): Machine-readable OpenAPI 3.1.0 spec (2.0.0)
- [Full API Docs (Markdown)](https://roxyapi.com/llms-full.txt): Complete API reference in plain markdown format for LLM consumption

## Available Endpoints

> **Base URL:** `https://roxyapi.com/api/v2`

### Western Astrology

Generate accurate natal charts, zodiac horoscopes, and compatibility analysis. Tropical astrology API with 16+ endpoints. Instant access, MCP support.

- **GET /astrology/signs**: Get all zodiac signs - Complete zodiac signs list with dates and elements
- **GET /astrology/signs/{identifier}**: Get zodiac sign details - Complete astrology sign profile with personality traits
- **GET /astrology/planet-meanings**: Get all planet meanings - Complete astrology planet interpretations list
- **GET /astrology/planet-meanings/{identifier}**: Get planet meaning details - Complete astrology planet interpretation
- **POST /astrology/natal-chart**: Generate natal chart - Birth chart calculator API with houses and aspects
- **POST /astrology/planets**: Get planetary positions - Ephemeris calculator for all planets
- **GET /astrology/moon-phase/current**: Get current moon phase - Lunar phase calculator with zodiac sign
- **GET /astrology/moon-phase/upcoming**: Get upcoming moon phases - Next new moon, full moon, quarters
- **GET /astrology/moon-phase/calendar/:year/:month**: Get lunar calendar - Moon phases for entire month
- **POST /astrology/synastry**: Calculate synastry - Relationship compatibility analysis API
- **POST /astrology/houses**: Calculate house cusps - House system calculator with comparison
- **POST /astrology/aspects**: Calculate planetary aspects - Aspect finder for any date and time
- **POST /astrology/transits**: Calculate planetary transits - Current transits with natal chart comparison
- **POST /astrology/transit-aspects**: Calculate transit aspects to natal chart
- **POST /astrology/solar-return**: Calculate solar return chart
- **POST /astrology/lunar-return**: Calculate lunar return chart
- **POST /astrology/composite-chart**: Calculate composite chart for relationship
- **POST /astrology/compatibility-score**: Calculate relationship compatibility score
- **GET /astrology/horoscope/:sign/daily**: Get daily horoscope for zodiac sign
- **GET /astrology/horoscope/daily**: Get daily horoscopes for all zodiac signs
- **GET /astrology/horoscope/:sign/weekly**: Get weekly horoscope for zodiac sign
- **GET /astrology/horoscope/:sign/monthly**: Get monthly horoscope for zodiac sign
- **POST /astrology/planetary-returns**: Calculate planetary return chart

### Vedic Astrology

Production-grade Vedic (Jyotish) and KP astrology API for AI agents and developers. NASA JPL ephemerides with sub-arcsecond accuracy. Birth charts (D1/D9), Ashtakoot Gun Milan compatibility, Vimshottari Dasha predictions, dosha detection with remedies, 300+ planetary yogas, complete Panchang, and KP horary with 249-level sub-lord analysis. 17+ endpoints optimized for matrimonial apps, horoscope platforms, spiritual wellness services, and AI-powered astrology chatbots.

- **POST /vedic-astrology/birth-chart**: Get birth chart (D1 Rashi chart) - Kundli Calculator API
- **POST /vedic-astrology/navamsa**: Get Navamsa chart (D9) - Marriage Compatibility Calculator
- **POST /vedic-astrology/compatibility**: Calculate compatibility score - Gun Milan API (Ashtakoot Matching)
- **POST /vedic-astrology/planetary-positions**: Get planetary positions - Graha Positions API
- **POST /vedic-astrology/dasha/current**: Get current Mahadasha, Antardasha, Pratyantardasha - Dasha Calculator API
- **POST /vedic-astrology/dasha/major**: Get all 9 Mahadasha periods (120-year cycle)
- **POST /vedic-astrology/dasha/sub/{mahadasha}**: Get all Antardashas (sub-periods) for a specific Mahadasha
- **POST /vedic-astrology/panchang/basic**: Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator
- **POST /vedic-astrology/dosha/manglik**: Check Manglik Dosha - Mangal Dosha Calculator API
- **POST /vedic-astrology/dosha/kalsarpa**: Check Kalsarpa Dosha - Kalsarpa Yoga Calculator API
- **POST /vedic-astrology/dosha/sadhesati**: Check Sadhesati - Sade Sati Calculator API (Saturn Transit)
- **GET /vedic-astrology/yoga**: List all planetary yogas - 300+ Vedic Yoga Combinations
- **GET /vedic-astrology/yoga/:id**: Get yoga details by ID - Detailed Yoga Information API
- **GET /vedic-astrology/kp/ayanamsa**: Get KP-Newcomb ayanamsa - Dynamic daily calculation
- **POST /vedic-astrology/kp/planets**: Get KP planetary positions with sub-lords
- **POST /vedic-astrology/kp/cusps**: Get Placidus house cusps with sub-lords
- **POST /vedic-astrology/kp/chart**: Generate complete KP birth chart

### Tarot

Professional tarot card reading API with complete 78-card Rider-Waite-Smith deck. Seeded reproducibility for consistent readings. Traditional spreads including Celtic Cross, love, and career guidance. Supports reversals and custom layouts.

- **GET /tarot/cards**: List all 78 tarot cards
- **GET /tarot/cards/{id}**: Get detailed tarot card information
- **POST /tarot/draw**: Draw random tarot cards with reproducible results
- **POST /tarot/daily**: Get daily tarot card reading
- **POST /tarot/yes-no**: Get yes/no answer to your question
- **POST /tarot/spreads/three-card**: Three-Card Spread: Past, Present, Future
- **POST /tarot/spreads/celtic-cross**: Celtic Cross Spread (10 cards)
- **POST /tarot/spreads/love**: Love Spread (5 cards)
- **POST /tarot/spreads/career**: Career Spread (7 cards)
- **POST /tarot/spreads/custom**: Custom Spread Builder

### Numerology

Production-ready Pythagorean numerology API + MCP for AI agents and developers. Calculate life path numbers, destiny numbers, soul urge, relationship compatibility, karmic debt analysis, and complete birth charts. Master number detection (11, 22, 33), karmic lessons, and personal year forecasts. 12+ endpoints with detailed interpretations optimized for chatbots, AI assistants, wellness apps, and spiritual platforms.

- **POST /numerology/life-path**: Calculate Life Path number - Most important numerology calculation
- **POST /numerology/expression**: Calculate Expression number - Natural talents and life goals
- **POST /numerology/soul-urge**: Calculate Soul Urge number - Inner motivations and desires
- **POST /numerology/personality**: Calculate Personality number - How others perceive you
- **POST /numerology/birth-day**: Calculate Birth Day number - Special talents from day of birth
- **POST /numerology/maturity**: Calculate Maturity number - Who you become in later life
- **POST /numerology/karmic-lessons**: Analyze Karmic Lessons - Life lessons from missing numbers
- **POST /numerology/karmic-debt**: Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)
- **POST /numerology/personal-year**: Calculate Personal Year - Annual cycle and forecast for current year
- **POST /numerology/compatibility**: Calculate Compatibility - Relationship dynamics between two people
- **POST /numerology/chart**: Generate Complete Numerology Chart - Full profile analysis
- **GET /numerology/meanings/{number}**: Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33

### Usage

Monitor your API usage, check rate limits, and track request consumption. Get detailed usage breakdowns by endpoint, current month statistics, and recommendations for plan upgrades when approaching limits. Essential for managing API quotas and optimizing subscription plans.

- **GET /usage**: Get API usage statistics