Popular

Tarot Reading API

Launch a tarot reading app with 78-card authenticity. In days.

<50mslatency
99.9%uptime
10+endpoints

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.tarot.get(/* ... */)
SDK docs

Want to ship faster? Clone a free template and go from zero to production in 30 minutes.

Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.

Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.

GET /api/v2/tarot/cards/chariot
{
  "id": "chariot",
  "name": "The Chariot",
  "arcana": "major",
  "number": 7,
  "keywords": {
    "upright": [
      "willpower",
      "determination",
      "victory",
      "control",
      "focus"
    ],
    "reversed": [
      "lost direction",
      "opposition",
      "scattered will",
      "forcing outcomes"
    ]
  },
  "upright": {
    "keywords": [
      "willpower",
      "determination",
      "victory",
      "control",
      "focus"
    ],
    "description": "The Chariot is the card of directed will, the force that carries a resolve into the world. In the Rider-Waite-Smith image an erect and princely figure stands in a chariot beneath a canopy of stars, a drawn sword in hand, crescent moons on the shoulders and a square upon the breast. Two sphinxes, one black and one white, are harnessed before him, pulling toward opposing aims, and the charioteer holds them to a single course not by reins but by the strength of his command. Waite called him conquest on all planes, triumph above all in the mind, the one who has led captivity captive.\n\nIn a reading, The Chariot marks a time to take focused action and hold a chosen course. A decision has been made, often building on the values weighed under The Lovers, and now the work is to drive it forward with discipline and conviction. The card favours assertion over passivity, momentum over hesitation. Where there is a goal worth reaching, it promises success to the one who keeps focus and does not waver.\n\nIt also speaks of mastering opposing forces. The two sphinxes are the competing pulls within and around the charioteer, ambition against fear, one desire against another, and victory depends on holding them to one direction rather than letting them tear the course apart. Control here is inner before it is outer, the harnessing of one own divided energies toward a single aim.\n\nThe deeper instruction of The Chariot is that triumph is earned by will, not granted by circumstance. There will be obstacles and competing distractions, and the card asks for boundaries held firm and effort sustained past the point of ease. To know what is wanted, to drive toward it with discipline, and to keep command of oneself amid the pull of opposing forces, is the lesson and the victory.",
    "love": "Determination and clear intent move matters of the heart forward. For those pursuing a connection, confidence and a sense of direction draw success. Within a partnership, two people aligning their effort toward a shared aim deepens the bond. The card favours acting with purpose rather than waiting for circumstance to decide.",
    "career": "Forward momentum, achievement, and hard-won victory define the professional path now. Obstacles yield to sustained effort and disciplined focus, and recognition or advancement may follow. The card rewards the one who sets a clear target and drives toward it without losing command of the course along the way.",
    "finances": "Steady progress through discipline and focus is indicated. Control over the financial picture grows as effort is directed toward a defined goal rather than scattered. The card favours the determined, deliberate push toward security, and rewards the focus that holds a plan together against distraction.",
    "health": "Strong will supports the pursuit of health goals, and the determination is present to push through limitation and see a regimen through. Disciplined, focused effort serves well now, and active, demanding pursuits suit the energy. The card favours channelling drive toward a clear physical aim while keeping command of its intensity.",
    "spirituality": "The work now is to master the balance between spiritual and material drives, holding opposing pulls to a single direction. Discipline and focused will advance the practice. The card invites directing that inner force toward mastery of the ego rather than letting competing desires scatter the path."
  },
  "reversed": {
    "keywords": [
      "lost direction",
      "opposition",
      "scattered will",
      "forcing outcomes"
    ],
    "description": "Reversed, The Chariot describes a will that has lost its course. The drive may have drained away, leaving a project pushed forward out of habit rather than conviction, or the two sphinxes may have broken loose, pulling in opposite directions until forward motion stalls. Effort is being spent without traction. The card asks whether the goal still holds meaning, and whether the wiser move is to change direction rather than batter on against a wall.\n\nThe reversal can also mark obstacles that have begun to win, the sense that it has all become too hard and the resolve to continue has thinned. Here the remedy is to return to first reasons: why the aim was chosen, what it is worth, and whether the commitment will outlast the discomfort. Outside opinion and early setbacks test the course now, and the question is whether to be swayed by them or to hold.\n\nA subtler form of the reversal turns the energy inward before action. The work shifts to self-discipline, inner alignment, and the quiet preparation that readies a person to move well when the time comes. Equally, the card warns against the opposite fault: gripping every detail so tightly that control itself becomes the problem. To loosen the hold and let some things run their course is as much a part of mastery as the drive to command. The lesson is to direct the will, not force it.",
    "love": "Control issues, force, or a loss of direction are unsettling the romantic life. A bond may be pushed too hard, or a partner held away by a domineering grip. The reversal asks for the need to control outcomes to be released, and for honest reflection on whether the course still serves both people involved.",
    "career": "Direction has been lost, motivation has thinned, or obstacles feel insurmountable, and effort may be aimed at goals that no longer fit. The reversed card counsels a pause to reassess the professional course and rediscover the genuine drive beneath it, rather than forcing momentum that has gone hollow.",
    "finances": "Financial goals are stalling for want of focus or a sound plan, and aggressive moves risk backfiring. The reversal counsels slowing down, reassessing the strategy, and regaining real control before pressing forward again. Force applied without direction tends to cost more than patience would.",
    "health": "Burnout or strain from pushing the body too hard may be taking a toll, and frustration can be feeding the problem. The reversed card asks for drive to be balanced with rest, and for the wisdom to pull back rather than override the body signals in pursuit of a goal.",
    "spirituality": "Will is being used to force spiritual progress or to bypass the slower work of emotional healing. Growth of this kind cannot be driven into existence. The reversal asks for patience, surrender, and trust alongside discipline, letting the path unfold rather than commanding it forward."
  },
  "imageUrl": "https://roxyapi.com/img/tarot/major/chariot.jpg"
}

