Skip to content
RoxyAPI
Get API Key

Tarot API

Tarot readings a user can share and reopen unchanged, every card read upright and reversed for love, career and health.

Daily Tarot Card · Tarot Card Draw · Three Card Spread · Celtic Cross · Yes or No Tarot · Tarot Love Spread · Tarot Card Meanings · Tarot Career Spread · Custom Tarot Spread and 1 more

What the Tarot Reading API covers.

Spreads

  • Celtic Cross read position by position

  • Past, present and future three-card spread

  • Love spread for you, your partner and the bond

  • Career spread on a SWOT frame

Card meanings

  • Full Rider-Waite-Smith deck

  • Upright and reversed meanings for every card

  • Love, career, finances, health and spirituality

  • Card imagery and keywords, filtered by arcana or suit

Daily and quick readings

  • Card of the day with a daily message

  • Yes, No or Maybe with a strength rating

  • Custom spreads with your own positions

  • Readings that reopen unchanged when shared

Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and spiritual growth. Celtic Cross, three-card, love, career, yes/no oracle, daily card, and custom spreads, each with upright and reversed interpretations. Daily cards that stay the same for one user all day, shareable readings that reopen unchanged, and card images included. Built for tarot apps, AI tarot chatbots, fortune-telling platforms, and spiritual wellness products. One key covers every RoxyAPI domain, with Remote MCP and typed SDKs.

Every Tarot response is covered by 13,957 automated tests per deploy, checked against the Rider-Waite-Smith canonical deck. See how we test.

Interpretations in English, Deutsch, Español, Français, हिन्दी, Português, Русский, Türkçe, one query parameter away.

Start your way. No code, agents or code.

No-code builders

Paste a widget into any site builder, install the WordPress plugin, or start from an MIT template you can white-label. Results render from the Tarot Reading API with no backend.

AI agents

A Remote MCP server exposes every endpoint as a tool for Claude, ChatGPT, Cursor and any MCP client, with no local install. Opt-in compact responses cut the tokens your agent reads by roughly 40 to 52 percent, and one call stays one request.

Developers

Typed SDKs for TypeScript, Python, PHP, C#, Go, and Rust, generated from the live spec, each with an AGENTS.md so your coding assistant calls the Tarot Reading API correctly.

No-code widgets and drop-in UI components.

This is what your visitors see. Paste one snippet into Wix, Squarespace, or WordPress and the Tarot Reading API reading appears on your site, with no code and no backend. Developers install the same components from npm for Next.js, React, Vue, Svelte, Angular, or plain HTML. MIT licensed and included in every plan.

Show all Tarot Reading UI componentsShow fewer Tarot Reading UI components
ElementRenders
<roxy-tarot-card>Single card with upright and reversed flip
<roxy-tarot-catalog>Deck gallery tiles with card art, name, and arcana and suit; a pick opens the card in place
<roxy-tarot-spread>Spreads with positions and reading

Component preview

The real component, running on sample data.

Loading the component...

Tarot Reading API features, in detail.

The depth behind every line above, written out in full.

  • 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 that stays the same for one user all day, and readings that reopen unchanged when shared or saved
  • High-quality Rider-Waite card images (345x480px JPEG) with card descriptions, keywords, and imagery metadata for professional tarot app UIs

Start building with one key.

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

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

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const domain = roxy.tarot
SDK docs

Generating your own client? Get the Tarot OpenAPI schema.

Want to ship faster? Clone a free template and white-label it as your own app.

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

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

