All 16 Divination Systems

Production-ready APIs for Eastern and Western divination traditions. Each system is algorithmically implemented with full interpretations — no LLM, no hallucinations, deterministic results.

Chinese Metaphysics11 systems

Qimen Dunjia

Three Styles

奇門遁甲

One of the Three Styles of classical Chinese divination. Maps 9 palaces, 8 gates, 9 stars, and 8 deities onto a time-space grid to determine the most auspicious direction and timing for any endeavour.

Inputs

·Date & time
·Birth year (optional)
·Question context

Output

Palace chart, gate analysis, deity assessment, auspiciousness score

Liuyao

I Ching

六爻

Six Lines I Ching divination. Three coins are cast six times to build a hexagram with changing lines, revealing the hidden dynamics of any situation through the 64 hexagrams of the Book of Changes.

Inputs

·Date & time
·Question
·Coin values (optional)

Output

Primary hexagram, changing lines, transformed hexagram, six-god overlay

Meihua Yishu

Plum Blossom

梅花易數

Plum Blossom Numerology — a rapid hexagram generation method attributed to Shao Yong. Any number, observation, or moment in time can be converted into a hexagram pair for immediate divination.

Inputs

·Upper number
·Lower number
·Date & time

Output

Upper/lower trigrams, hexagram pair, nuclear hexagram, Five Element analysis

Name Analysis

Numerology

姓名學

Five Formations (五格) stroke-count numerology. Analyses the Heaven, Earth, Person, Outer, and Total formations of a Chinese name to assess fortune, health, relationships, and career potential.

Inputs

·Full name (Chinese or romanised)
·Gender (optional)

Output

Five formation scores, 81 number meanings, overall fortune rating

Compatibility

Multi-system

配對系統

Cross-system compatibility analysis combining Chinese zodiac, birthday numerology, blood type, and Five Elements. Returns a composite score with domain breakdowns for love, career, and friendship.

Inputs

·Person A & B birthdates
·Blood types (optional)

Output

Overall score, zodiac affinity, Five Element balance, domain scores

Auspiciousness

Numbers

吉利數字

Analyses phone numbers, licence plates, ID numbers, and addresses for auspiciousness using Cantonese/Mandarin phonetic associations, Five Elements, and the 81 number meanings.

Inputs

·Number string
·Number type (phone/plate/id/address)

Output

Digit-by-digit analysis, overall rating, auspicious/inauspicious segments

Almanac

Daily

黃曆

Traditional Chinese almanac (Tung Shing) for any date. Returns the twelve daily values, auspicious and inauspicious activities, presiding deities, and the Heavenly Stem/Earthly Branch pair.

Inputs

·Date

Output

Daily value, auspicious activities, inauspicious activities, deities, stem-branch

Divination Lots

591+ Lots

靈簽

Temple divination lots (Kau Cim) from 10 classical systems including Guan Di, Mazu, Guan Yin, and more. Each lot includes the verse, interpretation, and domain-specific guidance.

Inputs

·Temple system
·Lot number (optional — random if omitted)

Output

Lot verse, interpretation, fortune level, domain guidance

Da Liu Ren

Three Styles

大六壬

Grand Six Ren — one of the Three Styles alongside Qimen Dunjia and Tai Yi. Constructs the Four Courses (四課) and derives the Three Transmissions (三傳) using the 12 Heavenly Generals.

Inputs

·Date & time
·Question context (optional)

Output

Four courses, three transmissions, Heavenly General overlay, course pattern

Xiao Liu Ren

Folk Method

小六壬

Small Six Ren — the most widely used folk divination method in Chinese culture. Counts through the six gods (大安, 留連, 速喜, 赤口, 小吉, 空亡) using month, day, and hour.

Inputs

·Month
·Day
·Hour (1–12 Chinese hours)

Output

Active god, 7-domain readings (career, wealth, health, love, travel, lost items, general)

Tai Yi Shen Shu

Three Styles

太乙神數

Grand Unity Divine Numbers — the most macro of the Three Styles. Operates on a 72-year Grand Cycle with 16 Tai Yi Gods and 9 Palaces to forecast state-level events, natural phenomena, and era trends.

Inputs

·Year
·Month
·Day
·Scope (annual/monthly/era)

Output

Tai Yi number, ruling god, active palace, domain forecasts, cosmic weather

Western Traditions5 systems

Tarot

78 Cards

塔羅牌

Rider-Waite 78-card Tarot deck with full Major and Minor Arcana. Supports single card draws, 3-card Past/Present/Future spreads, and the 10-card Celtic Cross for deep situational readings.

Inputs

·Spread type (single/3-card/Celtic Cross)
·Question (optional)
·Seed (optional)

Output

Card(s) with position, arcana type, reversed status, and interpretation

Coin Flip Oracle

Yes/No

銅錢占卜

Classic yes/no oracle with weighted probability. Flip 1–9 coins and receive a domain-specific interpretation across 7 life areas: general, career, love, wealth, health, travel, and open questions.

Inputs

·Number of flips (1–9)
·Aspect (optional)
·Question (optional)

Output

Flip results, heads/tails summary, certainty level, domain interpretation

Runes

Elder Futhark

盧恩文字

Elder Futhark 24-rune casting with full meanings, elemental associations, and deity correspondences. Supports single rune, three-rune (Situation/Action/Outcome), and five-rune spreads.

Inputs

·Spread type (single/3-rune/5-rune)
·Question (optional)
·Seed (optional)

Output

Rune(s) with letter, meaning, element, deity, reversed status, and interpretation

Numerology

Pythagorean

西方數字學

Pythagorean numerology system. Derives five core numbers — Life Path, Expression, Soul Urge, Personality, and Birthday — from a full name and birthdate, with master number detection.

Inputs

·Full name (as on birth certificate)
·Birthdate (YYYY-MM-DD)

Output

Five core numbers with titles, traits, and interpretations; master numbers list

Western Astrology

Sun · Moon · Rising

西洋占星

Sun, Moon, and Rising sign analysis with decanates, element profile, modalities, and ruling planets. Provide birth hour for an accurate Rising sign. Returns a synthesised personality overview.

Inputs

·Birthdate (YYYY-MM-DD)
·Birth hour 0–23 (optional, for Rising sign)

Output

Sun/Moon/Rising placements, decan, element profile, modality, synthesis

Ready to integrate?

All 16 systems are available via a single REST-compatible API. Pay with $TIAN and get your API key in minutes.