Structured JSON with documented fields. Not hallucinated text. See all 10+ endpoints

Works with your stack

Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK

Production-ready tarot card reading API + hosted MCP for AI agents and developers. Connect Claude Code, Cursor, VS Code in seconds, no local setup. Complete 78-card Rider-Waite-Smith deck with domain-specific interpretations for love, career, health, and spiritual growth. Celtic Cross, three-card, love, career, yes/no oracle, daily card, and custom spreads. Seeded reproducibility for personalized daily readings. Card images included. 10+ endpoints optimized for tarot apps, AI tarot chatbots, fortune-telling platforms, and spiritual wellness products.

Multi-language API responses

EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce

Key Features

Everything you need from our Tarot API, built for production:

Complete 78-card Rider-Waite-Smith deck: 22 Major Arcana + 56 Minor Arcana with upright and reversed meanings, domain interpretations (love, career, health, spiritual), and rich symbolism

Traditional spreads: Three-Card (past/present/future), Celtic Cross (10-card), Love (5-card relationship), Career (7-card SWOT), plus custom spread builder (1-10 positions)

Yes/No oracle readings with Major Arcana weighted answers (Yes, No, Maybe) and detailed reasoning for quick decision-making features in apps and chatbots

Daily tarot card with seeded reproducibility, date-based consistency for personalized daily readings, and share-friendly deterministic draws

High-quality Rider-Waite card images (345x480px JPEG) served via CDN with card descriptions, keywords, and imagery metadata for professional tarot app UIs

AI-optimized JSON responses with structured card data, spread positions, and contextual interpretations, perfect for MCP-powered tarot chatbots and LLM integration

Multi-language responses in 8 languages (EN, TR, DE, ES, HI, PT, FR, RU) via ?lang= query parameter

All 10+ Endpoints

Click any endpoint to view detailed documentation, parameters, and response examples.

