Tarot

Tarot is a 78-card divination system used for guidance and self-reflection. The deck has 22 Major Arcana cards (big life themes like The Fool, The Tower, The Star) and 56 Minor Arcana cards in four suits (Wands, Cups, Swords, Pentacles). Cards can appear upright or reversed, changing their meaning. Your users care about this for daily guidance, yes/no questions, and multi-card readings.

New to fetch()? The Western Astrology guide has an annotated example explaining every line of an API call.

What you can build

• Daily card apps — one card per day with interpretation and imagery
• Tarot reading apps — three-card spreads (past/present/future), Celtic Cross, yes/no oracle
• Oracle card features — embed a card pull in any wellness or lifestyle app
• AI tarot chatbots — combine with MCP for conversational readings

Which endpoints to call

Daily card

One call, returns today's card with full interpretation and image:

const response = await fetch('https://roxyapi.com/api/v2/tarot/daily', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});
const daily = await response.json();

Response:

{
  "date": "2026-03-15",
  "card": {
    "id": "three-of-wands",
    "name": "Three of Wands",
    "arcana": "minor",
    "suit": "wands",
    "number": 3,
    "reversed": false,
    "keywords": ["Progress", "expansion", "foresight"],
    "meaning": "Your plans are now well underway...",
    "imageUrl": "https://roxyapi.com/img/tarot/minor/three-of-wands.jpg"
  },
  "dailyMessage": "Your card for 2026-03-15: Three of Wands..."
}

Which fields to show your users: card.name and card.imageUrl for the visual. card.keywords as a quick summary. card.meaning for the full interpretation. card.reversed changes the meaning — reversed cards indicate blocked energy or internal work. dailyMessage is a ready-made one-liner.

Three-card spread (past/present/future)

Returns 3 cards with positional interpretations:

const response = await fetch('https://roxyapi.com/api/v2/tarot/spreads/three-card', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});
const spread = await response.json();
// spread.positions[0] = Past, [1] = Present, [2] = Future

Which fields to show your users: Each position has name ("Past", "Present", "Future"), interpretation (what this position means), and card (same structure as daily). Show all three cards side by side with position labels.

Yes/No oracle

Quick answer to a yes/no question:

const response = await fetch('https://roxyapi.com/api/v2/tarot/yes-no', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({})
});
const oracle = await response.json();
// oracle.answer — "Yes", "No", or "Maybe"

Key concepts

• Major Arcana — 22 cards representing major life themes and spiritual lessons (The Fool through The World). These are the "big deal" cards in a reading.
• Minor Arcana — 56 cards in four suits representing everyday situations. Wands (action/ambition), Cups (emotions/relationships), Swords (intellect/conflict), Pentacles (money/material).
• Reversed cards — when reversed: true, the card's energy is blocked, internalized, or inverted. Not necessarily "bad" — often means the energy is being processed internally.
• Spread — a layout of multiple cards where each position has a specific meaning (past, present, future, advice, outcome).

You do not need to understand tarot to use the API. Every response includes full plain-English interpretations.

Full API reference

See all Tarot endpoints in the API Reference.