Yes No Tarot 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.

Request

POST /api/v2/tarot/yes-no

{
  "question": "Should I accept the job offer?",
  "seed": "reading-2f9c1a"
}

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.

{
  "question": "Should I accept the job offer?",
  "seed": "reading-2f9c1a",
  "answer": "Yes",
  "strength": "Qualified",
  "card": {
    "id": "eight-of-wands",
    "name": "Eight of Wands",
    "arcana": "minor",
    "reversed": false,
    "keywords": [
      "swift movement",
      "momentum",
      "rapid news",
      "air travel",
      "aligned action"
    ],
    "imageUrl": "https://roxyapi.com/img/tarot/minor/eight-of-wands.jpg"
  },
  "interpretation": "Qualified Yes: Eight of Wands suggests forward momentum. The Eight of Wands is the one pip in the suit of Wands with no human figure in it."
}

Supported options

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.castYesNo({ body: { question: 'Should I accept the job offer?', seed: 'reading-2f9c1a' } })

from roxy_sdk import create_roxy

roxy = create_roxy("YOUR_API_KEY")
result = roxy.tarot.cast_yes_no(question='Should I accept the job offer?', seed='reading-2f9c1a')

use function RoxyAPI\Sdk\createRoxy;

$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->tarot->castYesNo(question: 'Should I accept the job offer?', seed: 'reading-2f9c1a');

using RoxyApi;

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

import roxyapi "github.com/RoxyAPI/sdk-go"

roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.Tarot.CastYesNo(ctx, nil, roxyapi.CastYesNoJSONRequestBody{ /* request fields above */ })

curl -X POST "https://roxyapi.com/api/v2/tarot/yes-no" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question":"Should I accept the job offer?","seed":"reading-2f9c1a"}'

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/yes-no: post_tarot_yes_no. Full MCP setup guide

What you can build

Drop-in UI components and no-code widgets.

Render Yes No Tarot 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 Yes No Tarot API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

Tarot spread widget snippetThe complete UI libraryExplore Roxy UI

Related capabilities

Yes No Tarot API FAQ