六合彩开奖开放数据接口发布:每分钟 120 次调用
2026 年 9 月 19 日,六合彩开奖 3.7.2 版本发布开放数据接口,首批提供开奖记录与统计两组端点,均返回 JSON。免费额度为每分钟 120 次调用、每日 10,000 次,平均响应时间 180 毫秒。接口读取的是同一份核验库,与客户端展示的数据完全一致,不额外做二次加工。
在此之前,需要批量数据的用户只能导出 CSV 再自行清洗。开放接口把常见需求封装成固定参数,比如按彩种与日期区间取记录、按窗口取遗漏与冷热统计。平台负责人沈嘉铭在发布说明中写道:"接口的价值是让同一份核验结果可以被反复使用,而不是让每个人重新对一遍号码。"

两组端点与主要参数
开奖记录端点 GET /v1/draws 支持四个参数:lottery(彩种标识)、from 与 to(开奖日期区间)、limit(返回条数,最大 500)、cursor(翻页游标)。返回字段包括期号、开奖日期、七个号码、和值、跨度与核验状态。统计端点 GET /v1/stats 支持 window(30 / 50 / 100 期)与 metric(遗漏、冷热、和值分区、跨度分布)。
两组端点共用相同的鉴权方式,请求头携带 X-Api-Key 即可。响应体固定包含 data、meta 与 verified 三个部分:data 是记录数组,meta 记录本次查询的口径版本与生成时间,verified 表示该批数据是否完成三路核验。口径版本号与统计口径升级公告保持一致,便于比对历史结果。
限流规则与六类错误码
限流按账户维度计算,免费额度每分钟 120 次、每日 10,000 次;标准版为每分钟 300 次、每日 50,000 次;专业版可申请每分钟 600 次。触发限流时返回 429 状态码,并在 Retry-After 头中给出建议等待秒数,客户端应读取该值而不是固定重试间隔。
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| 400 | 参数格式错误 | 检查日期格式与彩种标识 |
| 401 | 缺少或无效密钥 | 确认 X-Api-Key 请求头 |
| 403 | 额度不足或权限受限 | 查看账户用量与版本权益 |
| 404 | 彩种或期号不存在 | 先用彩种列表端点确认标识 |
| 429 | 触发限流 | 按 Retry-After 等待后重试 |
| 500 | 服务端异常 | 指数退避重试,连续失败请反馈 |
数据工程负责人蒋博文解释了限流的取值依据:"免费额度定在 120 次,是按每天同步一次全量记录估算的,正常使用很难打满;真正会触发的多是写错循环条件的脚本,429 比直接封禁更友好。"接口不提供写操作,也不返回任何用户数据。
接入示例与额度管理
一次典型的请求形如:GET https://liukaijiang.com.cn/api/v1/draws?lottery=xxx&from=2026-09-01&limit=100。响应中的 cursor 可用于翻页,直到返回空数组为止。建议客户端缓存结果并按期号去重,避免重复请求同一批数据。官方示例仅使用 curl 与原生 fetch,不依赖特定语言的 SDK。
额度与用量可在账户页查看,包含当日请求数、限流触发次数与平均响应时间。接口目前处于开放初期,字段保持向后兼容,若必须调整字段会提前 30 天在资讯中心公告,并保留旧版本至少 90 天。下一阶段计划增加按年份汇总的端点,以及批量导出任务的异步接口。
需要接入的用户可在下载页安装客户端,在"开放接口"页申请密钥;接口文档与字段说明随安装包一并提供,也可在关于我们页面联系技术支持获取。



用户评论
字段命名挺规整,verified 单独标出来这点好,能直接判断要不要用。
429 带 Retry-After 很专业,比那些只返回错误文本的接口好接。
每日 10000 次对我们小团队够了,希望以后能按年汇总一次取完。
只有 curl 示例对非开发者稍难,建议补一个 Python 的读取示例。
接口数据和客户端一致,这点最重要,不然两套数对不上没法用。