lottery-results-history-query
Lottery Draw Results and History Query
Query official lottery draw results for eight types of welfare and sports lotteries, including Double Color Ball and Super Lotto. Supports retrieving historical winning numbers and times for up to the latest 50 draws.
Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/lottery-results-history-querycURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/lottery-results-history-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "type": "ssq",\n "count": "20"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/lottery-results-history-query"
payload = {
"type": "ssq",
"count": "20"
}
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-results-history-query"
payload := []byte("{\n \"type\": \"ssq\",\n \"count\": \"20\"\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\": \"ssq\",\n \"count\": \"20\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/lottery-results-history-query"))
.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-results-history-query';
$payload = "{\n \"type\": \"ssq\",\n \"count\": \"20\"\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
{
"count": 20,
"items": [
{
"expect": "2026078",
"openCode": "01,02,03,04,05,06+07",
"name": "双色球",
"time": "2026-07-19 21:15:00"
}
]
}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 | ssq |
| count | string | Unspecified | Unspecified | 20 |
Request Example
{
"type": "ssq",
"count": "20"
}- 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 |
|---|---|---|---|---|
| count | number | Unspecified | Unspecified | 20 |
| items | array | Unspecified | Unspecified | [{"expect":"2026078","openCode":"01,02,03,04,05,06+07","name":"双色球","time":"2026-07-19 21:15:00"}] |
| items[] | object | Unspecified | Unspecified | {...} |
| items[].expect | string | Unspecified | Unspecified | 2026078 |
| items[].openCode | string | Unspecified | Unspecified | 01,02,03,04,05,06+07 |
| items[].name | string | Unspecified | Unspecified | 双色球 |
| items[].time | string | Unspecified | Unspecified | 2026-07-19 21:15:00 |
Response Example
{
"count": 20,
"items": [
{
"expect": "2026078",
"openCode": "01,02,03,04,05,06+07",
"name": "双色球",
"time": "2026-07-19 21:15:00"
}
]
}$.code == 200API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Capabilities
This API provides query services for China Welfare Lottery and Sports Lottery draw results and historical records. It supports eight common lottery types, including Double Color Ball and Super Lotto. Users can quickly retrieve official winning numbers, draw numbers, and draw times for up to the latest 50 draws by specifying the lottery type and query period. The data structure is clear, making it convenient for developers to quickly integrate into various information query applications.
Request and Response
- Request Parameters: Requires
type(lottery code, e.g., 'ssq' for Double Color Ball) andcount(number of draws to query, maximum 50 draws). - Response Results: Returns JSON data containing the queried
countand specificitemsrecords. Each record includesexpect(draw number),openCode(winning numbers, typically separated by commas and plus signs),name(lottery name), andtime(draw time).
Use Cases
Suitable for convenience service apps, lifestyle information websites, mini-programs, and other scenarios that need to provide users with lottery draw information verification and historical draw record queries.