Daily Tarot Card 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. 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

{
  "seed": "user123",
  "date": "2026-03-06"
}

Response

Structured JSON with documented fields, verified against NASA JPL Horizons across 828 gold-standard tests. Not hallucinated text.

{
  "date": "string",
  "seed": "string",
  "card": {
    "id": "string",
    "name": "string",
    "arcana": "major",
    "position": 0,
    "reversed": true,
    "keywords": [
      "string"
    ],
    "meaning": "string",
    "imageUrl": "string"
  },
  "dailyMessage": "string"
}

Supported options

Call it in your language in seconds.

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' } })

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.tarot.get_daily_card(seed='user123', date='2026-03-06')

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->tarot->getDailyCard(seed: 'user123', date: '2026-03-06');

using RoxyApi;

var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.Tarot.Daily.PostAsync(new() { /* request fields above */ });

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 */ })

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"}'

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

Drop-in UI components

Render Daily Tarot Card API responses without building charts yourself. These open source, framework-agnostic web components take the typed response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.

Related capabilities

Daily Tarot Card API FAQ