POST /api/v2/tarot/spreads/celtic-cross
{
  "spread": "Celtic Cross",
  "question": "What should I know about this situation?",
  "seed": "reading-2f9c1a",
  "positions": [
    {
      "position": 1,
      "name": "Present Situation",
      "interpretation": "Represents what is happening to you at the present time. Reflects your state of mind and how you may be perceiving the situation. This is the heart of the matter, central to your life right now.",
      "card": {
        "id": "eight-of-wands",
        "name": "Eight of Wands",
        "arcana": "minor",
        "suit": "wands",
        "number": 8,
        "position": 1,
        "reversed": false,
        "keywords": [
          "swift movement",
          "momentum",
          "rapid news",
          "air travel",
          "aligned action"
        ],
        "meaning": "The Eight of Wands is the one pip in the suit of Wands with no human figure in it. In the Rider-Waite-Smith image, eight leafed wands fly in parallel through clear open sky above a green country with a river and a distant house, angled downward as though nearing the end of a long flight. Waite called the card motion through the immovable, a flight of wands drawing to the term of their course, and read it as activity, swiftness like that of an express messenger, great haste, and speed toward an end that promises assured felicity. He also named the wands the arrows of love.\n\nIn a reading, the Eight of Wands marks the moment when obstruction clears and everything begins to move at once. The struggle and standoff of the Seven of Wands resolve, the path opens, and events accelerate. Messages arrive, plans advance, and progress that had stalled now travels fast. This is rapid, directed energy rather than chaos: the wands fly in formation, all pointing the same way, which is the card asking for resources and attention to be aligned on a single aim so the momentum is not wasted.\n\nThe instruction is to move with the current rather than against it. The window is open now and will not stay open indefinitely, so this favours acting while the energy is high, answering the message, taking the trip, committing to the project that has suddenly gained speed. Because the wands are about to land, the card also signals that something long anticipated is at hand and may already be on the threshold.\n\nThe Eight of Wands often points to literal travel, particularly air travel or a short, fast-paced trip taken for business or pleasure. More broadly it favours communication that crosses distance, quick decisions made on sound footing, and the satisfaction of seeing effort convert into visible motion. Strike while the conditions hold, keep the aim singular, and let the speed carry the work to its conclusion.",
        "love": "A relationship moves quickly, with messages, attraction, and developments arriving in rapid succession. The card favours romance that crosses distance, travel to meet a partner, or a sudden warming after a stalled stretch. Waite named these wands the arrows of love. Enjoy the pace, but let depth and understanding keep step with the speed so the connection has substance once the rush settles.",
        "career": "Work accelerates as obstacles clear and projects that were stuck begin to move. Communication speeds up, opportunities arrive in quick succession, and progress becomes visible. The card favours decisive action while conditions hold rather than waiting for a calmer moment that may not come. Keep effort aligned on the central goal so the momentum converts into finished results rather than scattered activity.",
        "finances": "Money and financial matters move at speed: payments clear, transactions complete, and returns arrive faster than expected. The card favours acting promptly and deliberately on a developing opportunity while the momentum is fresh. Direct the energy toward one clear aim rather than several at once, and let the swift movement work in favour of resources rather than rushing decisions that warrant more care.",
        "health": "Vitality returns quickly and the body responds well to treatment or a change in routine. The Eight of Wands favours a rapid improvement after a flat or stalled stretch, energy rising and recovery gathering pace. Channel the surge into active movement while it is strong, but pace the effort so the gains hold rather than burning the new vigour out in a single push.",
        "spirituality": "Spiritual insight arrives swiftly, with sudden clarity, synchronicities, and a sense of momentum on the path. The card favours acting on genuine intuition while the energy is alive rather than deliberating it into stillness. Stay receptive to what is moving toward you, and trust the impulses that arrive aligned and clear. Direct the quickened energy into practice so the insight grounds into something lasting.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/eight-of-wands.jpg"
      }
    },
    {
      "position": 2,
      "name": "Challenge",
      "interpretation": "The immediate challenge or problem facing you. This is the one thing that, if resolved, would make life easier. Even positive cards here represent a challenge requiring attention and action.",
      "card": {
        "id": "four-of-swords",
        "name": "Four of Swords",
        "arcana": "minor",
        "suit": "swords",
        "number": 4,
        "position": 2,
        "reversed": true,
        "keywords": [
          "exhaustion",
          "burnout",
          "restlessness",
          "avoided rest"
        ],
        "meaning": "Reversed, the Four of Swords sounds an urgent call for the rest that is being refused. The reserves are running low, perhaps already on empty, drained by long hours, by carrying others, or by a demanding and stressful undertaking that has gone on too long. The reversal warns that continuing to push leads to collapse, the burnout that renders a person ineffective and unable to help anyone, least of all themselves. The rest the upright card recommends has become not optional but necessary.\n\nOften the body asks for stillness while the mind refuses to grant it. There is a restlessness, a drive to do everything at once, that overrides the signals of fatigue and pushes through a long list of tasks until wellbeing pays the price. The remedy is plain and difficult: stop. Withdraw from the clamour, take the retreat, the quiet weekend, the daily pause for the mind to settle, and let the reserves refill before they are gone entirely.\n\nThe reversal can also mark a stagnation that masquerades as recovery, time spent withdrawn that has stopped restoring and started to stall. Where rest has tipped into avoidance, the counsel is to re-emerge gently, integrating the calm solitude has given rather than hiding within it. Even a brief, genuine pause re-balances the energy, but the pause must be real. Force the rest the situation has refused, and let recovery, not endurance, become the priority.",
        "love": "Exhaustion is straining matters of the heart, or a needed pause from romance is being refused. The reversed Four of Swords warns that pushing on while depleted leaves nothing to give a partner or a new connection. Step back and restore yourself before re-entering the world of love. Re-engage slowly once rested, rather than forcing closeness from an empty reserve.",
        "career": "Burnout looms, and the rest the work demands is being avoided. The reversed Four of Swords warns that long hours and unrelenting pressure are draining you toward collapse. A restless drive to do everything at once overrides the clear need to stop. Force the break now, withdraw from the noise, and refill the reserves before exhaustion makes you ineffective at the work entirely.",
        "finances": "Depletion is clouding financial judgement, or a needed pause from money pressure is being denied. The reversed Four of Swords cautions against acting while exhausted, when restlessness pushes for decisions the situation does not require. Step back, let the picture settle, and resist forcing financial moves from a drained state. Recovery first, then clear-headed action, protects resources better than strained effort.",
        "health": "Exhaustion has reached a point that demands attention, and rest is being refused at real cost. The reversed Four of Swords warns that ignoring the body signals leads to collapse. Restlessness drives activity that fatigue cannot sustain. Stop, withdraw, and let genuine recovery take priority over the long list of tasks, before depletion forces a far longer and harder convalescence.",
        "spirituality": "Spiritual reserves are running dry, or a withdrawal has stalled into stagnation. The reversed Four of Swords warns against pushing the mind onward when it plainly needs stillness, and equally against hiding in solitude past its restorative point. Take the real retreat the situation requires, quiet the restless drive, and let calm re-gather before re-emerging into active practice with renewed clarity.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/four-of-swords.jpg"
      }
    },
    {
      "position": 3,
      "name": "Distant Past",
      "interpretation": "The events that have led up to the present situation. Provides indication of how the challenge came about and what foundation was laid. This is where time begins on the horizontal axis of the spread.",
      "card": {
        "id": "lovers",
        "name": "The Lovers",
        "arcana": "major",
        "number": 6,
        "position": 3,
        "reversed": true,
        "keywords": [
          "disharmony",
          "misaligned values",
          "difficult choice",
          "self-love"
        ],
        "meaning": "Reversed, The Lovers points to a loss of harmony, most often within close relationships. Communication grows difficult, partners feel out of step, and it may seem that shared values no longer hold. The card asks for a return to the reason the bond exists. Where love is genuine, the discord is usually a passing storm best met with patience and compassion. In other cases it reveals that two people have simply grown apart, and that an honest, respectful parting is the kinder course.\n\nThe reversal can also describe feeling that is not mutual, one person more invested than the other, a gap that breeds insecurity, or a reluctance to open the heart at all for fear of being hurt.\n\nOn another level, the reversed card turns toward self-love and self-respect: how fully one honours ones own worth and accepts ones own nature, rather than admiring in others the very qualities one overlooks within.\n\nThe Lovers reversed frequently marks a choice mishandled, a decision of real consequence met with the temptation to cut corners or decide from fear and outside pressure rather than from genuine values. The card urges the opposite: choose the path most in keeping with what is true, however demanding it proves. It can also signify inner conflict, a person at war with themselves rather than any external force. The way through is to articulate ones own values clearly and let that clarity guide better choices in time.",
        "love": "Disharmony, temptation, or values that no longer align are creating strain in a relationship, and a difficult choice in matters of the heart may be unavoidable. Avoidance only widens the distance. The reversed card calls for honest communication and a willingness to face what is misaligned, whether that means repair or a respectful release.",
        "career": "A conflict between personal values and the demands of the work is breeding dissatisfaction, or a choice between competing opportunities is pressing. The reversal warns against deciding from external pressure rather than genuine conviction. Reconnect with what you actually stand for, and let that, not expedience or fear, settle the direction.",
        "finances": "Money choices made from fear or out of step with ones values tend to backfire, and partnerships where aims do not truly align can lead to disputes. The reversed Lovers counsels reassessing what genuinely matters before committing resources, and ensuring that any shared financial venture rests on real agreement rather than convenience.",
        "health": "Inner conflict or emotional turmoil may be surfacing as physical symptoms, and there may be a gap between what is known to be healthy and what is actually practised. The card asks for attention to that disconnection: aligning daily choices with genuine wellbeing, and addressing the emotional roots rather than only the symptoms.",
        "spirituality": "A crisis of faith or a sense of disconnection from ones core values may be present, with belief and action out of step. The resulting inner conflict is the signal. The reversed Lovers invites a return to what feels authentically true, the patient work of clarifying values so that inner and outer life can come back into accord.",
        "imageUrl": "https://roxyapi.com/img/tarot/major/lovers.jpg"
      }
    },
    {
      "position": 4,
      "name": "Near Future",
      "interpretation": "What is likely to occur within the next few weeks or months. This is not the final outcome, simply the next step on the journey. Shows how time moves forward on the horizontal axis of the spread.",
      "card": {
        "id": "hermit",
        "name": "The Hermit",
        "arcana": "major",
        "number": 9,
        "position": 4,
        "reversed": false,
        "keywords": [
          "introspection",
          "solitude",
          "inner guidance",
          "soul-searching",
          "wisdom"
        ],
        "meaning": "The Hermit is the seeker who turns from the world to find the light within. In the Rider-Waite-Smith image a robed elder stands alone on a high and snowbound peak, a lantern raised in one hand and a staff steadying him in the other. Within the lantern shines a single star, and Waite read the figure as one who blends the Ancient of Days with the Light of the World, holding his beacon aloft to say that where he stands, others may also come. He named it a card of attainment, the light of inner wisdom carried to a height from which it can guide.\n\nIn a reading, The Hermit marks a deliberate withdrawal from the noise of daily life to seek answers within. The truth being sought lies not in the crowd or the distraction of the outside world but in the quiet of one own depths. The card favours retreat, reflection, and the kind of solitude in which a person can hear themselves clearly. A pilgrimage, a retreat, or simply a season of stepping back all belong to its domain.\n\nIt is also the lantern that lights only the next step. The Hermit does not see the whole road, but enough to know where to place a foot, and the card counsels patience with that gradual unfolding. Clarity comes one stage at a time, through contemplation rather than haste, and the path reveals itself in the walking.\n\nThe Hermit can also appear as the wise guide, the mentor whose gift is not to hand over answers but to teach the seeker how to find their own. The deeper instruction is that the most reliable counsel is the inner one, reached by turning down the volume of the world. To withdraw with purpose, to listen inward, and to carry whatever light is found back to where it can serve, is the journey this card describes.",
        "love": "A season of reflection serves the heart now. Within a relationship, space to consider what is genuinely needed can clarify more than constant closeness would. For those who are single, time spent alone is not absence but preparation, the inner clarity that readies a person for a more honest and meaningful connection when it comes.",
        "career": "Independent work, research, or focused craft defines the path now, and withdrawing from the noise of collaboration to go deep yields the real results. The card also points toward the role of guide or mentor. Progress here comes through concentrated solitude and the patient mastery that quiet, uninterrupted effort allows.",
        "finances": "Careful, considered planning is the wise course, with reflection favoured over action. The card counsels stepping back to study the financial picture, avoiding showy ventures, and building quietly and steadily. This is a time to think before committing, letting clarity form before resources are moved.",
        "health": "Solitude and rest are restorative now. Stepping back from the overstimulation of daily life to attend to inner wellbeing benefits both body and mind. Meditation, quiet walks, and unhurried reflection support recovery. The card favours retreat and replenishment over pushing through, and listening to what stillness reveals.",
        "spirituality": "Deep introspection defines this season of the path. Withdrawing from the clamour of the world and turning inward, the seeker reaches the wisdom that only quiet makes audible. Meditation and contemplation are the most powerful tools now, and the lantern of inner knowing is the surest guide through the dark.",
        "imageUrl": "https://roxyapi.com/img/tarot/major/hermit.jpg"
      }
    },
    {
      "position": 5,
      "name": "Above",
      "interpretation": "Your goal, aspiration, or best outcome regarding the situation. What you are consciously working towards as you attempt to resolve the issue. Represents the conscious mind at the top of the vertical axis.",
      "card": {
        "id": "judgement",
        "name": "Judgement",
        "arcana": "major",
        "number": 20,
        "position": 5,
        "reversed": false,
        "keywords": [
          "rebirth",
          "inner calling",
          "reckoning",
          "absolution",
          "awakening"
        ],
        "meaning": "Judgement draws on the Christian imagery of resurrection. In the Rider-Waite-Smith image, a great angel encircled by clouds sounds a trumpet from which a cross-marked banner hangs, and below, the dead rise from their tombs, a man, a woman, and a child among them, arms lifted in wonder and welcome. Snow-capped mountains stand behind, a note of finality. Waite read the card as the accomplishment of the great work of transformation in answer to the summons of the higher, a summons heard and answered from within. The trumpet sounds without; the response rises from inside the one who hears it.\n\nIn a reading, Judgement calls a person to rise to a higher level of awareness and step into a truer version of themselves. It often signals an awakening, a sense of being destined for more, the old self released so a renewed one can emerge. The call is felt inwardly and asks to be acted on; the work is to tune to it and answer rather than turn away.\n\nThe card frequently marks a major life decision, but one made differently from the cool logic of Justice. Here intuition and intellect work together, and the choice arrives at a crossroads where any direction will bring lasting change. Past experience and learned lessons become the guide, and trust in your own deeper judgement is what points the way.\n\nJudgement is also a card of reckoning and absolution. A long process of review is reaching its close, the pieces of a life finally coming together into a coherent whole. Old wounds heal as the past is understood and integrated, and what remains is release: regrets cleared, guilt and sorrow set down, a person made clean and ready for what comes next. There is often a communal dimension, comfort and guidance found among others who have passed through something similar. Read upright, Judgement is rebirth: the summons heard, the past absolved, and a new chapter begun from a higher place.",
        "love": "A powerful awakening or reckoning calls for honest self-evaluation in love. Past patterns are being reviewed, old wounds are surfacing to be healed, and a higher, truer way of relating is emerging. Forgiveness, of self and of others, clears the ground for a genuine fresh start. Answer the deeper call the relationship is sounding rather than repeating what has run its course.",
        "career": "A significant calling or reckoning is at hand in your working life. You are being summoned toward your true professional purpose, with past decisions evaluated and their lessons absorbed. A transformative new chapter is beginning. Tune in to what genuinely calls you, settle accounts with what came before, and step into the renewed direction with conviction.",
        "finances": "A financial reckoning is underway, a candid review of past decisions and their results. Debts may be settled, prior choices weighed, and a clearer call to manage money with greater purpose and accountability is heard. The card favours making peace with financial history and answering it deliberately, so that the next phase is built on honesty rather than avoidance.",
        "health": "A health wake-up call asks for honest self-assessment. The results of past choices are arriving, for better or worse, and the card marks a powerful moment for renewal and recovery. This is the summons to live more healthily, heard and acted on. Forgive past missteps, take stock clearly, and answer the call with a genuine commitment to restoration.",
        "spirituality": "A profound spiritual awakening and calling is reaching you. Karmic cycles, soul-level review, and themes carried from far back are coming to resolution. The summons is heard from within, and the past is being absolved so a renewed self can emerge. Answer the call of your higher nature, release what has been cleared, and step into your spiritual purpose.",
        "imageUrl": "https://roxyapi.com/img/tarot/major/judgement.jpg"
      }
    },
    {
      "position": 6,
      "name": "Below",
      "interpretation": "What lies in your subconscious realm, delving deeper into the core foundation of the situation. Symbolizes the underlying feelings and trends, what is truly driving you. May bring surprise messages, particularly if you are not deeply connected to your inner being. Reversed cards here often indicate unknowns.",
      "card": {
        "id": "ten-of-cups",
        "name": "Ten of Cups",
        "arcana": "minor",
        "suit": "cups",
        "number": 10,
        "position": 6,
        "reversed": true,
        "keywords": [
          "disharmony",
          "broken bonds",
          "misaligned values",
          "unrealistic ideals",
          "disconnection"
        ],
        "meaning": "Reversed, the Ten of Cups shows the rainbow strained or out of reach. The longing for harmony remains, but the lived reality falls short of the picture, and there is a gap between the relationship imagined and the one experienced. Waite linked the reversal to repose of the false heart and to indignation and violence, the bright promise turned uneasy. Connection feels frayed, communication stalls, and each attempt to draw closer seems to widen the distance.\n\nOften the trouble is an unrealistic ideal. The expectation that a relationship or family should be perfect at every moment sets up a disappointment that ordinary friction cannot meet. The remedy is to accept that every bond has its weather, and to rebuild from common ground, meeting one another with patience and honest attention rather than measuring the present against a fantasy.\n\nThe reversal can also turn the focus inward, a season for clarifying what a loving relationship means to you before building outward again. From this vantage some ties may be seen to fall short of your genuine good and need releasing, while truer ones can be welcomed.\n\nA further reading is misaligned values: living by what others expect rather than what you believe, or neglecting home in pursuit of work until the most important bonds quietly suffer. The card asks you to return your attention to what truly brings contentment before the imbalance costs what cannot easily be replaced.",
        "love": "The picture of domestic bliss is not matching reality, whether through disharmony, distance, or expectations set too high. The card asks for honesty about the friction rather than pretending all is well. Rebuild from shared ground with patience, and release the fantasy of constant perfection that ordinary love can never satisfy.",
        "career": "A work-life imbalance is straining the relationships that matter most, as professional demands crowd out home and connection. The card warns that the cost accrues quietly. Reprioritise before the imbalance erodes bonds that cannot be easily rebuilt, and weigh what the pursuit is actually trading away.",
        "finances": "Financial stress is unsettling the harmony of the household, or expectations about what security should provide are breeding disappointment. The card counsels facing money matters together rather than letting them divide the home, and aligning financial hopes with what genuinely sustains the relationships involved.",
        "health": "Tension at home or strained family bonds are taking a toll on physical wellbeing, the emotional atmosphere registering directly in the body. The card connects domestic disharmony to health, and asks you to address the relationship strain itself as a real and necessary part of restoring balance.",
        "spirituality": "Fulfilment is being sought far afield when the deeper lessons sit within home and close relationships. The card points to domestic life and family dynamics as the present spiritual teachers, and invites you to find the sacred in the ordinary rather than seeking it elsewhere.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/ten-of-cups.jpg"
      }
    },
    {
      "position": 7,
      "name": "Advice",
      "interpretation": "Takes into account all that is happening within your life and presents a recommendation for what approach can be taken to address the current challenges. This is the guidance from the cards on how to proceed.",
      "card": {
        "id": "justice",
        "name": "Justice",
        "arcana": "major",
        "number": 11,
        "position": 7,
        "reversed": true,
        "keywords": [
          "unfairness",
          "dishonesty",
          "avoided accountability",
          "bias"
        ],
        "meaning": "Reversed, Justice points to a place where truth is being avoided and balance has been lost. There may be private awareness of having acted wrongly, paired with the temptation to conceal it and hope it goes unseen. The card describes the evasion of accountability: blaming others, dodging consequence, and refusing the honest reckoning the situation requires. Waite linked the reversal to legal complications, bias, bigotry, and excessive severity, the machinery of judgement turned unfair.\n\nThe remedy is to face the matter squarely. Where a mistake has been made, acknowledging it and acting to set it right frees the conscience and restores the balance that concealment only delays. The cost of avoidance is usually higher than the cost of honesty, and the longer the truth is held off, the heavier the eventual accounting.\n\nThe reversal can also turn its sword inward, sharpening an inner critic that judges every step too harshly. Where this is at work, the correction is self-honesty tempered with compassion, not relentless self-condemnation. In matters of decision, the card warns against prejudice and bias that quietly distort fairness; more information or an outside view may be needed before a balanced ruling can be reached. In legal affairs it can signal a feared or disputed outcome, delays, or something that obstructs a just result. The path back is the same in every case: tell the truth, accept the consequences, and let balance return.",
        "love": "Unfairness, dishonesty, or an avoided reckoning is straining the relationship. One person may carry more than a fair share, or a truth may be concealed to keep the peace. The card warns that imbalance left unaddressed hardens into resentment. Name what is unequal, take honest responsibility, and rebuild the bond on fair and open ground.",
        "career": "Unfair treatment, dishonesty, or evaded accountability is at work in your professional life. A decision may be biased, an agreement one-sided, or a wrongdoing quietly overlooked. The reversal cautions that cutting ethical corners carries a delayed cost. Stand for what is right even when it is difficult, and refuse to let bias or expedience override fair dealing.",
        "finances": "Financial dishonesty, an unfair settlement, or a dispute over money is indicated. There may be a temptation to misreport, underpay, or evade what is genuinely owed. The card warns that the consequences of such dealing eventually arrive in full. Square the accounts honestly, avoid sharp practice, and address any imbalance before it compounds.",
        "health": "Accountability for the body is being avoided, whether by denying an unhealthy habit or by refusing to face the truth of a condition. Denial does not heal; it only postpones the reckoning and deepens it. The reversal asks for an honest assessment and for balanced, responsible action in place of avoidance. Confront what is real and correct it deliberately.",
        "spirituality": "There is a turning away from karmic lessons and from living in line with your values. Inner dishonesty, self-justification, or harsh self-judgement creates a sense of imbalance and stagnation. The card invites you to confront the truth with compassion, own what is yours to own, and realign action with conscience so that equilibrium can return.",
        "imageUrl": "https://roxyapi.com/img/tarot/major/justice.jpg"
      }
    },
    {
      "position": 8,
      "name": "External Influences",
      "interpretation": "Highlights the people, energies, or events which will affect the outcome of your question and are beyond your control. Shows the broader context in which you operate and environmental factors at play.",
      "card": {
        "id": "ace-of-pentacles",
        "name": "Ace of Pentacles",
        "arcana": "minor",
        "suit": "pentacles",
        "number": 1,
        "position": 8,
        "reversed": true,
        "keywords": [
          "lost opportunity",
          "poor planning",
          "scarcity fear",
          "financial delay"
        ],
        "meaning": "Reversed, the Ace of Pentacles describes a material opportunity that slips away or fails to take hold. The golden pentacle tilts as though about to fall from the offering hand, and the promise of the upright card is withdrawn, delayed, or squandered. Waite linked the reversal to the evil side of wealth and to bad intelligence, the sense of prosperity present but turned against its possessor or simply out of reach.\n\nOften the problem is planning rather than possibility. A pay rise, a job, a loan, or a deal may fall through without warning, or hesitation keeps a real opening from being seized. Do the practical work first: weigh the feasibility honestly, perform due diligence, and avoid counting on a financial gain before it is secured. An offer is not money until it has arrived.\n\nThe reversed Ace also warns against poor handling of resources. This is not the moment to overextend or to spend against a windfall that has not materialised. Budget with a margin of safety, and resist chasing an opportunity whose footing is unsound. Patience and prudence protect what scarcity-driven haste would lose.\n\nWhere the card points to ambition stalled by delays, revise the approach rather than abandon it. Realign the goal to something realistic, seek advice if the path is unclear, and validate genuine demand before committing. The material seed is still available, but it needs firmer ground and steadier hands before it can take.",
        "love": "A promising connection lacks a practical foundation, or one person leans too heavily on material security as the basis for the bond. The reversed Ace of Pentacles warns that stability alone cannot sustain a relationship without genuine feeling beneath it. Look honestly at what is being built and on what. Balance the practical with the emotional, and do not mistake comfort for connection.",
        "career": "A missed opening, poor planning, or hesitation is keeping a real opportunity out of reach. The reversed Ace of Pentacles suggests the chance exists but the approach needs work, whether through clearer strategy, better timing, or more grounded preparation. Revisit the plan with a practical eye, address what is unsound, and avoid charging ahead before the foundation is in place.",
        "finances": "A financial opportunity falls through, or resources slip away through weak planning and unguarded spending. The reversed Ace of Pentacles counsels discipline: do not rely on a windfall before it arrives, avoid heavy obligations, and keep a margin in the budget. Money handled carelessly here drains rather than builds. Tighten the plan and protect the base before reaching for more.",
        "health": "A health routine fails to deliver, or physical wellbeing is neglected through inconsistency or lack of follow-through. The reversed Ace of Pentacles points to potential that is not being cultivated. The foundation for better health exists but needs steady, practical commitment. Identify what is undermining the effort, simplify the routine, and rebuild it on habits you can actually keep.",
        "spirituality": "Material preoccupation crowds out spiritual growth, or insight stays abstract and never grounds into daily life. The reversed Ace of Pentacles asks for balance between the practical and the sacred. The physical world is a teacher rather than a distraction. Bring values into concrete form, loosen the grip on material worry, and let everyday action carry meaning rather than block it.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/ace-of-pentacles.jpg"
      }
    },
    {
      "position": 9,
      "name": "Hopes and Fears",
      "interpretation": "One of the most complex positions, hopes and fears are closely intertwined, therefore that which we hope for may also be that which we fear, and so may fail to happen. What you deeply desire may also be what you are afraid of achieving.",
      "card": {
        "id": "five-of-swords",
        "name": "Five of Swords",
        "arcana": "minor",
        "suit": "swords",
        "number": 5,
        "position": 9,
        "reversed": true,
        "keywords": [
          "reconciliation",
          "making amends",
          "releasing resentment",
          "lingering conflict"
        ],
        "meaning": "Reversed, the Five of Swords turns toward the end of conflict and the work of repair. A period of fighting has run its course, and there is a genuine wish to set it down, to forgive what can be forgiven and to redirect the spent energy toward rebuilding what the battle damaged. The recognition has dawned that a contest of this kind produces only losers. Waite read the reversal as carrying the same heavy import as the upright, a reminder that even in retreat the wounds of the clash remain to be tended.\n\nOften the reversal marks an argument pressed to its limit, a pushing against someone who will not yield while both sides exhaust themselves to no gain. The instruction is to recognise the deadlock, lay down the blade, and seek the compromise or clean exit the standoff has refused. Where conflict still trails a person even after they walk away, keep distance until the raw emotion has cooled.\n\nThe reversal can also surface old resentment, a wound reopened or a grievance still carried from a past quarrel, and the fear that the hurt might repeat. Here the work is to forgive in order to move on, to bring the energy back within, and to ask how a solution might be found in which no one has to lose. This is the moment to apologise, make amends, and clear the ground so something more constructive than conflict can grow.",
        "love": "A destructive cycle of conflict is being brought to an end. The reversed Five of Swords favours walking away from arguments that cannot be won and releasing the need to be right. Reconciliation becomes possible once both partners set the blade down. Make the apology, seek the common ground, and clear the resentment so the relationship has room to recover rather than corrode.",
        "career": "Workplace grudges are being released and a draining professional conflict laid to rest. The reversed Five of Swords favours accepting a loss with grace rather than prolonging a fight that yields nothing. Moving on preserves energy for work that matters. Make amends where the clash did harm, redirect the effort constructively, and refuse to let an old battle keep claiming your attention and goodwill.",
        "finances": "Accepting a financial loss and moving on is wiser than continuing a draining fight. The reversed Five of Swords notes that the cost of pursuing what is owed can exceed the sum itself. Release the grievance, weigh the toll of the dispute honestly, and redirect financial energy toward rebuilding rather than retaliation. Sometimes the cleanest gain is simply ending the conflict.",
        "health": "Health improves as you release yourself from stressful, adversarial situations. The reversed Five of Swords marks the relief that follows a decision to stop fighting battles that were never worth the cost. The nervous system recovers, sleep steadies, and tension eases. Let the resentment go, step out of the standoff, and allow the body to benefit immediately from the peace that follows.",
        "spirituality": "Ego battles and the wounds of conflict are being released. The reversed Five of Swords favours forgiveness and surrender over the lingering need to win, and the quieting of resentment that still echoes from a past clash. True spiritual victory comes through peace rather than conquest. Bring the energy back within, make amends where you can, and let the calm of release replace the strain of contest.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/five-of-swords.jpg"
      }
    },
    {
      "position": 10,
      "name": "Final Outcome",
      "interpretation": "Where the situation is headed and if/how the issue will be resolved. Assumes the outcome based on you continuing your current course of action. If this outcome is not desirable, it is within your free will to make necessary changes.",
      "card": {
        "id": "seven-of-cups",
        "name": "Seven of Cups",
        "arcana": "minor",
        "suit": "cups",
        "number": 7,
        "position": 10,
        "reversed": false,
        "keywords": [
          "choices",
          "illusion",
          "wishful thinking",
          "fantasy",
          "temptation"
        ],
        "meaning": "The Seven of Cups is the suit of feeling lifted off the ground into imagination, the card of choices clouded by illusion. In the Rider-Waite-Smith image, a dark silhouette stands before seven cups that float on a bank of cloud, each holding a different vision: a face, a shrouded glowing figure, a serpent, a castle, jewels, a wreath, and a dragon. Some of the offerings are alluring and some are warnings, but all of them hover in the air rather than rest in the hand. Waite read the card as fairy favours, images of reflection, things seen in the glass of contemplation, with the caution that nothing permanent or substantial is suggested.\n\nIn a reading, the Seven of Cups describes an abundance of options that is also a kind of trap. Many possibilities present themselves, and the temptation is to be dazzled by them, to mistake the glittering image for the solid thing. Some of the cups hold genuine opportunity and some hold pure fantasy, and from a distance they are hard to tell apart. The card warns against choosing by allure alone, since what promises the most at a glance often proves the least real on inspection.\n\nThe card also names wishful thinking. It can mark a habit of imagining the desired outcome rather than doing the work that would bring it about, the fitter body wished for but not exercised toward, the success daydreamed but not built. Scattered among too many shining ideas, none of them gets carried through, and the constant pursuit of the next big thing leaves every cup untouched.\n\nWhen the Seven of Cups appears, it asks you to look past the surface and to choose. Examine each option honestly, set it against what you genuinely value rather than what merely glitters, and commit to one path. The vision is only worth anything once it is brought down out of the cloud and acted upon.",
        "love": "Fantasy or an excess of options is clouding matters of the heart. The Seven of Cups warns against projecting an idealised image onto a partner, or being so taken with possibilities that none is chosen. The glittering version of love is not the real one. Look past the surface, ground your expectations in what is actually there, and choose before deciding.",
        "career": "Many professional options shimmer at once, and the abundance itself is paralysing. The Seven of Cups warns that daydreaming about possibilities is no substitute for acting on one. Some of the offers are solid and some are illusion. Weigh each realistically against what you truly want, then commit to a single path rather than drifting among them.",
        "finances": "Financial fantasy or too many tempting options are clouding judgment. The Seven of Cups flags get-rich-quick schemes and visions of easy money as especially seductive and especially hollow. Look beneath the glitter of each prospect, ground decisions in research rather than hope, and choose the option that holds up to scrutiny rather than the one that merely dazzles.",
        "health": "Unrealistic expectations or chasing too many approaches at once is leading nowhere. The Seven of Cups warns against the constant search for a miracle fix while no single method is followed through. Choose one sound, proven approach and commit to it. Consistency with a realistic plan accomplishes what scattered enthusiasm across many cannot.",
        "spirituality": "Spiritual illusion and scattered seeking are pulling you off course. The Seven of Cups warns against chasing mystical experiences or dabbling in many paths without grounding any of them in steady practice. The glamour of the vision is not the substance of the work. Choose one path and follow it to depth rather than skimming the surface of several.",
        "imageUrl": "https://roxyapi.com/img/tarot/minor/seven-of-cups.jpg"
      }
    }
  ],
  "summary": "The Celtic Cross provides deep insight into your situation, revealing past influences, present challenges, and future possibilities."
}

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

