Changelog
Every change to the askTIAN API is documented here. Breaking changes are clearly marked.
GET /api/trpc/catalogue.changelogv2.4.02026-03-14LATESTChangelog pagePublic /changelog page now live at api.asktian.com/changelog — shows all release notes in a structured table with colour-coded type badges (Added/Fixed/Updated/Renamed/Breaking). Powered by the catalogue.changelog tRPC endpoint. Linked from SiteNav and SiteFooter.
tian.eastwest descriptionApiDocs description now explicitly states 14 Eastern + 5 Western = 19 systems, and clarifies that Indian systems (Jyotish, Anka Shastra) are covered by tian.indian, not this endpoint.
tian.global credit trackingrouters.ts ALL_GLOBAL_SYSTEMS now includes khatt (26 systems total). creditsUsed updated from 50 to 52 TIAN credits. Comment updated to reflect 26 systems × 2 = 52 TIAN credits.
TIAN blend descriptionsAll TIAN blend endpoint descriptions in ApiDocs now say "TIAN credits" instead of "credits" to reinforce the $TIAN token utility.
Changelog type coloursChangelog page now renders Renamed entries in violet and Updated entries in cyan, in addition to the existing Added/Fixed/Changed/Breaking/Deprecated colour scheme.
v2.3.02026-03-14tian.global descriptionUpdated tian.global description across ApiDocs and SystemsIndex from "all 25 systems" to "all 26 systems", and from 4 traditions to 5 traditions (Eastern, Indian, Western, African, Islamic). Credit cost updated to 52 (26 systems × 2).
SystemsIndex descriptionThe /systems page description now correctly lists 14 Eastern, 2 Indian, 5 Western, 3 African, and 2 Islamic systems (5 distinct traditions).
tian.global response sampleThe ApiDocs sample response for tian.global now includes the indian tradition score and reflects 5 traditions in the globalSynthesis field.
v2.2.02026-03-14tian.indianIndian TIAN — runs Jyotish (Vedic Astrology) and Anka Shastra (Indian Numerology) in parallel and synthesises a unified Indian metaphysical reading via LLM. Costs 2 credits. Requires Premium or Enterprise subscription.
tian.indian (Playground)tian.indian is now available in the interactive Playground with sample fixtures for birthDate and question inputs.
tian.indian (ApiDocs)tian.indian is now fully documented in the ApiDocs TIAN Blended section with parameters, example curl, and sample response.
tian.indian (SystemsIndex)The /systems page now features a dedicated tian.indian hero callout (rose border) between the Islamic and Global callouts, with Jyotish and Anka Shastra tradition badges.
Khatt al-Raml (Homepage)Khatt al-Raml (system 26) is now listed in the homepage SYSTEMS table with its CDN icon and Islamic tradition tag.
Homepage metric labelThe tradition breakdown label updated from "16+6+3" to "16+6+2+2" (14 Eastern + 2 Indian, 5 Western, 3 African, 2 Islamic) to reflect distinct Indian and Islamic traditions.
Homepage TIAN gridThe TIAN Blended section on the homepage is now a 7-column grid (Eastern, Western, African, East-West, Islamic, Indian, Global) reflecting all 7 blend endpoints.
GET /systemsNow returns 33 entries (26 core + 7 TIAN Blended) including tian.indian.
SystemsIndex titleThe /systems page title and description updated to "All 26 Divination Systems" with the correct tradition breakdown.
v2.1.02026-03-14Homepage stat badgeThe "Systems" stat badge on the homepage now correctly reads 26 (was 25). Hero description updated to include Khatt al-Raml.
tian.islamic hero calloutThe /systems page now features a dedicated tian.islamic hero section between the Islamic tradition table and the tian.global callout, with tradition badges for Rammal and Khatt al-Raml, and direct links to the Playground and Docs.
Islamic tradition tableKhatt al-Raml (tradition: Islamic) now automatically appears in the Islamic tradition table on the /systems page alongside Rammal.
v2.0.02026-03-13khatt.calculateKhatt al-Raml (North African Geomancy) — the Maghrebi and Saharan variant of Islamic geomancy, using sand-line figures (Ashkal) and the Qadi verdict system. Covers Morocco, Algeria, Tunisia, Libya, and the wider Saharan tradition.
tian.islamicIslamic TIAN — runs Rammal and Khatt al-Raml in parallel and synthesises a unified Islamic geomantic reading via LLM. Costs 2 credits. Requires Premium or Enterprise subscription.
tian.islamic (Playground)tian.islamic is now available in the interactive Playground with sample fixtures for birthDate and question inputs.
tian.islamic (ApiDocs)tian.islamic is now fully documented in the ApiDocs TIAN Blended section with parameters, example curl, and sample response.
Homepage TIAN gridThe TIAN Blended section on the homepage is now a 6-column grid (Eastern, Western, African, East-West, Islamic, Global) reflecting all 6 blend endpoints.
GET /systemsNow returns 32 entries (26 core + 6 TIAN Blended) including khatt and tian.islamic.
Homepage countersHero badge updated from 21 to 30 endpoints. ApiDocs Icon Pack count updated to 30 icons. TIAN global description updated to 26 systems.
v1.9.02026-03-13tian.harmonized → tian.eastwesttian.harmonized has been renamed to tian.eastwest across all endpoints, documentation, and the Playground. The endpoint path is now /tian/eastwest. The procedure synthesises all 19 Eastern and Western systems into a unified East-West reading.
tian.global iconDedicated tian.global icon (globe with Bagua, Odu, Sri Yantra, and crescent-star at the four cardinal points) added to the Icon Pack in 4 variants: original, transparent, white, black.
Islamic tradition tableThe /systems page now shows a dedicated Islamic tradition table listing Rammal (and future Islamic systems) separately from Eastern, Western, and African traditions.
tian.global hero calloutThe /systems page now features a dedicated tian.global hero section at the bottom with tradition badges, description, and direct links to the Playground and Docs.
v1.8.02026-03-13tian.globalGlobal TIAN — runs all 25 divination systems across Eastern, Western, African, and Islamic traditions in parallel and synthesises a fully cross-civilisational reading via LLM. Costs 50 credits (25 systems × 2). Requires Enterprise subscription.
tian.african (Playground)tian.african is now available in the interactive Playground with sample fixtures for birthDate and question inputs.
tian.global (Playground)tian.global is now available in the interactive Playground with full 10-parameter form and sample fixtures.
System detail pagesFull dedicated detail pages now live at /systems/vodun, /systems/hakata, /systems/rammal, /systems/anka — completing the SEO footprint for all 25 systems.
GET /systemsNow returns 30 entries (25 core + 5 TIAN Blended) including tian.global.
v1.7.02026-03-13vodun.calculateFa/Vodun (West African Divination) — 256 Du signs from the Fon and Ewe corpus, with Hwe myths, Ebo prescriptions, and Legba guidance. Covers the Beninese and Togolese Vodun tradition.
hakata.calculateHakata (Southern African Bone Throwing) — 16 configurations from the Shona oracle, with ancestral guidance and Nganga prescriptions. Covers Zimbabwe, Zambia, and Mozambique traditions.
rammal.calculateRammal (Islamic Geomancy) — full Darb al-Raml shield chart with 16 geomantic figures, Judge interpretation, and domain-specific guidance. Covers the Arabic, Persian, and Ottoman geomantic traditions.
anka.calculateAnka Shastra (Indian Numerology) — Moolank (root number), Bhagyank (destiny number), Namank (name number), and Lo Shu grid analysis with Navagraha planetary ruler interpretations.
tian.africanAfrican TIAN — blends Ifá, Fa/Vodun, and Hakata in parallel and synthesises a unified African divination reading via LLM. Costs 3 credits. Requires Premium or Enterprise plan.
GET /systemsNow returns 29 systems (25 core + 4 TIAN Blended) including the 4 new African and Islamic systems and tian.african blend.
v1.6.02026-03-13GET /systemsNew REST-style endpoint returning all 29 systems (25 core + 4 TIAN Blended) with id, name, zh, tradition, endpoint, credits, iconUrl, description, and systemUrl. Mirrors catalogue.list at a cleaner path for developers who prefer REST over tRPC.
jyotish.calculateJyotish (Vedic Astrology) — sidereal birth chart with Navagraha, 27 Nakshatras, and Vimshottari Dasha planetary period timing. India's ancient science of light, one of the six Vedangas.
ifa.drawIfá (Yoruba Divination) — 256 Odù chapters with ese verses, Ebo prescriptions, and Orisha guidance. UNESCO Intangible Cultural Heritage of Humanity.
v1.5.02026-03-12catalogue.listPublic endpoint returning all 22 divination systems with metadata, tradition tag, credit cost, and CDN icon URL.
catalogue.changelogPublic endpoint returning the full API changelog (this response).
status.checkPublic health-check endpoint returning DB, Base RPC, and LLM Service latency and status.
admin.webhookLogsAdmin endpoint returning webhook delivery log with timestamp, user, event, URL, HTTP status, and duration.
admin.retryWebhookAdmin endpoint to re-fire a failed webhook delivery to the user's current webhook URL.
v1.4.02026-03-11tian.easternBlended Eastern TIAN reading — fans out to all 14 Eastern systems, synthesises via LLM. Costs 28 credits (14 × 2). Requires Premium or Enterprise plan.
tian.westernBlended Western TIAN reading — fans out to all 5 Western systems, synthesises via LLM. Costs 10 credits (5 × 2). Requires Premium or Enterprise plan.
tian.eastwestEast-West TIAN reading — fans out to all 19 systems across both traditions, synthesises via LLM with cross-tradition commentary. Costs 38 credits (19 × 2). Requires Premium or Enterprise plan.
v1.3.02026-03-10All divination endpointsEvery divination response now includes a deterministic `score` field (0–100) computed from the reading's fortune level, element relationships, and spread composition. No additional credits consumed.
admin.getTianStatsAdmin endpoint returning per-endpoint usage counts for tian.eastern, tian.western, and tian.eastwest.
admin.getAllUsersResponse now includes `walletAddress` from the users table (set on Privy wallet login) in addition to `latestWallet` from payment history.
v1.2.02026-03-07divination.draw591+ divination lots across 10 temple systems. Each lot includes a fortune level, poem, interpretation, and advice.
daLiuRen.calculateDa Liu Ren (大六壬) — Four Courses and Three Transmissions classical divination.
xiaoLiuRen.calculateXiao Liu Ren (小六壬) — Six Gods cycle folk divination.
taiYi.calculateTai Yi Shen Shu (太乙神數) — 72-year Grand Cycle cosmic forecasting.
compatibility.bloodTypeBlood type personality compatibility — A, B, O, AB compatibility matrix.
v1.1.02026-03-05qimen.calculateQimen Dunjia (奇門遁甲) — 9 palaces, 8 gates, 9 stars, 8 deities.
liuyao.calculateLiuyao (六爻) — Six Lines I Ching with 64 hexagrams and changing lines.
meihua.calculateMeihua Yishu (梅花易數) — Plum Blossom divination.
nameAnalysis.analyzeName Analysis (姓名學) — Five formations numerology with stroke analysis.
compatibility.zodiacZodiac compatibility — Chinese zodiac animal harmony scores.
compatibility.birthdayBirthday compatibility — Chinese calendar element theory.
auspicious.analyzeNumberAuspiciousness analysis for phone numbers, license plates, and ID numbers.
almanac.dailyDaily almanac (黃曆) — twelve values, deities, and auspicious activities.
v1.0.02026-03-03tarot.drawTarot — 78-card Rider-Waite deck, single card, 3-card, and Celtic Cross spreads.
coinFlip.flipCoin Flip Oracle — yes/no oracle with 7 domain-specific interpretations.
runes.castRunes — Elder Futhark 24-rune casting, single, three-rune, and five-rune spreads.
numerology.calculateNumerology — Pythagorean Life Path, Expression, Soul Urge, Personality, Birthday numbers.
astrology.calculateWestern Astrology — Sun, Moon, Rising sign analysis with decanates and ruling planets.
auth.meInitial platform launch — Manus OAuth, API key management, subscription plans, and usage tracking.