711开奖网
711开奖网
文档目录

711开奖数据 API

v1

稳定、实时、可追溯的开奖数据服务。使用 OpenAPI 规范描述接口，并通过 HMAC-SHA256 验证每一次请求。

在线 / 稳定运行Base URLhttps://711kj.com/api/v1
下载 OpenAPI JSON
01

快速开始

三个步骤完成第一次签名请求。

  1. 获取凭据联系管理员创建 API Key；Secret 只在安全交付时提供一次。
  2. 生成签名按固定顺序拼接方法、路径、原始查询、时间戳和随机 Nonce。
  3. 发起请求携带四个签名请求头，并保留响应中的 request_id 便于排查。
import hashlib
import hmac
import os
import secrets
from datetime import datetime, timezone

import requests

api_key = os.environ["API_KEY"]
secret = os.environ["API_SECRET"]
method = "GET"
path = "/api/v1/result/latest"
query = "lottery=SSQ&limit=1"
timestamp = datetime.now(timezone.utc).isoformat().replace("+00:00", "Z")
nonce = secrets.token_hex(16)
canonical = "\n".join([method, path, query, timestamp, nonce])
signature = hmac.new(secret.encode(), canonical.encode(), hashlib.sha256).hexdigest()

response = requests.get("https://711kj.com/api/v1/result/latest?lottery=SSQ&limit=1", headers={
    "X-API-Key": api_key,
    "X-Timestamp": timestamp,
    "X-Nonce": nonce,
    "X-Signature": signature,
}, timeout=10)
response.raise_for_status()
print(response.json())
02

身份认证

所有核心 `/api/v1` 数据接口均使用 HMAC-SHA256 请求签名。

必需请求头

X-API-Key
API Key 前缀，用于定位凭据。
X-Timestamp
RFC3339 UTC 时间，允许服务器时间前后偏差5分钟。
X-Nonce
每次请求使用新的随机值，10分钟内不得重复。
X-Signature
canonical 字符串的 HMAC-SHA256 小写十六进制摘要。

Canonical String

METHOD
PATH
RAW_QUERY
RFC3339_TIMESTAMP
NONCE

Secret 只能保存在服务端或密钥管理系统中，不要写入网页、移动端包或公开仓库。

03

接口参考

基础信息

彩种、规则与首页分类元数据。

2 个接口
GET/api/v1/lottery/list获取彩种列表

返回所有已启用彩种、最新期号、采集状态和号码区域规则。

请求参数

此接口没有业务参数。

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": [
    {
      "id": 6,
      "code": "SSQ",
      "name": "福彩双色球",
      "category": "national",
      "enabled": true,
      "latest_issue": "2026094",
      "latest_draw_time": "2026-08-16T13:15:00Z",
      "collection_status": "healthy",
      "result_schema": {
        "zones": [
          {
            "code": "red",
            "count": 6,
            "min": 1,
            "max": 33,
            "unique": true
          },
          {
            "code": "blue",
            "count": 1,
            "min": 1,
            "max": 16,
            "unique": true
          }
        ]
      }
    }
  ],
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/lottery/list"
QUERY=""
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/lottery/list" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
GET/api/v1/content/lottery-categories获取彩种分类

返回开奖大厅使用的分类顺序及分类内彩种代码。

请求参数

此接口没有业务参数。

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": [
    {
      "id": 1,
      "code": "national",
      "name": "全国彩",
      "sort_order": 10,
      "enabled": true,
      "lottery_codes": [
        "FC3D",
        "PL3",
        "SSQ",
        "DLT"
      ]
    }
  ],
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/content/lottery-categories"
QUERY=""
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/content/lottery-categories" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

开奖数据

最新开奖、历史记录、单期详情与走势图。

4 个接口
GET/api/v1/result/latest获取最新开奖

按开奖时间倒序返回最新已发布结果；指定 lottery 时只返回该彩种。

请求参数

名称位置类型说明
lotteryquerystring彩种代码，如 SSQ、TWBINGO、CA28示例：SSQ
limitqueryinteger返回数量，1–50，默认 10示例：1

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": [
    {
      "id": 1284201,
      "lottery_id": 6,
      "lottery_code": "SSQ",
      "lottery_name": "福彩双色球",
      "issue": "2026094",
      "draw_time": "2026-08-16T13:15:00Z",
      "status": "published",
      "version": 1,
      "published_at": "2026-08-16T13:15:08Z",
      "numbers": [
        {
          "zone": "red",
          "position": 1,
          "value": 5
        },
        {
          "zone": "red",
          "position": 2,
          "value": 8
        },
        {
          "zone": "blue",
          "position": 1,
          "value": 9
        }
      ]
    }
  ],
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/result/latest"
QUERY="lottery=SSQ&limit=1"
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/result/latest?lottery=SSQ&limit=1" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
GET/api/v1/result/history查询历史开奖

