Cartomancy (撲克占卜)

The Kitchen-Table Deck — Fifty-Two Cards, Four Worlds

Overview

Before tarot decks reached most homes, fortunes were told with the deck already in the drawer: fifty-two ordinary playing cards, read by grandmothers and parlor seers across Europe and America. Cartomancy divides the world into four suits — Hearts for love, home and the feeling life; Diamonds for money and worldly affairs; Clubs for work, ambition and enterprise; Spades for challenges, messages and endings — and gives every card a meaning the tradition has carried for centuries. A few cards are famous in their own right: the Nine of Hearts is THE Wish Card, the one every folk reader watches for; the Ace of Spades carries the weight of endings; the Ace of Hearts opens love and the home. askTIAN deals the deck the honest way — an unbiased seeded shuffle, no replacement, the traditional English meaning line served with its variance disclosed — because the kitchen-table oracle deserves the same rigor as the temple ones.

Origin & history

Playing cards reached Europe in the fourteenth century and were being read within a generation of arriving; the four-suit structure the readers inherited mapped naturally onto the classical elements — water, earth, fire, air — and onto the four domains of ordinary life that folk divination always serves: the heart, the purse, the work, and the trouble. The court cards became people (the fair-haired friend, the shrewd widow, the man of affairs), the pips became events, and certain cards accumulated fame across every transmission line — the Wish Card above all. Unlike tarot, cartomancy never acquired a standardizing deck-and-book industry: it remained oral, regional, and variable, which is precisely why askTIAN's implementation names its line rather than claiming a canon.

The tradition's golden age was the parlor era — the nineteenth century's professional readers and household guides — and its meanings settled into the widely-shared English line this endpoint follows: verified canonical anchors (the suit correspondences, the Wish Card, the Ace of Spades) with the remaining cards phrased in-tradition. Two honest engineering choices define the implementation: reversals are not used, because the folk tradition largely reads upright — inverting a pip card meant nothing at most kitchen tables — and the shuffle is a seeded Fisher–Yates, the provably unbiased algorithm, because an oracle's randomness should be as clean as its texts. The meaning variance across transmission lines is stated in every response's method string.

How it works

Choose a spread — a single card, the classic past-present-future three, or the five-position situation/challenge/advice/influences/outcome — and the engine shuffles the full deck with a seeded Fisher–Yates and deals without replacement. Every card arrives with its rank, suit and glyph, its element and suit domain, its traditional meaning line, and the Wish Card flag when the Nine of Hearts lands. The response tallies the suit balance — a spread heavy in Hearts reads differently from one crowded with Spades — and a documented heuristic score weighs the suits, the Wish Card and a leading Ace of Spades into a single emphasis figure, labelled as emphasis and never probability. Pass a seed to reproduce a reading exactly; omit it for a fresh deal.

Good for

Use cases

The Kitchen-Table Reading

Three cards, past-present-future, the traditional meanings and the suit balance — the reading a parlor seer would give, dealt by an unbiased shuffle and reproducible by seed.

Wish Card Watch

A daily single-card draw where the Nine of Hearts landing is an event — the response flags it, and the score lifts; the folk tradition's little jackpot, rendered as a feature.

Three-Deck Comparison

The same question through cartomancy.draw, tarot.draw and lenormand.draw — the folk deck, the esoteric deck, and the petit jeu side by side, one seed each, one composite view.

Grounded Prose Readings

Feed the dealt cards' traditional lines to your model for the narrative reading — the deterministic layer fixes what was actually dealt and what it traditionally means; the prose interprets.

Key terms

The Four Suits
Hearts — love, home, the emotions (water); Diamonds — money and worldly affairs (earth); Clubs — work, ambition, enterprise (fire); Spades — challenges, messages, endings (air).
The Wish Card
The Nine of Hearts — the tradition's most famous promise: the heart's desire granted. Flagged explicitly in every response where it lands.
Court Cards as People
Jacks as young friends and messengers, Queens and Kings as the women and men around the question — the folk tradition's people-reading layer, carried in each court card's meaning line.
Suit Balance
The tally of suits across the spread — a Hearts-heavy deal and a Spades-heavy deal answer the same question in different voices.
Upright Only
Reversals are deliberately not used: the folk tradition largely reads upright, and this engine follows the tradition rather than importing tarot's convention.
Fisher–Yates
The provably unbiased shuffle behind every deal — seeded for reproducibility, clean by construction.
One Line, Not a Canon
Cartomancy's meanings vary between oral transmission lines far more than tarot's — this endpoint follows the widely-shared traditional English line and says so, rather than claiming canonicity.
Emphasis Score
A documented heuristic weighing suits, the Wish Card and a leading Ace of Spades — an emphasis figure, never a probability.

API

The askTIAN Cartomancy API deals the full 52-card deck with a seeded, provably unbiased Fisher–Yates shuffle into single, three or five-position spreads — every card with its element, suit domain and traditional meaning line, the Wish Card flagged, the suit balance tallied, and a documented emphasis score. Canonical anchors were verified across sources before the deck was written; the oral tradition's meaning variance is disclosed in every response, reversals are not imported from tarot, and deals are reproducible by seed. Pure compute, no LLM, 2 TIAN pay-per-call beside tarot.draw and lenormand.draw.

Endpoint: POST /trpc/cartomancy.draw — 2 TIAN Points. See the API documentation and Playground.