List all 78 tarot cardsRetrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/:id for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.Get detailed tarot card informationRetrieve comprehensive details for a specific tarot card from the traditional Rider-Waite-Smith deck including complete upright meanings (card drawn normally) and reversed meanings (inverted/upside down interpretations for nuanced guidance). Each card provides keywords for quick reference, full interpretations (400+ words each for upright and reversed orientations), and guidance across life domains: love and relationships, career and professional growth, finances and material success, health and wellbeing, spirituality and personal development. Major Arcana cards (0-21) reveal deep spiritual lessons and life-changing themes. Minor Arcana cards (Ace through King in Cups, Wands, Swords, Pentacles) address practical daily situations and specific challenges. Use card ID in kebab-case format: Major Arcana like "fool", "magician", "death", "tower", or Minor Arcana like "ace-of-cups", "seven-of-wands", "queen-of-swords", "king-of-pentacles". Essential for detailed tarot study, reading interpretations, divination apps, fortune-telling platforms, spiritual guidance tools, and professional tarot learning applications.Draw random tarot cards with reproducible resultsDraw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings. Provide an optional seed string (like "user123-2025-12-27" or "readingId") to ensure the same seed always returns identical cards in the exact same order - essential for daily tarot features, personalized user experiences, shareable readings, or reproducible testing. Omit seed for true random draws each time. Control card reversals (upright vs reversed/inverted orientations - reversed cards provide alternative meanings when drawn upside down) and duplicates (traditional deck draws each of 78 cards once, or oracle-style allows repeating same card). Each drawn card includes position number, reversal state (boolean), keywords for quick interpretation, full meaning text (400+ words), authentic Rider-Waite imagery, and card metadata. Perfect for custom spread builders, random card generators, automated tarot reading platforms, daily card features, meditation apps, journaling prompts, divination tools, and any application requiring reproducible or random tarot draws from the industry-standard 78-card deck (22 Major Arcana spiritual lessons + 56 Minor Arcana practical guidance across 4 suits).Get daily tarot card readingReceive a single tarot card for daily guidance and reflection. This endpoint uses seeded randomness to ensure the same seed gets the same card on the same day - perfect for "Card of the Day" features. Provide a seed (userId, email hash, session token) for reproducible consistency, or omit for anonymous daily draws. Returns card with keywords, full meaning, and a daily message summary. Great for tarot apps, wellness platforms, morning ritual apps, and journaling tools.Get yes/no answer to your questionAsk a specific question and receive a yes, no, or maybe answer based on a single tarot card draw. Upright cards indicate "Yes" with positive energy, reversed cards indicate "No" with caution, and certain inherently ambiguous cards (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) return "Maybe" regardless of orientation since their energy signals pause, reflection, or shifting circumstances. Major Arcana cards give strong definitive answers, Minor Arcana cards give qualified nuanced answers. Returns the answer, strength level, drawn card details, and a contextual interpretation explaining why. Perfect for decision-making apps, quick guidance tools, fortune-telling chatbots, and interactive tarot experiences. Optionally provide a seed for reproducible answers.Three-Card Spread: Past, Present, FuturePerform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues). The most popular beginner-friendly spread, perfect for quick insights, daily guidance, or exploring specific questions. Each position includes a drawn card with reversal state, keywords, full meaning, and position-specific interpretation. Returns a summary connecting all three cards. Ideal for tarot reading apps, decision-making tools, and personal growth platforms. Optionally provide a seed for reproducible readings.Celtic Cross Spread (10 cards)Perform the legendary Celtic Cross spread - the most comprehensive and detailed tarot reading available, used by professional tarot readers worldwide for over a century. This 10-card layout reveals the complete picture of any situation through distinct positions: Present Situation (what is happening now), Challenge (obstacles crossing your path), Distant Past (root causes), Recent Past (recent influences), Best Outcome (potential positive result), Near Future (what is approaching in weeks ahead), Your Approach (your attitude and self-perception), External Influences (environment and other people impact), Hopes and Fears (your desires and anxieties), and Final Outcome (where everything is headed). Perfect for life-changing decisions, complex relationship questions, career transitions, spiritual guidance, and deep self-discovery. Ideal for professional tarot apps, life coaching platforms, spiritual wellness websites, and divination tools requiring authoritative comprehensive readings. Each card position provides layered insight combining traditional tarot wisdom with modern psychological interpretation for actionable guidance.Love Spread (5 cards)Perform a specialized 5-card relationship tarot spread analyzing romantic connections, emotional dynamics, and partnership potential. This love-focused reading examines five crucial relationship aspects: You (your current emotional state, needs, and what you bring to the relationship), Partner/Other (their emotional perspective, desires, and energy), Relationship Dynamic (the current energy and connection between you both), Challenge (obstacles needing attention, healing, or communication), and Outcome (where this romantic connection is naturally heading). Perfect for dating apps, relationship counseling platforms, matchmaking services, wellness apps, and romantic guidance tools. Provides deep insight into new relationships, existing partnerships, potential connections, breakup recovery, or self-love journeys. Ideal for understanding compatibility, resolving conflicts, strengthening bonds, or deciding whether to pursue or continue a relationship. Each position reveals emotional truths combining traditional tarot relationship wisdom with modern relationship psychology. Use for individual readings or couples readings to gain perspective on romantic situations from singleness to marriage.Career Spread (7 cards)Perform a comprehensive 7-card career tarot spread using SWOT analysis framework (Strengths, Weaknesses, Opportunities, Threats) for professional guidance, business decisions, and vocational clarity. This career-focused reading examines seven strategic business aspects: Current Situation (your present professional position and workplace energy), Strengths (your professional assets, talents, and competitive advantages), Weaknesses (areas needing development, skill gaps, or limiting beliefs), Opportunities (potential growth paths, new ventures, or doors opening), Threats (obstacles, competition, or external challenges), Advice (actionable guidance for navigating your career path), and Outcome (where your professional journey is heading if you follow the guidance). Perfect for career coaching platforms, professional development apps, business consulting tools, job search websites, entrepreneurship platforms, and executive coaching services. Use for career transitions, job offers evaluation, promotion decisions, starting a business, workplace conflicts, finding your calling, or strategic career planning. Combines traditional tarot wisdom with modern SWOT business analysis for practical professional insight. Ideal for employees, entrepreneurs, freelancers, career changers, and anyone seeking vocational direction.Custom Spread BuilderBuild and perform your own custom tarot spread with personalized positions and interpretations (1-10 cards). This flexible endpoint lets you create unique spread layouts for any purpose - define your own position names, meanings, and card count to match your specific needs or therapeutic framework. Perfect for therapists using tarot in counseling, coaches creating signature spreads, app developers building custom reading features, spiritual practitioners with proprietary methods, or anyone wanting to design specialized layouts beyond traditional spreads. Create spreads for specific themes like chakra readings (7 cards), lunar phases (8 cards), elements (4 cards), goals setting (any count), shadow work, inner child healing, decision matrices, or creative problem-solving. Each position requires a name and interpretation - you define what each card position represents in your reading. The API draws the exact number of cards you specify and maps them to your custom positions. No pre-generated summary provided - you interpret the reading based on your framework. Ideal for innovative tarot apps, therapeutic tools, personal development platforms, spiritual coaching services, or experimental divination methods. Maximum 10 positions to maintain reading clarity and practical interpretation time.

