Hot Number Listing
Lists the hot (most frequently drawn) numbers for a company and year.
| Method | GET |
| Path | /api/v1/hotNumber/{type}/{prize}/{years}/{digit} |
| Full URL | https://backend.4dnum.com/api/v1/hotNumber/{type}/{prize}/{years}/{digit} |
Request
| Attribute | Type | Mandatory | Example | Description |
|---|---|---|---|---|
type | String | Yes | M | Abbreviation company name. See Company Codes. |
prize | String | Yes | 1 | 1 = 1st, 2nd and 3rd prize only. 0 = include 1st, 2nd, 3rd, Special and Consolation. |
years | String | Yes | 2024 | The year to search. |
digit | String | Yes | 4 | 3 = 3-digit numbers only, 4 = 4-digit numbers only. |
caution
prize=1 narrows the search to the top three prizes; prize=0 widens it
to all prize tiers. The 0/1 reads backwards from the usual on/off
convention — check this parameter carefully.
Response
| Attribute | Type | Example | Description |
|---|---|---|---|
num | String | 4186 | The winning number. |
total | Integer | 1 | How many times the number has been a winning number. |
Example
curl https://backend.4dnum.com/api/v1/hotNumber/M/1/2024/4
[
{ "num": "4186", "total": 1 }
]