Frequently Asked Questions

RoxyAPI offers simple subscription-based billing with monthly and yearly plans in 2026. Annual subscriptions save about 20% compared to monthly billing. All plans include access to every API endpoint with no per-endpoint charges, instant API key delivery, comprehensive documentation, MCP integration, and email support. We do not use complex pay-per-request pricing like some competitors - predictable monthly costs help developers & businesses budget effectively. Request quotas reset on the 1st of each calendar month (UTC timezone).

With RoxyAPI, every request costs the same. A planet position call and a full birth chart call both count as one request. There is no credit math, no variable costs per endpoint, no surprises on your bill. Unlike credit-based APIs where a basic Panchang call might cost 10 credits but a Kundali costs 300 credits and a PDF report costs 350,000 credits, RoxyAPI uses flat per-request pricing across all 2026 plans. Your Starter plan gives you 5,000 requests, and each request is equal regardless of which endpoint you call or how complex the calculation is. This means you can predict your monthly costs exactly, you never run out of credits mid-month because a few users hit expensive endpoints, and you never need to buy add-on credit packs. One subscription, one price per request, all domains included.

Yes. Refunds are available within 24 hours of your initial payment if your API key was not used. Eligible refunds are processed automatically to your original payment method within 5-10 business days. Once API usage has occurred, or after the 24-hour window, refunds are not available. You can cancel your subscription at any time with no cancellation fees - your access continues through the end of the current billing period.

When you reach your monthly request limit, RoxyAPI returns HTTP 429 (Too Many Requests) responses until your quota resets or you subscribe to a higher tier - we never charge surprise overage fees in 2026. Monitor usage in real-time via the /usage api OR the "X-RateLimit-Limit, X-RateLimit-Used and X-RateLimit-Remaining" headers in each api response. To move to a higher tier, cancel your current subscription and subscribe to the new one - your access continues through the end of the current billing period. For temporary traffic spikes, our Business plan provides headroom for growth, or visit our contact page for custom enterprise quotas.

Automated plan switching is not yet supported on RoxyAPI. To move to a different tier, cancel your current subscription and subscribe to the new one - your access continues through the end of the current billing period with no refunds for unused time. There are no lock-in periods or cancellation fees. We recommend estimating your monthly request volume before subscribing so you start on the right plan. Use the request headers (X-RateLimit-Used, X-RateLimit-Remaining) or the /usage endpoint to track consumption and plan ahead. Automated plan switching is on the roadmap.

RoxyAPI offers 20+ free interactive tool pages where you can test numerology calculators, tarot readings, I-Ching consultations, dream lookups, daily horoscopes, and birth charts without signing up in 2026. The interactive API reference at /api-reference has a test sandbox — make live API calls against real endpoints immediately, no signup or credit card needed. For production-level testing with your own parameters, subscribe to our Starter plan ($39/month, cancel anytime) which provides 5,000 monthly requests, sufficient for integration testing and initial prototype development.

Pay your way. We accept all major credit and debit cards (Visa, Mastercard, American Express) processed securely through PayPal for USD and Razorpay for INR. Digital wallets like Apple Pay and Google Pay work seamlessly. For annual subscriptions, cryptocurrency payments are available. Contact us to pay with crypto. All transactions use industry-standard encryption. Your payment information is never stored on our servers.

RoxyAPI offers enterprise plans for high-volume applications in 2026. Our Enterprise plan ($699/month) includes 1,000,000 monthly requests, dedicated account manager, custom integration support, 99.95% uptime SLA with financial credits, priority feature requests, and SOC 2 compliance documentation. For applications requiring beyond 1M monthly requests, visit our contact page for custom quotes with volume discounts, dedicated infrastructure, flexible billing (NET 30/60 terms, annual prepay discounts), and white-label API options. Enterprise customers building astrology apps, AI agent platforms, or therapy platforms with integrated spiritual features get dedicated account management and custom rate limits.

RoxyAPI is a RESTful HTTP API compatible with all programming languages and frameworks in 2026. Works with JavaScript/TypeScript (Node.js, React, Vue, Angular, Svelte), Python (FastAPI, Django, Flask), Ruby (Rails), PHP (Laravel), Java (Spring Boot), Go, Swift (iOS), Kotlin (Android), C#/.NET, and any language that can make HTTP requests. Our comprehensive API documentation includes curl examples and full OpenAPI specifications for automatic client generation with tools like openapi-generator or openapi-typescript. For MCP integration, use the official TypeScript SDK (@modelcontextprotocol/sdk) with any language supporting HTTP/SSE communication. All endpoints follow standard REST principles with JSON request/response bodies, making integration straightforward in any stack.