Free Templates for Tarot

Clone. Edit. Ship. Free and open source by Team Roxy.

AI astrology chatbot template with MCP integration, horoscope, tarot, numerology, birth chart, and Vedic astrology powered by RoxyAPI

AI Astrology Chatbot

Web App / Open Source30 min

AI chatbot with real readings across all spiritual domains. Not hallucinations.

AstrologyVedicTarotNumerologyCrystalsDreamsI-ChingAngel Numbers
AI spiritual voice assistant template with embeddable voice widget for astrology, tarot, numerology, and Vedic readings powered by RoxyAPI

AI Spiritual Voice Assistant

Web App / Open Source30 min

Talk to the stars. Real readings across every spiritual domain, spoken aloud.

VoiceAstrologyVedicTarotNumerologyHuman Design
Tarot card reading template with Celtic Cross spread, three-card reading, daily tarot pull, and yes or no oracle for iOS and Android

Tarot Card Reading App

Mobile App / Open Source30 min

Full 78-card Rider-Waite deck. Every spread. Every position.

TarotCeltic CrossYes/No Oracle

Browse all templates or use AI prompts to generate a custom app.

What You Can Build with Tarot API

Real-world applications and use cases for integrating Tarot API into your projects:

Build tarot reading apps with authentic Rider-Waite-Smith interpretations: upright and reversed meanings for all 78 cards with domain-specific guidance for love, career, health, and spiritual growth

