lottery-prize-result-check
Lottery Winning Result Verification
Supports popular lottery types like Double Color Ball, Seven Happy Lottery, and Super Lotto. Input the lottery type, issue number, and user's purchased numbers to quickly retrieve the official winning numbers for that issue and a preliminary prize verification result. This API is for informational auxiliary queries only.
Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/lottery-prize-result-checkcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/lottery-prize-result-check' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "type": "cjdlt",\n "expect": "2025062",\n "lotteryNo": "13,19,28,30,33@02,12"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/lottery-prize-result-check"
payload = {
"type": "cjdlt",
"expect": "2025062",
"lotteryNo": "13,19,28,30,33@02,12"
}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/lottery-prize-result-check"
payload := []byte("{\n \"type\": \"cjdlt\",\n \"expect\": \"2025062\",\n \"lotteryNo\": \"13,19,28,30,33@02,12\"\n}")
req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java Example
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{\n \"type\": \"cjdlt\",\n \"expect\": \"2025062\",\n \"lotteryNo\": \"13,19,28,30,33@02,12\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/lottery-prize-result-check"))
.method("POST", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/lottery-prize-result-check';
$payload = "{\n \"type\": \"cjdlt\",\n \"expect\": \"2025062\",\n \"lotteryNo\": \"13,19,28,30,33@02,12\"\n}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"resultDetails": "一等奖，奖金跟随奖池浮动",
"resultDesc": "5+2",
"openCode": "13,19,28,30,33+02+12",
"expect": "2025062",
"type": "cjdlt",
"name": "超级大乐透",
"resultList": [
{
"num": "13",
"lottery": true,
"blue": false
},
{
"num": "19",
"lottery": true,
"blue": false
},
{
"num": "28",
"lottery": true,
"blue": false
},
{
"num": "30",
"lottery": true,
"blue": false
},
{
"num": "33",
"lottery": true,
"blue": false
},
{
"num": "02",
"lottery": true,
"blue": true
},
{
"num": "12",
"lottery": true,
"blue": true
}
]
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 30 req/min
- Timeout
- 15000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| type | string | Unspecified | Unspecified | cjdlt |
| expect | string | Unspecified | Unspecified | 2025062 |
| lotteryNo | string | Unspecified | Unspecified | 13,19,28,30,33@02,12 |
Request Example
{
"type": "cjdlt",
"expect": "2025062",
"lotteryNo": "13,19,28,30,33@02,12"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 30 req/min
- Timeout
- 15000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| code | string | Unspecified | Unspecified | SUCCESS |
| message | string | Unspecified | Unspecified | success |
| data | object | Unspecified | Unspecified | {...} |
| data.resultDetails | string | Unspecified | Unspecified | 一等奖，奖金跟随奖池浮动 |
| data.resultDesc | string | Unspecified | Unspecified | 5+2 |
| data.openCode | string | Unspecified | Unspecified | 13,19,28,30,33+02+12 |
| data.expect | string | Unspecified | Unspecified | 2025062 |
| data.type | string | Unspecified | Unspecified | cjdlt |
| data.name | string | Unspecified | Unspecified | 超级大乐透 |
| data.resultList | array | Unspecified | Unspecified | [{"num":"13","lottery":true,"blue":false},{"num":"19","lottery":true,"blue":false},{"num":"28","lottery":true,"blue":false},{"num":"30","lottery":true,"blue":false},{"num":"33","lottery":true,"blue":false},{"num":"02","lottery":true,"blue":true},{"num":"12","lottery":true,"blue":true}] |
| data.resultList[] | object | Unspecified | Unspecified | {...} |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"resultDetails": "一等奖，奖金跟随奖池浮动",
"resultDesc": "5+2",
"openCode": "13,19,28,30,33+02+12",
"expect": "2025062",
"type": "cjdlt",
"name": "超级大乐透",
"resultList": [
{
"num": "13",
"lottery": true,
"blue": false
},
{
"num": "19",
"lottery": true,
"blue": false
},
{
"num": "28",
"lottery": true,
"blue": false
},
{
"num": "30",
"lottery": true,
"blue": false
},
{
"num": "33",
"lottery": true,
"blue": false
},
{
"num": "02",
"lottery": true,
"blue": true
},
{
"num": "12",
"lottery": true,
"blue": true
}
]
}
}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Capabilities
This API provides an auxiliary verification function for winning results of common lottery types such as Double Color Ball, Seven Happy Lottery, and Super Lotto. Developers can quickly obtain the official winning numbers for a specific issue by passing in the designated lottery type, issue number, and the user's purchased numbers. The system then compares these to provide preliminary winning details (e.g., prize level, number of matching red/blue balls). This interface only provides historical drawing information and number comparison services; it does not offer any prediction or number recommendation functions, nor does it encourage any betting behavior.
Request and Response
When making a request, three core parameters must be provided: type (lottery code, e.g., ssq for Double Color Ball), expect (issue number, e.g., 2026082), and lotteryNo (user's numbers, red and blue balls are typically separated by a specific symbol like @). The returned result will include: name (lottery name), expect (issue number), openCode (actual winning numbers for that issue), resultDesc (match status, e.g., 0+1), and resultDetails (specific prize level or a 'no win' message). If is empty, it usually indicates no corresponding prize was won.