POSTPubliclottery-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

Try it online

Fire a real request right from your browser, no code required

Documentation

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) and count (number of draws to query, maximum 50 draws).
Response Results: Returns JSON data containing the queried count and specific items records. Each record includes expect (draw number), openCode (winning numbers, typically separated by commas and plus signs), name (lottery name), and time (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.

Usage Instructions and Limitations

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "type": "ssq",
  "count": "20"
}

Response Example

{
  "count": 20,
  "items": [
    {
      "expect": "2026078",
      "openCode": "01,02,03,04,05,06+07",
      "name": "双色球",
      "time": "2026-07-19 21:15:00"
    }
  ]
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
type	string	ssq
count	string	20

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
count	number	20
items	array	{"expect":"2026078","openCode":"01,02,03,04,05,06+07","name":"双色球","time":"2026-07-19 21:15:00"}
items[]	object	{...}
items[].expect	string	2026078
items[].openCode	string	01,02,03,04,05,06+07
items[].name	string	双色球
items[].time	string

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}'

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())

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)) }

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 $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;