Add daily tarot features to wellness and self-discovery platforms: date-based seeded draws ensure consistent personalized cards each day with shareable results

Build AI tarot chatbots with MCP: your OpenAI, Claude, or Gemini agent auto-discovers tarot endpoints and delivers conversational readings with zero integration code

Power career and life coaching platforms with Celtic Cross (10-card), SWOT career spreads, and yes/no oracle readings for decision-making and guidance features

Create relationship and dating app features with love spreads analyzing emotional dynamics, compatibility, challenges, and partnership potential

Ship fortune-telling and divination platforms combining tarot with astrology, numerology, dreams, and I-Ching for comprehensive spiritual guidance under one API key

What developers are saying

DM

Dhani M.

Indie App Developer

Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.

Email feedback
TH

Tom H.

Senior Developer

The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.

Email feedback
CW

Chris W.

Backend Engineer

Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.

Email feedback

Do not take our word for it. Ask the agents.

Every page here is built so AI search engines can read and cite it, so go straight to the source. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.

Opens a live web search in a new tab.

Getting started with Tarot API.

From zero to production in 3 steps. No signup required for testing.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.

  • Remote MCP server — 10+ tools auto-discovered by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
  • AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.

Tarot API FAQ

How do I add tarot readings to my app?

Ship a complete reading experience without building a deck or writing card meanings yourself. The tarot API draws from the full 78-card Rider-Waite-Smith deck and returns the drawn cards with their upright or reversed meanings, life-area guidance, keywords, and card imagery, ready to render. Activation is instant, and the same key unlocks all 12 RoxyAPI domains, so you can layer astrology, numerology, or dreams alongside tarot under one flat subscription. Reach for it through the typed SDKs for TypeScript, Python, and PHP, our drop-in UI components, the WordPress plugin, or our Remote MCP server.

Which tarot spreads can I generate?

Every spread your readers expect comes ready to use: three-card for past, present, and future, the ten-card Celtic Cross, a love spread for relationship dynamics, and a career spread. Each spread returns its cards already placed and interpreted position by position, plus an overall reading. When you need something proprietary, the custom spread builder lets you define your own positions from one to ten, so coaches and practitioners can offer signature layouts no other app has.

How does the Celtic Cross reading work?

The Celtic Cross is the full ten-position professional reading, delivered in a single call. You get a drawn card for every position from the present situation and the challenge through hopes and fears to the final outcome, each with its own interpretation, plus a summary that ties the whole spread together. Pass a question to focus the reading and an optional seed to make a given reading reproducible, ideal for shareable results or saved sessions. It is available through the typed SDKs and our Remote MCP server, so an AI agent can deliver a complete Celtic Cross in conversation with no local setup.

How do I add a daily tarot card?

Daily tarot is the feature that brings people back, and you can ship it without storing any reading data. Tie each draw to a date and an identifier such as a user id, and every reader sees one consistent card for the day, every time they open the app. The card arrives with its upright or reversed meaning, keywords, imagery, and a message written for the day. Translations are available in 8 languages, currently AI generated and under editorial review, so a global audience reads in their own tongue from day one.

Is there a yes or no tarot answer?

Yes. Ask a question and get a clear Yes, No, or Maybe with a strength rating and the card behind the answer, perfect for a quick decision feature or a playful chatbot reply. The reading follows traditional practice: upright cards lean toward yes, reversed toward no, and a few naturally ambiguous cards resolve to maybe. Add an optional seed when you want the same question to return a stable answer. It is one of the fastest features to ship, and through our Remote MCP server an AI assistant can answer in plain conversation.

Does it include reversed and upright meanings?

Every one of the 78 cards carries distinct upright and reversed interpretations, written editorially so a reversal shifts the message rather than simply negating it. Each meaning extends across five life areas: love, career, finances, health, and spirituality, giving your readings real depth instead of a single line. You control whether reversals appear, and each card tells you its orientation so you render the right artwork and text. The same editorial quality flows through the typed SDKs, our UI components, and our Remote MCP server.

Start using Tarot API today.

Launch a tarot reading app with 78-card authenticity. In days.

All 12 domains included with every plan. 10+ endpoints, MCP server, SDK, and starters.

Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.

View Pricing & Get API Key