极速数据彩票开奖（Jisu Caipiao）
基于 彩票开奖 API 的 OpenClaw 技能，支持：
- 彩票开奖（
/caipiao/query） - 历史开奖信息（
/caipiao/history） - 彩票分类（
/caipiao/class） - 查询是否中奖（
/caipiao/winning）
可用于对话中回答「今晚双色球开奖号码是多少」「最近 10 期大乐透号码」「有哪些彩种」「我这注彩票中没中奖」等问题。
使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/caipiao/
环境变量配置
# Linux / macOS
export JISU_API_KEY="your_appkey_here"
# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"
脚本路径
脚本文件：skills/caipiao/caipiao.py
使用方式
1. 彩票分类（class）
python3 skills/caipiao/caipiao.py class
返回各彩种的 caipiaoid、名称、上级 ID 以及下期开奖时间等。
2. 最新或指定期彩票开奖（query）
# 最新一期
python3 skills/caipiao/caipiao.py query '{"caipiaoid":13}'
# 指定期号
python3 skills/caipiao/caipiao.py query '{"caipiaoid":13,"issueno":"2014127"}'
3. 历史开奖信息（history）
python3 skills/caipiao/caipiao.py history '{"caipiaoid":13,"start":0,"num":10}'
4. 查询是否中奖（winning）
python3 skills/caipiao/caipiao.py winning '{"caipiaoid":11,"number":"02 06 15 25 30 32","refernumber":"08"}'
请求参数摘要
/caipiao/query
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| caipiaoid | int | 是 | 彩票 ID |
| issueno | string | 否 | 期号，不传则为当前期 |
/caipiao/history
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| caipiaoid | int | 是 | 彩票 ID |
| issueno | string | 否 | 期号，不传默认当前期历史向前 |
| num | int | 否 | 获取数量，最大 20，默认 10 |
| start | int | 否 | 起始位置，默认 0 |
/caipiao/class
无请求参数。
/caipiao/winning
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| caipiaoid | string | 是 | 彩票 ID |
| issueno | string | 否 | 期号，默认最新一期 |
| number | string | 是 | 彩票号码（红球，如 20 03 05 07 22） |
| refernumber | string | 否 | 剩余号码（蓝球等） |
| type | string | 否 | 投注类型（1 直选，2 组三，3 组六） |
返回结果说明（节选）
/caipiao/query
{
"caipiaoid": "13",
"issueno": "2014127",
"number": "05 07 10 18 19 21 27",
"refernumber": "28",
"opendate": "2014-10-29",
"deadline": "2014-12-27",
"saleamount": "7482530",
"prize": [
{
"prizename": "二等奖",
"require": "中6+0",
"num": "50",
"singlebonus": "608921"
}
],
"totalmoney": "..."
}
/caipiao/history
返回对象包含 caipiaoid 和 list，list 中每期包含开奖日期、期号、号码、销售额及奖级列表。
/caipiao/class
返回彩种数组，每项如：
{
"caipiaoid": 11,
"name": "双色球",
"parentid": 1,
"nextopentime": "2025-03-09 21:30:00",
"nextbuyendtime": "2025-03-09 20:00:00",
"lastissueno": "2025024",
"nextissueno": "2025025"
}
/caipiao/winning
{
"caipiaoid": "11",
"number": "02 06 15 25 30 32",
"refernumber": "08",
"issueno": "2016081",
"winstatus": "0",
"prizename": "二等奖",
"require": "中6+0",
"singlebonus": "239666",
"winnumber": "02 06 15 25 30 32",
"winrefernumber": "07"
}
错误返回示例
{
"error": "api_error",
"code": 201,
"message": "彩票ID为空"
}
常见错误码
来源于 极速数据彩票开奖文档：
| 代号 | 说明 |
|---|---|
| 201 | 彩票 ID 为空 |
| 202 | 彩票号码为空 |
| 203 | 不支持的彩种 |
| 210 | 没有信息 |
系统错误码：101 APPKEY 为空或不存在、102 已过期、103 无权限、104 超过次数限制、105 IP 被禁止、106 IP 超限、107 接口维护中、108 接口已停用。
在 OpenClaw 中的推荐用法
- 用户：「今晚双色球开奖号码」→ 先用
class找到双色球的caipiaoid（通常为 11），再调用query并格式化展示中奖号码及奖池。 \n - 用户：「最近 10 期大乐透走势」→ 使用
history拉取最近若干期数据，提取号码并可视化（折线/表格）。 \n - 用户：「帮我看看这注是否中奖」→ 使用
winning，将用户提供的号码和期号（可选）传入，并根据winstatus、prizename、singlebonus给出自然语言反馈。 \n - 用户：「支持哪些彩种」→ 调用
class，罗列所有name与对应caipiaoid，方便后续对话使用 ID 进行精确查询。