Free templates for Tarot.

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

Show all 6 templatesShow fewer templates

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

What you can build with the Tarot Reading API.

The products teams ship on the Tarot Reading API.

  • 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: one consistent personalized card per user 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

Try every endpoint live, free, in the playground.

Real calls against the production API, no account needed. Every endpoint sits in the public OpenAPI spec and is callable as an MCP tool; open one for its parameters and response examples.

List all 78 tarot cards - Tarot deck catalog API
List all 78 tarot cards - Tarot deck catalog API

Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards. The 22 Major Arcana (numbered 0-21) carry life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower; the 56 Minor Arcana (4 suits × 14 cards each) cover 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.

Try it
Get tarot card by id - Tarot card meaning API
Get tarot card by id - Tarot card meaning API

Retrieve 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". Major Arcana IDs carry no leading article, though one is accepted, so "the-star" and "star" both return The Star. Essential for detailed tarot study, reading interpretations, divination apps, fortune-telling platforms, spiritual guidance tools, and professional tarot learning applications.

Try it
Draw tarot cards - Seeded tarot draw API
Draw tarot cards - Seeded tarot draw API

Draw 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, which is 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 or inverted orientations, where 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).

Try it
Daily tarot card - Card of the day API
Daily tarot card - Card of the day API

Receive 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. Pass a seed (userId, email hash, session token) to give each user their own card for the day; without a seed every caller receives the same shared card of the day, which changes at midnight UTC. Returns card with keywords, full meaning, and a daily message summary. Great for tarot apps, wellness platforms, morning ritual apps, and journaling tools.