使用游标分页查询历史记录，可按期号或 RFC3339 时间范围过滤。

请求参数

名称位置类型说明
lottery必填querystring彩种代码示例：SSQ
issuequerystring精确期号示例：2026094
cursorquerystring上一页响应中的 next_cursor示例：eyJkcmF3X3RpbWUiOi...
fromquerystring起始时间，RFC3339，包含示例：2026-08-01T00:00:00+08:00
toquerystring结束时间，RFC3339，不包含示例：2026-09-01T00:00:00+08:00
limitqueryinteger每页数量，1–100，默认 30示例：30

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": {
    "items": [
      {
        "id": 1284201,
        "lottery_id": 6,
        "lottery_code": "SSQ",
        "lottery_name": "福彩双色球",
        "issue": "2026094",
        "draw_time": "2026-08-16T13:15:00Z",
        "status": "published",
        "version": 1,
        "published_at": "2026-08-16T13:15:08Z",
        "numbers": [
          {
            "zone": "red",
            "position": 1,
            "value": 5
          },
          {
            "zone": "red",
            "position": 2,
            "value": 8
          },
          {
            "zone": "blue",
            "position": 1,
            "value": 9
          }
        ]
      }
    ],
    "next_cursor": "eyJkcmF3X3RpbWUiOiIyMDI2LTA4LTE2VDEzOjE1OjAwWiIsImlkIjoxMjg0MjAxfQ",
    "has_more": true
  },
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/result/history"
QUERY="lottery=SSQ&limit=30"
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/result/history?lottery=SSQ&limit=30" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
GET/api/v1/result/{code}/{issue}获取单期开奖详情

按彩种代码和期号返回完整开奖对象，包括号码区域和奖级信息。

请求参数

名称位置类型说明
code必填pathstring彩种代码示例：SSQ
issue必填pathstring开奖期号示例：2026094

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制
  • 404期号不存在

响应示例

{
  "data": {
    "id": 1284201,
    "lottery_id": 6,
    "lottery_code": "SSQ",
    "lottery_name": "福彩双色球",
    "issue": "2026094",
    "draw_time": "2026-08-16T13:15:00Z",
    "status": "published",
    "version": 1,
    "published_at": "2026-08-16T13:15:08Z",
    "numbers": [
      {
        "zone": "red",
        "position": 1,
        "value": 5
      },
      {
        "zone": "red",
        "position": 2,
        "value": 8
      },
      {
        "zone": "blue",
        "position": 1,
        "value": 9
      }
    ]
  },
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/result/SSQ/2026094"
QUERY=""
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/result/SSQ/2026094" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
GET/api/v1/chart/trend获取号码走势

返回指定彩种最近若干期的号码序列，适合绘制走势、遗漏和值图。

请求参数

名称位置类型说明
lottery必填querystring彩种代码示例：CA28
limitqueryinteger样本期数，1–1000，默认 30示例：100

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": [
    {
      "issue": "3470981",
      "draw_time": "2026-08-18T05:59:00Z",
      "numbers": [
        {
          "zone": "main",
          "position": 1,
          "value": 7
        },
        {
          "zone": "main",
          "position": 2,
          "value": 6
        },
        {
          "zone": "main",
          "position": 3,
          "value": 7
        }
      ]
    }
  ],
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/chart/trend"
QUERY="lottery=CA28&limit=100"
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/chart/trend?lottery=CA28&limit=100" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"

数据分析

频率、遗漏、回测与历史同期对比。

2 个接口
GET/api/v1/analysis/statistics获取统计分析

计算频率、当前遗漏、最大遗漏、平均遗漏和基础回测结果。

请求参数

名称位置类型说明
lottery必填querystring彩种代码示例：CA28
limitqueryinteger样本期数，1–1000，默认 100示例：100
numbersquerystring逗号分隔的回测号码示例：7,6,7

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": {
    "statistics": [
      {
        "zone": "main",
        "frequency": {
          "0": 28,
          "1": 34,
          "7": 31
        },
        "current_omission": {
          "0": 2,
          "1": 0,
          "7": 0
        },
        "max_omission": {
          "0": 11,
          "1": 8,
          "7": 9
        },
        "average_omission": {
          "0": 2.4,
          "1": 1.9,
          "7": 2.1
        },
        "summary": {
          "odd": 151,
          "even": 149
        }
      }
    ],
    "sample_size": 100,
    "backtest": {
      "numbers": [
        7,
        6,
        7
      ],
      "sample_size": 100,
      "match_count": 1,
      "match_rate": 1,
      "current_omission": 0,
      "max_omission": 73
    },
    "disclaimer": "仅描述历史数据，不构成预测或投注建议。"
  },
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/analysis/statistics"
QUERY="lottery=CA28&limit=100&numbers=7%2C6%2C7"
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/analysis/statistics?lottery=CA28&limit=100&numbers=7%2C6%2C7" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
GET/api/v1/analysis/same-period查询历史同期

