## 彩票查询 >[danger]### 免费接口，每日100次免费调用，会员可不限次数调用，购买[API会员](https://market.topthink.com/product/210)  > 目前支持双色球、大乐透、七乐彩、七星彩、福彩3D、排列3、排列5，数据来源于网络公开，开奖结果获取可能会有一定的延时。 ## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)） ## 接口1：支持彩种列表 ### 请求地址 ``` GET https://api.topthink.com/lottery/types ``` ### 请求参数 无 ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | 见JSON返回示例 | \- | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->lotteryTypes() ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功的返回", "data": [ { "lottery_id": "ssq", "lottery_name": "双色球", "lottery_type_id": "1", "remarks": "每周二、四、日开奖" }, { "lottery_id": "dlt", "lottery_name": "超级大乐透", "lottery_type_id": "2", "remarks": "每周一、三、六开奖" }, { "lottery_id": "qlc", "lottery_name": "七乐彩", "lottery_type_id": "1", "remarks": "每周一、三、五开奖" }, { "lottery_id": "fcsd", "lottery_name": "福彩3D", "lottery_type_id": "1", "remarks": "每日开奖" }, { "lottery_id": "qxc", "lottery_name": "七星彩", "lottery_type_id": "2", "remarks": "每周二、五、日开奖" }, { "lottery_id": "pls", "lottery_name": "排列3", "lottery_type_id": "2", "remarks": "每日开奖" }, { "lottery_id": "plw", "lottery_name": "排列5", "lottery_type_id": "2", "remarks": "每日开奖" } ] } ~~~ ## 接口2：彩票开奖结果查询 ### 请求地址 ``` GET https://api.topthink.com/lottery/query ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | lotteryId | 是 | string | 彩票ID | | lotteryNo | 否 | string | 彩票期号，默认最新一期 | ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | 见JSON返回示例 | \- | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->lotteryQuery() ->withLotteryId('ssq') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功的返回", "data": [ "lottery_id": "ssq", "lottery_name": "双色球", "lottery_res": "03,08,11,14,18,23,16", "lottery_no": "18028", "lottery_date": "2018-03-13", "lottery_exdate": "2018-05-11", "lottery_sale_amount": "352,015,830", "lottery_pool_amount": "578,094,167", "lottery_prize": [ { "prize_name": "一等奖", "prize_num": "7", "prize_amount": "7,676,997", "prize_require": "6+1" }, { "prize_name": "二等奖", "prize_num": "220", "prize_amount": "106,471", "prize_require": "6+0" }, { "prize_name": "三等奖", "prize_num": "1869", "prize_amount": "3,000", "prize_require": "5+1" }, { "prize_name": "四等奖", "prize_num": "82708", "prize_amount": "200", "prize_require": "5+0,4+1" }, { "prize_name": "五等奖", "prize_num": "1493643", "prize_amount": "10", "prize_require": "4+0,3+1" }, { "prize_name": "六等奖", "prize_num": "8341565", "prize_amount": "5", "prize_require": "2+1,1+1,0+1" } ] ] } ~~~ ## 接口3：历史开奖结果查询 ### 请求地址 ``` GET https://api.topthink.com/lottery/history ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | lotteryId | 是 | string | 彩票ID | | pageSize | 否 | string | 每次返回条数，默认10，最大50 | | page | 否 | string | 当前页数，默认1 | ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | 见JSON返回示例 | \- | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->lotteryHistory() ->withLotteryId('ssq') ->withPagesize('2') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功的返回", "data": [ "lotteryResList":[ { "lottery_id":"ssq", "lottery_res":"03,07,16,17,23,30,07", "lottery_no":"20084", "lottery_date":"2020-09-01", "lottery_exdate":"2020-10-30", "lottery_sale_amount":"340,223,360", "lottery_pool_amount":"997,837,500" }, { "lottery_id":"ssq", "lottery_res":"01,19,25,26,30,31,12", "lottery_no":"20083", "lottery_date":"2020-08-30", "lottery_exdate":"2020-10-28", "lottery_sale_amount":"375,628,538", "lottery_pool_amount":"1,046,377,044" } ], "page":1, "pageSize":2, "totalPage":1296 ] } ~~~ ## 接口4：中奖计算器 ### 请求地址 ``` GET https://api.topthink.com/lottery/bonus ``` ### 请求参数 | 名称 | 必填 | 类型 | 说明 | | --- | --- | --- | --- | | appCode| 是| string|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) | | lotteryId | 是 | string | 彩票ID | | lotteryRes | 是 | string | 购买的号码，号码之间用英文逗号隔开，红色球和蓝色求之间用@连接，例如：01,11,02,09,14,22,25@05,03 | | lotteryNo | 否 | string | 开奖期数，默认最新一期 | ### 返回参数 | 名称 | 类型 | 说明 | | --- | --- | --- | | 见JSON返回示例 | \- | ## SDK调用 ``` $client = new Client("YourAppCode"); $result = $client->lotteryBonus() ->withLotteryId('ssq') ->withLotteryRes('01,11,02,09,14,22,25@05,03') ->request(); ``` 返回示例： ~~~ { "code":0, "message": "成功的返回", "data": [ "lottery_id": "ssq", "lottery_name": "双色球", "lottery_no": "18029", "lottery_date": "2018-03-15", "real_lottery_res": "01,02,09,14,22,25,05", "lottery_res": "01,11,02,09,14,22,25@05,03", "in_money": "28", "buy_red_ball_num": "7", "buy_blue_ball_num": "2", "hit_red_ball_num": "6", "hit_blue_ball_num": "1", "is_prize": "1", "prize_msg": "恭喜您中奖了", "lottery_prize": [ { "prize_name": "一等奖", "prize_require": "6+1", "prize_num": "1", "prize_money": "8,926,329" }, { "prize_name": "二等奖", "prize_require": "6+0", "prize_num": "1", "prize_money": "288,700" }, { "prize_name": "三等奖", "prize_require": "5+1", "prize_num": "6", "prize_money": "3,000" }, { "prize_name": "四等奖", "prize_require": "4+1,5+0", "prize_num": "6", "prize_money": "200" } ] ] } ~~~