Try it
Yes or no answer - Yes no tarot reading API
Yes or no answer - Yes no tarot reading API

Ask 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.

Try it
Three card spread, past present future - Tarot spread API
Three card spread, past present future - Tarot spread API

Perform the classic three-card tarot spread revealing Past, Present, and Future. Past is what led to this situation, Present the current energy and circumstances, and Future the likely outcome if the 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.

Try it
Celtic Cross spread, 10 cards - Tarot spread API
Celtic Cross spread, 10 cards - Tarot spread API

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.

Try it
Love spread, 5 cards - Relationship tarot reading API
Love spread, 5 cards - Relationship tarot reading API

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.

Try it
Career spread, 7 cards - Career tarot reading API
Career spread, 7 cards - Career tarot reading API

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.

Try it
Custom spread builder - Configurable tarot spread API
Custom spread builder - Configurable tarot spread API

Build 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, so 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 is provided, so 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.

Try it

What customers are building.

LF
Louise Falkenberg

Course creator, Denmark

I think you have done an amazing job, it must have taken a long time. Clients are happy, and so am I.

Natal chart, transit, horoscope, tarot, dream and crystal readings inside her online courses

MM
Mishaal Murawala

Founder, United States

I use RoxyAPI as the data layer for my astrology assistant. It has been reliable.