Yes! RoxyAPI offers extensive developer resources in 2026. Our interactive API reference at /api-reference provides complete API reference with request/response examples, parameter descriptions, authentication details, and live testing interface for all 130+ endpoints across astrology, tarot, numerology, dream interpretation, angel numbers, crystals, and I-Ching. The /llms.txt and /llms-full.txt endpoints deliver AI-friendly documentation for Cursor, Windsurf, and GitHub Copilot. Documentation covers authentication (API key setup), endpoint references (all 10+ intelligence domains), response schema specifications, error handling best practices, and rate limiting guidelines. Full OpenAPI specification enables automatic client generation in any language. Support is available via our contact page.

RoxyAPI uses simple API key authentication for all requests in 2026. After subscribing, your unique API key is generated instantly and displayed on the success page and dashboard. Include it in requests via X-API-Key header: `X-API-Key: your_api_key_here` or as query parameter: `?api_key=your_api_key_here` (useful for testing). API keys are cryptographically secure HMAC-signed strings for fast verification. No OAuth flows, no JWT token refresh complexity, no session management - just straightforward API key authentication. Keys never expire unless regenerated manually for security. For MCP integration, configure API key once in client settings - MCP handles authentication automatically. Store keys securely in environment variables (never commit to version control).

RoxyAPI enforces monthly request quotas based on subscription plan: Starter (5,000/month), Professional (50,000/month), Business (200,000/month), Enterprise (1,000,000/month) in 2026. When exceeding limits, endpoints return HTTP 429 with error message explaining quota exhaustion and reset date. Check response headers for usage insights: X-RateLimit-Limit (total monthly quota), X-RateLimit-Remaining (requests left), X-RateLimit-Used (consumed count), X-RateLimit-Reset (next reset timestamp UTC). Monitor the /usage endpoint for approaching limits. Best practices: cache common requests (daily horoscopes, zodiac interpretations), upgrade proactively before hitting limits. Enterprise plans offer custom rate limits for traffic spikes.

Absolutely! RoxyAPI is optimized for serverless and edge computing environments in 2026. Our APIs work seamlessly with AWS Lambda (Node.js, Python runtimes), Vercel serverless functions, Cloudflare Workers, Netlify Functions, Google Cloud Functions, and Azure Functions. Sub-100ms response times ensure requests complete within typical serverless timeout limits. Use HTTP client libraries (axios, node-fetch, ky) in function code with API key from environment variables. For edge deployments (Cloudflare Workers at 250+ locations), RoxyAPI's global CDN reduces latency to <50ms worldwide. Serverless architecture advantages: pay-per-invocation cost optimization (no idle server costs), automatic scaling for traffic spikes, zero infrastructure management. Example: Vercel Next.js app with API routes calling RoxyAPI for dynamic horoscope generation with edge caching.

Yes! RoxyAPI supports Cross-Origin Resource Sharing (CORS) for all browser-based requests in 2026. Our servers return appropriate CORS headers (Access-Control-Allow-Origin: *, Access-Control-Allow-Methods: GET/POST/PUT/DELETE, Access-Control-Allow-Headers: X-API-Key/Content-Type) enabling direct API calls from React, Vue, Angular, Svelte, and vanilla JavaScript running in browsers. No proxy server or backend required for simple applications. However, for security best practices in production, we recommend proxying API calls through your backend to avoid exposing API keys in browser source code. Browser-based apps work great for demos, prototypes, and internal tools. For public production apps with user authentication, implement server-side proxy endpoint that adds API key server-side before forwarding to RoxyAPI.

Migrating to RoxyAPI from other astrology, tarot, or numerology providers is straightforward in 2026. RoxyAPI uses standard REST with clean JSON responses, making endpoint mapping simple. Our comprehensive API documentation at /api-reference lets you compare response structures and find equivalent endpoints for common operations (birth chart calculation, tarot reading, horoscope generation, dream interpretation, angel number lookup, crystal healing, I-Ching readings). Authentication is simple X-API-Key header, no complex OAuth flows to reconfigure. Most migrations complete in a few hours since RoxyAPI covers 10+ intelligence domains under one API key, often replacing multiple separate provider integrations. For complex migrations, visit our contact page for guidance.

