## 彩票查詢 >[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" } ] ] } ~~~