← 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_REPLACE_WITH_YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "spread": "three_card",
  "seed": "playground-demo-2026-05"
}'

Paste and run - this is the exact payload our live playground sends to this endpoint, so it is valid against the current schema. Every AstroNode endpoint needs a bearer token from your dashboard. Test keys (aie_test_*) work on the free tier - 1,000 requests / month, no card.

Request schema

Fields POST /v1/tarot/draw accepts

Request body fields for POST /v1/tarot/draw
FieldTypeNotes
spreadrequiredenum

single | three_card | nine_card | celtic_cross

seedstring

len 1..120

Generated from the same OpenAPI 3.1 document the API validates against, so this table cannot drift from the endpoint without the build failing.

Response

What you get back

Every AstroNode response uses the same envelope: request_id, data (the endpoint-specific payload), interpretation (optional narrative block), and meta (engine version + computed_at timestamp). This endpoint documents 200, 400, 401, 429.

The data payload for POST /v1/tarot/draw is not yet broken out field by field in the published schema. The fastest way to see its exact shape is to run the call - the playground returns a live response with no signup, and the API reference carries the full document.

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 1,000 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.