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.
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.
| Method & path | Description |
|---|---|
GET /v1/numluck?num=8888&lang=en | Look up the number 8888 |
| Parameter | Required | Description |
|---|---|---|
num | Yes | The 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 |
| Field | Meaning |
|---|---|
input / number | Original input / the extracted digit string |
index / name / level | Table index (1–81), entry name, fortune grade |
stars / wuxing | Lucky stars (out of 7) / five-element attribute |
hint / poem | The traditional hint line / a verse reading |
description | The entry's full reading |
personality | Personality profile: coefficient, type, description |
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.
This API family has been called 70 times in total · 0 today · Stats for all endpoints
| Endpoint | Path | Today | Total |
|---|---|---|---|
| Number luck | /v1/numluck | 0 | 70 |
Enter a number to try it