lottery-draw-information-query
Lottery Draw Information Query
Query current lottery draw numbers, sales amount, and winning counts and prize money for each prize level by lottery type, draw number, or date, providing comprehensive draw data.
Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/lottery-draw-information-querycURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/lottery-draw-information-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "type": "ssq",\n "drawNo": "2024068"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/lottery-draw-information-query"
payload = {
"type": "ssq",
"drawNo": "2024068"
}
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-draw-information-query"
payload := []byte("{\n \"type\": \"ssq\",\n \"drawNo\": \"2024068\"\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 \"drawNo\": \"2024068\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/lottery-draw-information-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-draw-information-query';
$payload = "{\n \"type\": \"ssq\",\n \"drawNo\": \"2024068\"\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": "ssq",
"name": "双色球",
"no": "2024068",
"date": "2024-06-16",
"number": "01 02 03 04 05 06 07",
"saleAmount": "380000000",
"levels": []
}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 |
| drawNo | string | Unspecified | Unspecified | 2024068 |
Request Example
{
"type": "ssq",
"drawNo": "2024068"
}- 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 | ssq |
| name | string | Unspecified | Unspecified | 双色球 |
| no | string | Unspecified | Unspecified | 2024068 |
| date | string | Unspecified | Unspecified | 2024-06-16 |
| number | string | Unspecified | Unspecified | 01 02 03 04 05 06 07 |
| saleAmount | string | Unspecified | Unspecified | 380000000 |
| levels | array | Unspecified | Unspecified | [] |
Response Example
{
"code": "ssq",
"name": "双色球",
"no": "2024068",
"date": "2024-06-16",
"number": "01 02 03 04 05 06 07",
"saleAmount": "380000000",
"levels": []
}$.code == 200API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Capabilities
The Lottery Draw Information Query API allows developers to obtain detailed current draw information based on a specified lottery code, draw number, or draw date. The returned data includes not only the basic winning numbers but also the total sales amount for the current period, the number of winning tickets for each prize level, and the corresponding prize money per ticket, meeting comprehensive draw data display needs.
Request and Response
Request parameters include the lottery identifier (e.g., type as ssq for Double Color Ball) and the specific draw number (drawNo). In the returned JSON data, code and name represent lottery information, no and date are the draw number and draw date, the number field displays the current winning numbers, saleAmount is the sales amount, and the levels array details the winning situation for each prize level.
Use Cases
Suitable for lottery information display websites, convenience service apps, or lifestyle information platforms. It can be used to provide users with historical draw data queries, current draw details display, and prize amount verification services.