RoxyAPI requires geographic coordinates (latitude/longitude) for astrology calculations, but we intentionally don't provide geocoding services - keeping our platform lean and focused on data APIs in 2026. Use free geocoding solutions: 1) Nominatim (OpenStreetMap) - free, no API key needed for city search (https://nominatim.openstreetmap.org/search?q=London&format=json); 2) Browser Geolocation API - built into all browsers for current location (navigator.geolocation.getCurrentPosition()); 3) IP Geolocation - free tier services like ipapi.co or ipgeolocation.io for automatic location detection; 4) Mapbox Geocoding - 100,000 free requests/month for production apps. For typical implementations: use Nominatim for city search dropdowns, browser API for "use my location" buttons, and IP geolocation for default location. These solutions are more flexible, better maintained, and free compared to adding geocoding to RoxyAPI which would increase costs and complexity.

RoxyAPI enables building diverse spiritual and wellness applications in 2026: 1) Astrology apps (birth chart generators, daily horoscope platforms, compatibility checkers, transit notification services); 2) Dating apps (astrology-based matching like Struck/Pattern, compatibility analysis, relationship insights); 3) AI chatbots (Claude/OpenAI/Gemini powered astrology advisors, tarot reading bots, numerology coaches); 4) Therapy platforms (spiritual counseling tools, AI therapy assistants with astrological insights); 5) Meditation apps (guided sessions based on astrological timing, personalized practices); 6) Life coaching tools (career guidance using numerology, decision support via tarot); 7) E-commerce personalization (product recommendations based on zodiac signs); 8) Content generation (automated horoscope newsletters, social media astrology posts); 9) Gaming (astrology-themed games, personality-based character systems). Ideal for startups, indie developers, and enterprise spiritual wellness platforms.

Absolutely! RoxyAPI licenses permit commercial use and reselling of astrology, tarot, numerology, dream interpretation, angel numbers, crystals, and I-Ching services to end users in 2026. Build profitable businesses like: 1) Premium horoscope subscription services; 2) One-time tarot reading purchases; 3) Relationship compatibility reports for dating apps; 4) Birth chart generation services; 5) AI chatbot subscriptions with spiritual guidance; 6) Dream journal apps with AI interpretation; 7) I-Ching oracle apps. RoxyAPI pricing scales with your revenue. Start with the Starter plan for initial users, upgrade as your subscriber base grows. One subscription covers all 10+ intelligence domains, so your cost per user stays low as you add features across astrology, tarot, numerology, dreams, angel numbers, crystals, and I-Ching.

Building AI spiritual chatbots with RoxyAPI takes 4 steps in 2026: 1) Subscribe to RoxyAPI and get API key; 2) Configure MCP client (Claude Desktop/OpenAI/Cursor) with RoxyAPI MCP server URL and API key; 3) Create AI agent prompt template: "You are an expert astrologer and spiritual advisor. When users ask questions, use RoxyAPI tools to generate birth charts, draw tarot cards, calculate numerology, interpret dreams, look up angel numbers, explore crystal properties, or cast I-Ching readings. Provide interpretations in conversational, empathetic tone"; 4) Deploy chatbot interface (Telegram/WhatsApp/website widget) connected to AI agent. The AI automatically calls appropriate RoxyAPI endpoints based on user questions. Advanced features: memory for recurring users (remember birth details), follow-up questions (deeper analysis), multi-turn conversations (holistic guidance combining all 8+ domains). Example use cases: "What career path suits my life path number 7?" triggers numerology API, "I dreamed about flying" triggers dream interpretation API.

Yes! RoxyAPI is perfect for automated content generation in 2026. Create: 1) Daily zodiac Instagram posts (query horoscope API, generate graphics with Canva API, post via Instagram Graph API); 2) Personalized email newsletters (calculate transits for subscriber birth charts, send via SendGrid/Mailchimp); 3) Blog content (weekly horoscope articles, monthly astrology forecasts); 4) Social media bots (Twitter/TikTok astrology accounts with automated daily posts); 5) Marketing personalization (segment email lists by zodiac sign, customize landing pages based on visitor birthdate). Combine RoxyAPI with AI writing tools (ChatGPT API) for unique content variations. Example workflow: fetch daily horoscope → GPT-4 rewrites in brand voice → schedule social posts. Perfect for astrology influencers, spiritual coaches, wellness brands, and content marketers scaling personalized engagement.

Absolutely! RoxyAPI seamlessly integrates into existing wellness ecosystems in 2026. Therapy platforms can add spiritual dimensions: when clients discuss relationship issues, AI therapist queries RoxyAPI compatibility analysis for additional insights; during career counseling, numerology life path calculation informs guidance. Mental health chatbots (Woebot, Wysa) enhance conversations with personalized astrology - mood tracking correlates with lunar cycles, coping strategies align with planetary transits. Meditation apps (Calm, Headspace) offer zodiac-specific guided sessions, astrological timing recommendations for practices. Corporate wellness programs integrate daily horoscope delivery, team compatibility reports, stress management based on astrological cycles. Example: "I'm feeling anxious today" → chatbot checks today's planetary transits → provides context: "Mercury retrograde may affect communication, practice grounding techniques" + generates personalized tarot guidance card.

