Tarot

The Tarot engine.

A standalone divination surface that doesn't need ephemeris or birth data. Tarot draws use a seedable PRNG so any draw is reproducible from its seed — useful for shareable readings, saved reports, and deterministic tests. Pairs with a 4-cycle biorhythm calculator and a lunar-phase tone descriptor.

  • Rider-Waite-Smith 1909 deck — all 78 cards, reproducible draws given a seed
  • Four spreads: single, three-card, nine-card, classic Celtic Cross
  • Yes / no / uncertain verdicts gated on card confidence
  • Biorhythm — physical (23d), emotional (28d), intellectual (33d), spiritual (53d)
  • Lunar phase tone descriptor — 8 named phases of the synodic month
  • All 78 cards ship with upright + reversed paragraphs; Major Arcana paraphrased from Waite-Smith, Minor Arcana engineer-authored from tradition (every card carries a content_origin tag)
Sample request/v1/tarot/draw
bash
curl -X POST https://api.astronode.dev/v1/tarot/draw \
  -H "Authorization: Bearer aie_test_…" \
  -H "Content-Type: application/json" \
  -d '{
  "spread": "three_card",
  "seed": "your-stable-seed-here"
}'

Endpoints in this engine

4 endpoints, one consistent JSON shape

POST/v1/tarot/draw

Multi-card spread (single / three / nine / celtic). Seedable for reproducible draws.

Open in console
POST/v1/tarot/yes-no

Single-card verdict with rationale text.

Open in console
POST/v1/biorhythm

4-cycle biorhythm on a target date — phase, intensity, tone per cycle.

Open in console
POST/v1/biorhythm/moon

Lunar phase + illumination + tone descriptor for the target date.

Open in console

Ready to ship Tarot features?

Free tier covers 100 calls/day. Upgrade when you need production headroom — Razorpay-billed, GST-compliant invoices.

Informational, not predictive. Not medical, legal, or financial advice.