v3.46.0v3.46.0: Poem backfill complete — 8 temple systems now at 95%+ poem coverage (文殊, 觀音二四, 觀音二八, 車公, 佛祖, 關帝廟, 觀音菩薩, 北帝). New holyMeaning (聖意) field in divination.draw.See what's new →
api.asktian.com · 60 endpoints

Metaphysics
as an API.

33 divination systems across 5 traditions — plus 9 I Ching Numerology endpoints, 7 TIAN Blended synthesis endpoints. 49 temple lot systems, 3,481 divination lots. Structured JSON. Typed responses.

60

Endpoints

49 lot systems

3,481 divination lots

5 traditions

29 divination systems

# Predict Oracle — batch binary scoring (20% discount)

curl -X POST https://api.asktian.com/api/trpc/predict.binaryBatch \
  -H "Authorization: Bearer at_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{ "json": { "questions": [
    { "question": "Will BTC exceed $120k by end of 2026?",
      "optionA": "Yes", "optionB": "No", "resolutionDate": "2026-12-31" },
    { "question": "Will ETH flip BTC in market cap by 2027?",
      "optionA": "Yes", "optionB": "No", "resolutionDate": "2027-01-01" }
  ] } }'
200 OK · ~120ms

Blended Readings

TIAN — Multi-System Synthesis

One call fans out across multiple traditions in parallel. Returns per-system raw data, an LLM-synthesised narrative, and a blended 0–100 score.

tian.eastern

Eastern TIAN

14 systems · 70 TIAN Points

qimenliuyaomeihuadaliujyotishanka+10
Requires Premium+Try →
tian.western

Western TIAN

5 systems · 25 TIAN Points

tarotrunesnumerologyastrologycoinflip
Requires Premium+Try →
tian.african

African TIAN

3 systems · 15 TIAN Points

ifafa-vodunhakatallm-synthesis
Requires Premium+Try →
tian.eastwest

East-West TIAN

19 systems · 95 TIAN Points

east+westcross-traditionllm-synthesis
Requires EnterpriseTry →
tian.islamic

Islamic TIAN

2 systems · 10 TIAN Points

rammalkhatt-al-ramlllm-synthesis
Requires Premium+Try →
tian.indian

Indian TIAN

2 systems · 10 TIAN Points

jyotishanka-shastrallm-synthesis
Requires Premium+Try →
tian.global

Global TIAN

28 systems · 145 TIAN Points

all-285-traditionscross-civilisationalultimate
Requires EnterpriseTry →

All blended endpoints return: systems[], synthesis, blendedScore, creditsUsed

Schema docs →

Endpoints

26 Core Divination Systems

View all →
#
System
TIAN Points
01

Qimen Dunjia

奇門遁甲

1
02

Liuyao

六爻

1
03

Meihua Yishu

梅花易數

1
04

Name Analysis

姓名學

1
05

Chinese Zodiac Compat

生肖配對

1
06

Auspiciousness

吉利數字

1
07

Almanac

黃曆

1
08

Divination Lots

靈簽

1
09

Da Liu Ren

大六壬

1
10

Xiao Liu Ren

小六壬

1
11

Tai Yi Shen Shu

太乙神數

1
12

Western Horoscope

西洋星座

1
13

Birthday Compatibility

生日配對

1
14

Blood Type Compatibility

血型配對

1
15

Tarot

塔羅牌

1
16

Coin Flip Oracle

銅錢占卜

1
17

Runes

盧恩文字

1
18

Numerology

西方數字學

1
19

Western Astrology

西洋占星

1
20

Jyotish

吠陀占星

1
21

Ifá

伊法占卜

1
22

Fa/Vodun

法/巫术占卜

1
23

Hakata

哈卡塔骨占

1
24

Rammal

伊斯兰地占

1
25

Anka Shastra

印度数字学

1
26

Khatt al-Raml

北非地占

1
27

Life Blueprint

稱骨算命

1
28

Mahabote

缅甸占星

1
29

Twelve Palaces

十二宮命理

1

I Ching Numerology 易经数字风水

9 Number Feng Shui Endpoints

8-star pair system — maps consecutive digit pairs to feng shui stars. 5 TIAN Points per call.

⚖ Best number for me →
Endpoint
Description
Cost
iching.houseNumber

Residential / unit number feng shui star-pair analysis.

5 TIAN PointsTry →
iching.carPlate

Vehicle registration plate auspicious star-pair decode.

5 TIAN PointsTry →
iching.phoneNumber

Mobile / landline wealth and health star evaluation.

5 TIAN PointsTry →
iching.icNumber

IC / NRIC / passport feng shui reading.

5 TIAN PointsTry →
iching.businessName

Company or brand name stroke-count analysis.

5 TIAN PointsTry →
iching.batchNumbers

Submit up to 10 numbers in one call — sorted by rating.

5 TIAN PointsTry →
iching.numberReading

Digit-pair star reading for any arbitrary number string.

5 TIAN PointsTry →
iching.rootNumber

Birth date life-path personality profile (root number 1–9).

5 TIAN PointsTry →
iching.partnerCompat

Two-person compatibility score from root numbers.

5 TIAN PointsTry →

Low latency

All calculations run server-side. Structured JSON responses. No client-side computation.

~80–200ms p95

Key-based auth

Bearer token per request. Rate limits and usage tracking enforced per key. Revoke anytime.

Authorization: Bearer at_live_*

Typed endpoints

Defined input schema and consistent response shape for every endpoint. Test live in Playground.

60 endpoints · tRPC-style

Pricing

Pay with TIAN Points

Top up TIAN Points at wallet.asktian.com with a credit card ($0.10/point, min $10) or by swapping TIAN Points tokens 1:1 on Base. Subscription activates automatically once your transfer confirms.

Starter

10,000

TIAN Points / month

1,000 calls / mth

Basic

50,000

TIAN Points / month

10,000 calls / mth

Premium

200,000

TIAN Points / month

50,000 calls / mth

← recommended

Enterprise

1,000,000

TIAN Points / month

500,000 calls / mth

Full pricing details →

Payment

How to subscribe

01

Get TIAN Points

Top up at wallet.asktian.com — pay by credit card ($0.10/point, min $10) or swap TIAN Points tokens 1:1 on Base.

02

Choose a plan

Select a tier above. Note the exact TIAN Points amount required for your plan.

03

Send to treasury

Transfer the exact TIAN Points amount to the askTIAN treasury address.

04

Activate

Submit your transaction in Dashboard → Subscription. Activates automatically on confirmation (~10s).

Treasury address0xa998dFd4f9D0615dCB1Df3D803A0ca4a517181D6

Ready to integrate?

Get your API key. Start making calls in under 2 minutes.