RoxyAPI is the intelligence layer powering the next generation of insight and prediction apps in 2026. Ship production-ready astrology, tarot, numerology, dream interpretation, angel numbers, crystals, and I-Ching applications in days instead of months. Unlike competitors who charge separately per domain, RoxyAPI gives you one subscription for 130+ endpoints across 10 intelligence domains with instant API key delivery. Native Model Context Protocol (MCP) integration enables seamless connections with OpenAI Agents, Claude Desktop, Gemini Agents, Cursor, Windsurf, and any MCP-compatible AI application - a capability no other insight infrastructure offers in 2026.

RoxyAPI is the only insight infrastructure that combines 10+ intelligence domains (astrology, tarot, numerology, dreams, angel numbers, crystals, I-Ching), instant activation, and native MCP support for AI agents in one subscription. While competitors charge separately per product with complex pricing, RoxyAPI provides 130+ endpoints across all domains with one API key. Our native MCP integration lets developers build AI-powered astrology chatbots, tarot readers, and spiritual AI apps with OpenAI, Claude, or Gemini in under 2 minutes. Production-ready with 99.9% uptime and enterprise-grade security.

RoxyAPI pioneered Model Context Protocol (MCP) integration for insight and prediction APIs in 2026, enabling AI agents to automatically discover and use astrology, tarot, numerology, dreams, angel numbers, crystals, and I-Ching endpoints without manual configuration. Developers building AI astrology chatbots with OpenAI, autonomous spiritual advisors with Gemini, or insight apps with Claude Desktop can integrate in under 2 minutes. No other insight or prediction API offers native MCP support with 130+ endpoints across 10 intelligence domains - making RoxyAPI the only AI-native insight infrastructure for builders in 2026.

Yes! One subscription gives you access to astrology, tarot, numerology, dreams, angel numbers, crystals, and I-Ching — 130+ endpoints across 10 intelligence domains with native MCP tools. You receive one API key instantly after payment that works across all domains. Unlike competitors who charge per product separately, RoxyAPI provides transparent monthly and yearly plans with clear request limits and no hidden fees. This saves developers time, money, and complexity when building multi-domain insight apps and AI agents in 2026.

Instantly! RoxyAPI provides the fastest activation in the industry - your API key is generated and displayed immediately after payment completion, typically within seconds. Unlike competitors with manual approval processes that can take hours or days, RoxyAPI enables instant activation for production use with access to 130+ endpoints across astrology, tarot, numerology, dreams, angel numbers, crystals, and I-Ching plus native MCP tools. Start making API requests within 60 seconds of subscribing. Ship your insight or prediction app this week, not this quarter.

Yes! RoxyAPI provides AI-friendly documentation specifically designed for AI coding assistants in 2026. Our /llms.txt and /llms-full.txt endpoints deliver structured documentation that Cursor, Windsurf, GitHub Copilot, and other AI-powered development tools can parse and understand. Combined with our native MCP integration, developers using AI assistants can generate astrology, tarot, and numerology app integration code faster and with fewer errors. Simply reference RoxyAPI documentation URLs in your AI assistant prompts for instant access to guides, code examples, and best practices for building insight and prediction apps across all 10 intelligence domains.

Absolutely! RoxyAPI is production-grade infrastructure built for developers shipping commercial astrology apps, tarot readers, numerology platforms, dream journal apps, angel number apps, crystal guides, I-Ching tools, and AI-powered spiritual assistants in 2026. We maintain 99.9% uptime SLA with monitoring, automatic failover, and redundant infrastructure. Unlike hobby projects or beta platforms, RoxyAPI provides production-ready reliability with comprehensive OpenAPI documentation, interactive API reference, usage tracking via response headers, native MCP integration for AI agents, and transparent pricing. Four plans from Starter to Enterprise scale with your application from prototype to production.

RoxyAPI offers transparent pricing tiers: Starter ($39/month - 5,000 requests), Professional ($149/month - 50,000 requests), Business ($349/month - 200,000 requests), and Enterprise ($699/month - 1M requests). All plans include access to every intelligence domain (astrology, tarot, numerology, dreams, angel numbers, crystals, I-Ching), instant API key delivery, 130+ endpoints with native MCP tools, comprehensive OpenAPI documentation, usage analytics dashboard, and email support. Save 17% with annual subscriptions. Unlike competitors who charge per product, RoxyAPI includes all 10+ domains in every plan. No hidden fees, no per-domain charges, no approval delays - just straightforward pricing that scales with your app.

