← API.MAO.MS Home中文 · 繁體

Number Luck

The fortune of any number by the traditional 81-numerology table — phone numbers, licence plates, house numbers. For letter-dominant strings such as domain names, see Letter Luck.

How it is calculated

The whole digit string is reduced modulo 80 (a remainder of 0 counts as 80) and looked up in the fixed 81-entry table for its grade, name and reading. Because 10000 is an exact multiple of 80, the result is always identical to using only the last four digits, so no truncation is applied; shorter numbers are used whole. The element follows the index's last digit (1–2 Wood, 3–4 Fire, 5–6 Earth, 7–8 Metal, 9–0 Water).

Lucky stars run to 7 and follow the grade: Great fortune ★6, Fortunate ★5, Fairly fortunate ★5, Somewhat unfavourable ★3, Unfavourable ★2, Very unfavourable ★1. The personality coefficient is the digital root of the sum of all digits (e.g. 9521 sums to 17, coefficient 8; a sum of 0 gives 9) and maps to one of nine personality types shared with Letter Luck (1 The Pioneer, 2 The Harmoniser, 3 The Creator, 4 The Builder, 5 The Explorer, 6 The Nurturer, 7 The Thinker, 8 The Passionate Dreamer, 9 The Compassionate Giver). Each entry also returns a hint line and a verse reading.

Endpoint

Method & pathDescription
GET /v1/numluck?num=8888&lang=enLook up the number 8888
ParameterRequiredDescription
numYesThe string to look up: a licence plate or a segmented phone number works too — the endpoint extracts the digits automatically and ignores everything else; up to 64 extracted digits, and an error if there are none
FieldMeaning
input / numberOriginal input / the extracted digit string
index / name / levelTable index (1–81), entry name, fortune grade
stars / wuxingLucky stars (out of 7) / five-element attribute
hint / poemThe traditional hint line / a verse reading
descriptionThe entry's full reading
personalityPersonality profile: coefficient, type, description

Example

GET /v1/numluck?num=8888&lang=en

{"code":0,"message":"ok","data":{"input":"8888","number":"8888","index":8,"name":"Eight Trigrams","level":"Fairly fortunate","stars":5,"wuxing":"Metal","hint":"Diligence develops, the will prevails, advance and retreat well judged: success in view.","poem":"A will of iron and endless patience: hard first, accomplished later.","description":"Strong-willed and diligent; self-reliance brings success, haste brings loss.","personality":{"coefficient":5,"type":"The Explorer","description":"Freedom-loving and endlessly curious…"}}}

Plates work the same way: GET /v1/numluck?num=9521E → digits 9521 extracted → Primordial Unity · Great fortune · coefficient 8

The table comes from the classical five-grid numerology system; the readings are written by this site. For entertainment and cultural interest only.

Usage stats

This API family has been called 70 times in total · 0 today · Stats for all endpoints

EndpointPathTodayTotal
Number luck/v1/numluck070

Live test

Enter a number to try it