Daily Tarot Card API
Card of the day API
Included with every plan (at no extra cost)
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. 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.
Request
POST /api/v2/tarot/daily
Parameters
| Parameter | Type | Description |
|---|---|---|
| langquery | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en. |
Request body
| Field | Type | Description |
|---|---|---|
| seed | string | Optional seed for reproducible readings. Same seed + same date = same card every time. Pass any unique identifier (userId, email hash, session token). Omit for anonymous daily readings. |
| date | string (date) | Date for the reading in YYYY-MM-DD format. Defaults to today (UTC). Useful for viewing past daily readings or pre-generating future ones. |
Example request
{
"seed": "user123",
"date": "2026-03-06"
}Response
Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
{
"date": "2026-03-06",
"seed": "user123-2026-03-06",
"card": {
"id": "knight-of-pentacles",
"name": "Knight of Pentacles",
"arcana": "minor",
"suit": "pentacles",
"number": 12,
"position": 1,
"reversed": true,
"keywords": [
"stagnation",
"stubbornness",
"boredom",
"overcaution"
],
"meaning": "Reversed, the Knight of Pentacles shows his steady virtues tipping into excess, and the surrounding cards reveal which way. Waite gave the reversal as inertia, idleness, stagnation, and discouragement, and at its heart the card warns that dependability has hardened into being stuck. The reliable routine has become a rut, life has gone dull and lifeless, and the very consistency that once produced results now stifles creativity and movement. The remedy is a deliberate change of pace, a willingness to do something different rather than repeat the familiar by reflex.\n\nThe card can also point the other way, to a needed discipline that is missing. Practical matters left neglected, upkeep ignored, goals undermined by a lack of routine. Here the instruction is to build the schedule the situation requires and hold to it until the task is done, rather than drifting toward whatever feels more exciting.\n\nIn its harder expressions the reversal shows stubbornness and overcaution: an approach so conservative and risk-averse that growth stalls, or rigidity that resists every new method. It can also curdle into perfectionism, a sharp impatience with others who do not share the same exacting standard. The card asks for the standard to be kept without losing the people around it. Soften the rigidity, allow a measured risk, and let the dependable strength of this Knight serve progress again rather than block it.",
"love": "Stubbornness or unbroken routine has drained the spark, and reliability has slid into monotony. Steadiness without any warmth or spontaneity leaves the bond flat. The card asks for some flexibility and freshness to be brought back in. Keep the dependability, but let a little adventure return to the relationship before it stales.",
"career": "Workaholism, rigidity, or resistance to change is holding progress back, with reliability hardened into inflexibility. The card asks for openness to new methods even when they feel uncomfortable. Loosen the insistence on the familiar way, ease any perfectionism toward colleagues, and let the work adapt rather than stall in routine.",
"finances": "Excessive caution is preventing growth, or a failing strategy is being clung to out of habit. Being too conservative can cost as much as being too rash. The card counsels allowing some measured, calculated risk into the plan and revisiting approaches that no longer serve, rather than defending them by reflex.",
"health": "Unhealthy routines maintained by stubbornness, or an approach kept long after it stopped working. What once helped the body may no longer fit. The card asks for willingness to update the wellness strategy as circumstances change, trading rigid repetition for honest reassessment and a method suited to the present.",
"spirituality": "Practice has stiffened into rote routine without genuine engagement, the discipline present but the spirit gone. The card invites variety and spontaneity back into the path. Loosen the rigidity, try a fresh approach, and reconnect with the meaning the routine was meant to serve rather than performing it by habit.",
"imageUrl": "https://roxyapi.com/img/tarot/minor/knight-of-pentacles.jpg"
},
"dailyMessage": "Your card for 2026-03-06: Knight of Pentacles (reversed). stagnation, stubbornness, boredom, overcaution. Reversed, the Knight of Pentacles shows his steady virtues tipping into excess, and the surrounding cards reveal which way."
}Response fields
| Field | Type | Description |
|---|---|---|
| date* | string | Date of the daily tarot reading in YYYY-MM-DD format (UTC). Determines which card is drawn for seeded readings. |
| seed* | string | Seed used for this daily reading. Same seed on the same date always produces the identical card for reproducible daily divination. |
| card* | object | |
| card.id* | string | Unique card identifier in kebab-case (e.g. the-fool, ace-of-cups). |
| card.name* | string | Display name of the tarot card. |
| card.arcana* | string enum | Whether this card belongs to the Major Arcana (22 trump cards, major life themes) or Minor Arcana (56 suit cards, daily situations). |
| card.suit | string enum | Suit of the card (Minor Arcana only). Cups=emotions, Wands=creativity, Swords=intellect, Pentacles=material. Null for Major Arcana cards. |
| card.number | number | Card number within its arcana. Major Arcana: 0 (Fool) through 21 (World). Minor Arcana: 1 (Ace) through 14 (King). Null when not applicable. |
| card.position* | number | Position index of this card in the draw sequence (1-based). Useful for mapping cards to spread positions. |
| card.reversed* | boolean | True if the card was drawn reversed (upside down). Reversed cards carry modified or blocked energy compared to upright position. |
| card.keywords* | array of string | Key themes and concepts associated with this card in its current orientation (upright or reversed). |
| card.meaning* | string | Full interpretation of this card in its current orientation, providing detailed divination guidance. |
| card.love | string | Love and relationship interpretation for the drawn orientation. Covers romantic partnerships, dating, emotional connections, and matters of the heart. |
| card.career | string | Career and professional interpretation for the drawn orientation. Covers workplace dynamics, job transitions, ambition, and vocational purpose. |
Show all fieldsShow fewer fields
| Field | Type | Description |
|---|---|---|
| card.finances | string | Financial interpretation for the drawn orientation. Covers money management, investments, material prosperity, and abundance mindset. |
| card.health | string | Health and wellbeing interpretation for the drawn orientation. Covers physical vitality, mental health, energy levels, and self-care guidance. |
| card.spirituality | string | Spiritual interpretation for the drawn orientation. Covers personal growth, inner wisdom, soul purpose, and metaphysical development. |
| card.imageUrl* | string | URL to the tarot card artwork image. |
| dailyMessage* | string | Concise daily tarot message summarizing the card, its orientation, key themes, and brief guidance for the day. |
Supported options
lang
Call it in your language.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.tarot.getDailyCard({ body: { seed: 'user123', date: '2026-03-06' } })Install: npm install @roxyapi/sdk
from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.tarot.get_daily_card(seed='user123', date='2026-03-06')Install: pip install roxy-sdk
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->tarot->getDailyCard(seed: 'user123', date: '2026-03-06');Install: composer require roxyapi/sdk
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Tarot.Daily.PostAsync(new() { /* request fields above */ });Install: dotnet add package RoxyApi.Sdk
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Tarot.GetDailyCard(ctx, nil, roxyapi.GetDailyCardJSONRequestBody{ /* request fields above */ })Install: go get github.com/RoxyAPI/sdk-go
curl -X POST "https://roxyapi.com/api/v2/tarot/daily" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"seed":"user123","date":"2026-03-06"}'Prefer to try before you write code? Run this Tarot endpoint live in the API playground and inspect a real production response.
Remote MCP for AI agents
Every Tarot endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
claude mcp add --transport http \
roxy-tarot https://roxyapi.com/mcp/tarot \
--header "X-API-Key: YOUR_KEY"Tool name for POST /tarot/daily: post_tarot_daily. Full MCP setup guide
What you can build
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
Drop-in UI components and no-code widgets.
Render Daily Tarot Card API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Daily Tarot Card API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
Show all Daily Tarot Card UI componentsShow fewer Daily Tarot Card UI components
| Element | Renders |
|---|---|
| <roxy-tarot-card> | Single card with upright and reversed flip |
Related capabilities
Daily Tarot Card API FAQ
What does the Daily Tarot Card API return?
Receive a single tarot card for daily guidance and reflection. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the Daily Tarot Card API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the Daily Tarot Card API support multiple languages?
Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.
Is the Daily Tarot Card API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/tarot over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the Daily Tarot Card API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 18 domains, so the Daily Tarot Card API is included at no extra cost.
Start using Daily Tarot Card 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