Model Context Protocol (MCP) is an open standard developed by Anthropic that enables AI agents and applications to automatically discover, connect to, and use APIs without manual configuration. For developers building AI-powered insight and prediction apps in 2026, MCP eliminates weeks of integration work - instead of writing custom API clients, authentication flows, and error handling, AI agents can self-configure API connections in under 2 minutes. RoxyAPI is the first and only insight infrastructure with native MCP support, enabling seamless integration with OpenAI Agents, Claude Desktop, Gemini Agents, Cursor, Windsurf, and any MCP-compatible tool. Build AI astrology chatbots, tarot readers, and spiritual assistants 10x faster.

Integrating RoxyAPI with OpenAI Agents using MCP takes under 2 minutes. After subscribing to any RoxyAPI plan, add our MCP server URL and your API key to your OpenAI Agent configuration. OpenAI will automatically discover all available RoxyAPI endpoints (astrology birth charts, tarot readings, numerology calculations, dream interpretation, angel number meanings, crystal properties, I-Ching readings) and enable your agent to call them. No manual API documentation reading, no custom code writing, no authentication complexity. Build AI-powered astrology chatbots, tarot reading assistants, or spiritual wellness coaches that can generate birth charts, draw tarot cards, calculate life path numbers, interpret dreams, and cast I-Ching hexagrams through natural conversation.

Yes! RoxyAPI provides native MCP integration with Claude Desktop and Claude Projects in 2026. Configure Claude with our MCP server details and API key (displayed on your dashboard after subscription), and Claude will automatically access all RoxyAPI endpoints. Build conversational AI applications where users can ask Claude to generate their birth chart, draw tarot spreads, or calculate numerology compatibility - all powered by RoxyAPI's comprehensive data APIs. Claude can combine astrological insights with personality analysis, tarot interpretations with decision guidance, and numerology calculations with career advice. This seamless integration enables developers to create AI therapy chatbots, spiritual wellness assistants, and personalized guidance tools without writing API integration code.

Absolutely! RoxyAPI supports Google Gemini Agents through our MCP protocol implementation in 2026. Gemini can automatically discover and call RoxyAPI endpoints for astrology calculations, tarot card draws, and numerology analysis without manual API integration. Build multimodal AI applications where Gemini generates visual birth chart diagrams with astrological insights, creates illustrated tarot reading interfaces with card interpretations, or produces numerology reports with personalized guidance. Our MCP integration enables Gemini to seamlessly combine its natural language understanding and generation capabilities with RoxyAPI's accurate astrological calculations and spiritual data - perfect for creating AI-powered wellness apps, meditation guides, and life coaching chatbots.

Setting up RoxyAPI with Cursor or Windsurf using MCP takes 90 seconds. Add our MCP server configuration to your IDE settings with your API key from the RoxyAPI dashboard. Cursor and Windsurf can then automatically generate API integration code, suggest optimal endpoint usage, and write complete application features using RoxyAPI. Ask Cursor to "build an astrology compatibility checker using RoxyAPI" and watch it generate complete React components with proper error handling, TypeScript types, and beautiful UI - all using our APIs correctly. This AI-assisted development workflow, powered by MCP, reduces astrology/tarot/numerology app development time from weeks to hours.

RoxyAPI's MCP integration works with all major AI platforms supporting Model Context Protocol in 2026: OpenAI Agents, Claude Desktop, Gemini Agents, Cursor IDE, Windsurf IDE, Zed editor, and any custom application using the MCP SDK. AI agent frameworks like LangChain and CrewAI can also connect to RoxyAPI through MCP. This broad compatibility ensures developers can use RoxyAPI with their preferred AI development tools without vendor lock-in. As new MCP-compatible platforms emerge, RoxyAPI integration works automatically without code changes.

MCP tool calls count as regular API requests against your monthly subscription quota. However, MCP tool discovery and schema inspection (when AI agents explore available endpoints) do not consume request credits - only actual data-fetching calls (generating birth charts, drawing tarot cards, calculating numerology) count toward limits. This design ensures fair usage while enabling AI agents to efficiently explore RoxyAPI capabilities. Monitor your usage in real-time through our analytics dashboard with per-endpoint breakdowns. If approaching limits, upgrade plans instantly with immediate activation - no approval waiting, no downtime. Our transparent request counting and usage visualization help developers budget effectively for AI agent workloads.