按期号尾数查找同一彩种的历史同期记录。

请求参数

名称位置类型说明
lottery必填querystring彩种代码示例：SSQ
suffix必填querystring1–8位数字期号尾数示例：094
limitqueryinteger返回数量，默认 30示例：30

响应状态

  • 200请求成功
  • 400参数格式不正确
  • 401签名缺失或无效
  • 429超过请求速率限制

响应示例

{
  "data": [
    {
      "id": 1284201,
      "lottery_id": 6,
      "lottery_code": "SSQ",
      "lottery_name": "福彩双色球",
      "issue": "2026094",
      "draw_time": "2026-08-16T13:15:00Z",
      "status": "published",
      "version": 1,
      "published_at": "2026-08-16T13:15:08Z",
      "numbers": [
        {
          "zone": "red",
          "position": 1,
          "value": 5
        },
        {
          "zone": "red",
          "position": 2,
          "value": 8
        },
        {
          "zone": "blue",
          "position": 1,
          "value": 9
        }
      ]
    }
  ],
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}

请求示例

API_KEY="your_key_prefix"
API_SECRET="your_api_secret"
TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
NONCE=$(openssl rand -hex 16)
METHOD="GET"
PATH_VALUE="/api/v1/analysis/same-period"
QUERY="lottery=SSQ&suffix=094&limit=30"
CANONICAL=$(printf '%s\n%s\n%s\n%s\n%s' "$METHOD" "$PATH_VALUE" "$QUERY" "$TIMESTAMP" "$NONCE")
SIGNATURE=$(printf '%s' "$CANONICAL" | openssl dgst -sha256 -hmac "$API_SECRET" -hex | awk '{print $2}')

curl -sS "https://711kj.com/api/v1/analysis/same-period?lottery=SSQ&suffix=094&limit=30" \
  -H "X-API-Key: $API_KEY" \
  -H "X-Timestamp: $TIMESTAMP" \
  -H "X-Nonce: $NONCE" \
  -H "X-Signature: $SIGNATURE"
04

数据模型

所有成功响应使用统一 envelope，开奖号码按 zone 与 position 保持顺序。

Draw

单期开奖对象：彩种、期号、开奖时间、版本和号码。

DrawNumber

号码区域、区域内位置和整数值。

Lottery

彩种元数据、采集状态和号码区域规则。

CursorPage<Draw>

历史记录游标分页：items、next_cursor、has_more。

{
  "data": {
    "id": 1284201,
    "lottery_code": "SSQ",
    "lottery_name": "福彩双色球",
    "issue": "2026094",
    "draw_time": "2026-08-16T13:15:00Z",
    "status": "published",
    "version": 1,
    "numbers": [
      {
        "zone": "red",
        "position": 1,
        "value": 5
      },
      {
        "zone": "blue",
        "position": 1,
        "value": 9
      }
    ]
  },
  "request_id": "4f49b1e71b3d42e99f88a5bf2f00d91a"
}
05

错误码

错误响应包含稳定的机器码、可读消息和 request_id。

HTTP错误码说明
400INVALID_INPUT请求参数、时间或号码格式错误
401SIGNATURE_REQUIRED缺少四个签名请求头
401SIGNATURE_INVALIDKey、Secret、签名或时间戳无效
403IP_DENIED请求来源不在 API Key 的IP白名单
404NOT_FOUND彩种、期号或内容不存在
409REPLAYED_REQUESTNonce 在10分钟窗口内已使用
429RATE_LIMITED超过IP或API Key令牌桶配额
500INTERNAL_ERROR服务内部错误，联系支持时提供 request_id
06

速率限制与稳定性

IP 与 API Key 同时受令牌桶限制，以更严格的配额为准。

默认 QPS 3

每秒稳定补充3个请求令牌。

默认 Burst 10

短时间最多连续消耗10个令牌，不会提高长期速率。

HTTP 429

响应包含 Retry-After 和 RateLimit 头，请降低并发并指数退避。

历史分页建议始终使用 next_cursor 继续读取；不要自行构造游标，也不要用高并发遍历全部历史。客户端应设置10秒超时、有限重试并记录 request_id。