两种用法
① 直接调用(推荐):不需要密钥,直接请求接口即可,每分钟 60 次
② 带密钥调用:申请 API Key 后,请求头加 X-API-KEY: 你的密钥,
额度提高到每分钟 120 次,并可限定只访问指定彩种
无论哪种方式,调用都会被记录(接口、彩种、来源 IP、时间),便于排查问题。
接口一览
| 接口 | 说明 |
GET /open/v1/games | 彩种列表(key / 名称 / 分类) |
GET /open/v1/draws | 开奖列表,最新在前 |
GET /open/v1/latest | 最新一期 |
GET /open/v1/export | 历史数据下载(CSV / JSON) |
draws / latest 参数
| 参数 | 必填 | 说明 |
game | 是 | 彩种 key,例如 bg-lhc、lhc、trx-race |
limit | 否 | 每页条数,1~200,默认 20 |
page | 否 | 页码,默认 1 |
issue | 否 | 按期号查询,例如 2026115 |
date | 否 | 按日期查询,格式 2026-10-27 |
export 参数
| 参数 | 必填 | 说明 |
game | 是 | 彩种 key |
format | 否 | csv(默认)或 json |
date | 否 | 只导出某一天,例如 2026-10-27 |
直接返回文件下载,CSV 列:期号、日期、号码、区块高度、哈希。示例:
/open/v1/export?game=lhc&format=csv
返回示例
{
"ok": true,
"game": "lhc",
"name": "香港六合彩",
"total": 249,
"page": 1,
"limit": 3,
"items": [
{
"issue": "2026115",
"date": "2026-10-27 21:32",
"nums": [2, 4, 18, 21, 24, 47, 31],
"block": null,
"hash": null
}
]
}
链上彩种(trx-*)会额外返回 block(区块高度)和 hash(区块哈希),可自行上链核对。
错误返回
401 | 缺少或无效的 API Key |
403 | 该 Key 无此彩种权限 |
404 | 彩种不存在 |
429 | 调用太频繁(匿名每分钟 60 次,带 Key 120 次) |