Yes! RoxyAPI's MCP integration enables sophisticated multi-agent AI architectures in 2026. Build systems where specialized AI agents collaborate: an astrology agent generates birth charts, a tarot agent provides guidance through card spreads, a numerology agent calculates life path numbers, a dream interpretation agent analyzes symbolism, an angel numbers agent decodes repeating sequences, a crystals agent recommends healing stones, an I-Ching agent casts hexagram readings, and a synthesis agent combines insights into personalized wellness recommendations. Each agent can independently call RoxyAPI endpoints through MCP without custom API client code. Perfect for building AI therapy platforms, spiritual wellness apps, personalized life coaching chatbots, and comprehensive guidance systems. All 10+ intelligence domains are accessible through one API key with consistent rate limiting across all agent requests.

RoxyAPI MCP integration implements production-grade security in 2026. Your API key is stored locally in your MCP client configuration and transmitted only over HTTPS encryption. Authentication uses secure HMAC-based verification with rate limiting. MCP connections are isolated per developer account. For team environments, create separate API keys per developer with individual usage tracking. Unlike traditional API setups where keys might be exposed in source code or version control, MCP configuration keeps credentials secure in local environment files. Store keys in environment variables and never commit them to version control.

Absolutely! RoxyAPI provides comprehensive local development support for MCP integration. Configure your local Cursor, Windsurf, or Claude Desktop with our MCP server and test astrology calculations, tarot readings, numerology analysis, dream interpretation, angel numbers, crystals, and I-Ching readings in your development environment. Our interactive API reference at /api-reference enables testing individual endpoints with custom parameters and viewing formatted responses. Use the same API key for local development and production. This seamless dev-to-prod workflow accelerates AI application development and ensures your chatbots and agents work correctly before user deployment.

Yes! RoxyAPI maintains MCP protocol compatibility automatically in 2026. As Anthropic and the open-source community release new MCP versions with enhanced capabilities, we update our implementation with backward compatibility for existing integrations. Our engineering team monitors the MCP specification repository and implements updates within days of release. Developers receive automatic protocol upgrades without code changes or API key regeneration. This future-proof approach ensures your AI agents built with RoxyAPI continue working as MCP evolves, while gaining access to new protocol features like enhanced streaming, batch operations, and improved error handling. We also contribute to the MCP open-source community with data API-specific extensions.

While RoxyAPI is developer-focused, non-technical users can leverage applications built by developers using our MCP integration in 2026. For example, an astrology app developer creates a Claude-powered chatbot using RoxyAPI - end users simply chat with the bot to get birth chart analysis without knowing APIs exist. However, non-developers can also configure Claude Desktop or similar tools with RoxyAPI MCP integration by following our step-by-step setup guides (copy-paste configuration, no coding required). This enables spiritual practitioners, astrologers, tarot readers, and numerologists to use AI assistants enhanced with accurate calculations and interpretations from RoxyAPI without programming knowledge. Our goal: make AI-powered spiritual tools accessible to everyone.

RoxyAPI offers comprehensive astrology APIs covering both Western and Vedic systems in 2026. Western astrology endpoints include natal birth chart generation with house systems (Placidus, Koch, Whole Sign, Equal), planetary positions and aspects, zodiac sign interpretations (Sun/Moon/Rising), daily/weekly/monthly horoscopes, synastry compatibility analysis, composite charts, and transit calculations. Vedic astrology (Jyotish) APIs provide Rashi charts, Navamsa divisional charts, Vimshottari dasha period calculations, yoga combinations, Panchang (muhurta timing), dosha analysis, and KP astrology endpoints. All calculations are powered by Roxy Ephemeris, verified against NASA JPL Horizons, with JSON responses optimized for web and mobile applications. Perfect for building astrology apps, dating compatibility checkers, personalized horoscope platforms, and AI astrology chatbots.

RoxyAPI provides complete tarot API functionality with the full 78-card Rider-Waite deck in 2026. Our endpoints support single card draws, three-card spreads (past-present-future), Celtic Cross layouts (10 cards), love spreads, career guidance spreads, yes/no oracle readings, and custom multi-card readings. Each card response includes upright and reversed meanings, domain-specific interpretations (love, career, health, spiritual growth), image descriptions, symbolism, and contextual advice. The API includes seeded randomness for reproducible daily draws and spread position context. Ideal for building tarot reading apps, daily card websites, AI tarot assistants, and spiritual guidance platforms.

RoxyAPI numerology APIs use the Pythagorean system with comprehensive calculations in 2026. Our endpoints compute Life Path numbers, Expression/Destiny numbers, Soul Urge numbers, Personality numbers, Birthday numbers, and Personal Year cycles. Advanced features include name-to-number conversions (Pythagorean 1-9 and master numbers 11/22/33), compatibility analysis between life path combinations, karmic debt numbers (13/14/16/19), and karmic lesson detection. All responses include detailed numerological interpretations, personality insights, compatibility guidance, and life path recommendations. Perfect for building numerology calculator apps, name analysis tools, compatibility checkers, AI numerology chatbots, and personalized life path guidance platforms.

