← Tarot engine/Tarot
POST/v1/tarot/draw

Tarot · Draw API

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

Get free API keyTry in playgroundFull schema in docs ↗

About the engine

Part of 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.

Request

Try it from the command line

curl -X POST https://api.astronode.dev/v1/tarot/draw \
  -H 'Authorization: Bearer aie_test_YOUR_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
  "spread": "three_card",
  "seed": "your-stable-seed-here"
}'

All AstroNode endpoints require a bearer token from your dashboard. Test keys (`aie_test_*`) are free up to 100 calls/month.

Response

What you get back

Every AstroNode response uses the same envelope:request_id,data (the endpoint-specific payload),interpretation (optional narrative block), andmeta (engine version + computed_at timestamp). The exact data schema for POST /v1/tarot/draw is published in the OpenAPI 3.1 spec under /docs.

Engine highlights

What the Tarot engine ships

  • 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)

Related endpoints

Other Tarot endpoints

POST/v1/tarot/yes-no

Single-card verdict with rationale text.

POST/v1/biorhythm

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

POST/v1/biorhythm/moon

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

Ready to call POST /v1/tarot/draw?

Free tier covers 100 requests / month. Razorpay-billed, GST-compliant invoices when you upgrade.

Get free API keyTry in playground

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