An astrology assistant on Vedic and KP, dashas, divisional charts, panchang, Western astrology, numerology and tarot

MF
Mário Feijoca

Founder, Portugal

I really appreciate the quick and helpful support from the RoxyAPI team.

A self-knowledge platform that combines Astrology, Human Design, Numerology, BaZi and other traditions into one personal reading

Every customer story comes from an account we confirmed and is published with the approval of that customer.

Read customer stories

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

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. 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.

From your AI agent to a verified Tarot answer.

Your AI agent

your model, your voice

Remote MCP

auto-discovered, no local setup

Token-optimized

Roxy Ephemeris

13,957 tests, 3683 gold standard

Verified result

18+ domains, one flat rate

Your agent uses calculated charts and readings in its replies, with your model and your own voice. Planetary positions are verified against NASA JPL Horizons. No local setup, no AGPL, no hosted-AI markup.

Audit it yourself: every Tarot endpoint runs live in the API playground

Included in the same plan as Tarot Reading

17 more insight domains

Tarot Reading API questions, answered.

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 every RoxyAPI domain, so you can layer astrology, numerology, or dreams alongside tarot under one flat subscription. Reach for it through the typed SDKs for TypeScript, Python, PHP, C#, Go, and Rust, 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 every language this API ships, 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 Reading API today.

Tarot readings a user can share and reopen unchanged, every card read upright and reversed for love, career and health.

All 18+ domains included with every plan. Every endpoint, MCP server, SDK, and templates.

Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key