Yes! RoxyAPI generates fresh daily, weekly, and monthly horoscopes for all 12 zodiac signs (Aries, Taurus, Gemini, Cancer, Leo, Virgo, Libra, Scorpio, Sagittarius, Capricorn, Aquarius, Pisces) in 2026. Our horoscope APIs use real-time planetary transits computed by Roxy Ephemeris (verified against NASA JPL Horizons) to produce accurate astrological forecasts covering love and relationships, career and finance, health and wellness, and personal growth. Horoscopes are generated programmatically using Roxy Ephemeris calculations and astrological interpretation algorithms, not pre-written generic content. Responses include current planetary influences, upcoming significant transits, and personalized advice. Perfect for building horoscope websites, daily notification apps, email newsletters, and AI astrology chatbots that provide timely guidance.

Absolutely! RoxyAPI is ideal for building astrology dating apps and compatibility platforms in 2026. Our synastry compatibility endpoints analyze birth chart harmonies between two people, calculating aspect patterns (conjunctions, trines, squares, oppositions), composite charts, Venus-Mars connections for romantic attraction, Moon sign emotional compatibility, and overall relationship potential scores. Get detailed compatibility breakdowns for love, friendship, business partnerships, and family dynamics. APIs return percentage scores, narrative interpretations, challenge areas, and growth opportunities. Perfect for creating astrology-based dating apps like Struck or Pattern, relationship compatibility checkers, AI matchmaking chatbots, couples counseling tools, and friendship compatibility platforms. Combine with AI agents to provide real-time relationship advice through conversational interfaces.

Yes! RoxyAPI generates astronomically accurate birth charts using Roxy Ephemeris, verified against NASA JPL Horizons in 2026. Our natal chart endpoints calculate precise planetary positions (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, Chiron) with degrees, minutes, and zodiac signs. House systems supported include Placidus, Koch, Whole Sign, and Equal with exact house cusp calculations. Major and minor aspects (conjunction 0 degrees, sextile 60 degrees, square 90 degrees, trine 120 degrees, opposition 180 degrees) are computed with configurable orbs. Responses include sign rulers, planetary dignities (domicile, exaltation, detriment, fall), element/modality distributions, and aspect patterns. Perfect for building professional-grade astrology software, birth chart generators, and detailed natal analysis tools.

Absolutely! RoxyAPI with MCP integration enables building sophisticated AI astrology chatbots in 2026. Connect Claude, OpenAI, or Gemini to RoxyAPI, and users can ask natural questions like "What does my Moon in Scorpio mean?" or "Should I start a business this month based on my transits?" The AI agent automatically calls appropriate RoxyAPI endpoints (birth chart calculation, transit analysis, horoscope generation) and synthesizes personalized responses combining astrological data with conversational context. Build chatbots for spiritual wellness apps, therapy platforms, life coaching tools, daily guidance services, and meditation apps. Our MCP integration eliminates traditional chatbot limitations - instead of scripted responses, deliver real astrological calculations with AI-generated natural explanations. Perfect for Telegram bots, WhatsApp business accounts, website chat widgets, and voice assistants.

RoxyAPI returns clean, well-structured JSON responses optimized for modern web and mobile development in 2026. All endpoints return data directly (like Stripe and GitHub APIs) with no wrapper objects. Astrological data includes nested objects for planetary positions, house placements, aspect lists, and interpretations. Tarot responses contain card arrays with properties (name, arcana, position, meanings, image descriptions). Numerology endpoints return calculation objects with number values, meanings, compatibility scores. Dream interpretation, angel numbers, crystals, and I-Ching endpoints return structured symbolic analysis with interpretive text. Error responses use standard HTTP status codes (400 Bad Request, 401 Unauthorized, 429 Too Many Requests, 500 Server Error) with descriptive error messages. Perfect for React, Vue, Angular apps and mobile development with Swift/Kotlin.

RoxyAPI uses RESTful endpoints for individual calculations. For processing multiple birth charts, tarot readings, numerology calculations, dream interpretations, angel number lookups, crystal queries, or I-Ching readings, make parallel async requests using Promise.all() in JavaScript or equivalent in other languages. Our infrastructure handles concurrent requests efficiently with fast response times. For high-volume batch processing (1000+ calculations), visit our contact page for custom solutions. Batch endpoints and webhook support for event-driven architectures are on our roadmap. MCP integration enables AI agents to orchestrate multiple RoxyAPI calls seamlessly within agent workflows.

Yes! RoxyAPI supports extensive customization for professional astrologers and advanced developers in 2026. Western birth chart endpoints accept parameters for house system selection (Placidus, Koch, Whole Sign, Equal), tropical zodiac, and aspect orb configuration. Vedic astrology endpoints use the sidereal zodiac with Lahiri ayanamsa, Vimshottari dasha calculations, Navamsa divisional charts, and KP (Krishnamurti Paddhati) astrology with sub-sublord tables. Both systems calculate precise planetary positions including outer planets and Chiron. Advanced users can specify coordinates with timezone offsets for accurate house cusp calculations. These options enable building professional astrology software matching specific Western and Vedic astrological traditions.

Yes. RoxyAPI supports multi-language API responses in 8 languages in 2026: English (default), Turkish (tr), German (de), Spanish (es), Hindi (hi), Portuguese (pt), French (fr), and Russian (ru). Add `?lang=es` to any endpoint to receive fully localized data. Translations cover 7 API packages including tarot card meanings, crystal properties, dream symbol interpretations, I-Ching hexagram texts, angel number messages, numerology readings, and astrology interpretations.

No. RoxyAPI is designed so developers with zero domain expertise can ship production-ready astrology, tarot, numerology, and spiritual apps. Every calculation has been verified by domain practitioners against authoritative sources. You send birth data or a query, you get structured JSON back with every field documented and described. The API handles all the complex astronomy, Vedic mathematics, and domain logic internally. Vibe coders using Cursor, Replit, or Bolt can connect via MCP and have AI agents auto-discover all 110+ tools without understanding the underlying calculations. You focus on the user experience, Roxy handles the intelligence.

Yes! RoxyAPI offers free integration guidance for all active subscribers in 2026. If you are new to working with APIs or need help getting started, our team provides personalized setup guidance for your specific tech stack (React, Vue, Angular, Next.js, Python, PHP, Ruby, mobile, WordPress, and more). We help you understand the right endpoints for your use case, walk you through authentication setup, share code examples tailored to your project, and troubleshoot common integration questions. Simply visit our contact page with details about your project and what you are building, and our team will point you in the right direction. This is ideal for entrepreneurs, designers, and founders building astrology apps, tarot platforms, numerology tools, dream journals, angel number apps, crystal guides, or I-Ching applications who want expert guidance to get up and running quickly.

RoxyAPI provides developer support in 2026: 1) Email support via contact page with responsive turnaround for all plans, priority response for Business and Enterprise plans; 2) Interactive API reference with live testing, full OpenAPI spec, and FAQ; 3) AI-friendly documentation at /llms.txt and /llms-full.txt for Cursor, Windsurf, and other AI coding assistants; 4) 6 open source starter apps on GitHub. Enterprise customers get dedicated Slack channels with direct engineering access.

Common RoxyAPI errors and solutions in 2026: 1) **401 Unauthorized** - Check API key format (correct header: `X-API-Key: your_key` or query param `?api_key=your_key`), verify key not expired/revoked, ensure no extra whitespace in key string; 2) **429 Too Many Requests** - Monthly quota exceeded, check usage via X-RateLimit headers, upgrade plan or wait for reset (1st of month UTC); 3) **400 Bad Request** - Invalid request parameters, check required fields (birth date/time/location for astrology), validate JSON syntax; 4) **500 Server Error** - Rare infrastructure issue, retry with exponential backoff, visit contact page if persistent; 5) **CORS errors** - Browser blocking cross-origin requests, add backend proxy or use server-side integration. For persistent issues, visit our contact page with curl command and request/response details for fast diagnosis.

RoxyAPI monitors API health and availability continuously in 2026. Our infrastructure is built for production reliability with 99.9% uptime SLA on Professional plans and above. Monitor your own usage in real-time via the X-RateLimit response headers (X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Remaining) included in every API response. For service status inquiries or to report issues, visit our contact page. Our architecture uses redundant infrastructure with automatic failover to maintain consistent availability across all 10+ intelligence domains (astrology, tarot, numerology, dreams, angel numbers, crystals, and I-Ching).

RoxyAPI welcomes feature requests in 2026. Visit our contact page with your use case and we prioritize based on demand. Business and Enterprise customers get direct engineering feedback. We are actively expanding across all 10+ intelligence domains with new endpoints, additional house systems, deeper compatibility analysis, multi-language support, and expanded Vedic astrology features. Features ship regularly. Custom API development is available for Enterprise customers with specific calculation requirements.