台灣運彩賠率 API - 文件說明

📌 此文件已過期，請使用第二代運彩 API


# API Endpoint

https://api.sportsbot.tech/odds_movements

我們是 JBot 運彩分析，是全國唯一台彩走勢與分析的數據網站，鼓勵大家購買台灣彩券，看比賽可以更精彩。為了避免台灣運彩官方網站的流量負擔，此文件提供會員使用程式查詢美國職籃 NBA、美國大聯盟 MLB、日本職棒 NPB、韓國職棒 KBO、中華職棒 CPB、各式足球、網球、冰球的即時賠率與歷史記錄（請遵守服務條款）。

如何使用


# Python 範例：執行 API

import requests

sport = 'NBA'
game_date = '2024-02-23' # 請更改至一個月內的日期
access_token = 'YOUR_API_KEY'
endpoint = 'https://api.sportsbot.tech/odds_movements'

url = endpoint + '/' + sport + '/' + game_date
params = {'access_token': access_token}
response = requests.get(url, params=params)

print(response.text)

API 的網址如下，必須加上<運動>與<日期>與密鑰三個必填參數：
https://api.sportsbot.tech/odds_movements/<sport>/<game_date>?access_token=YOUR_API_KEY

舉例：

💡 每次呼叫必須間隔 5 秒以上


# 得到的內容（部分省略）

{
  "header": {
    "expiry_date": "2022-12-31", 
    "remain_count_today": 19, 
    "status": "SUCCESS", 
    "user": "Trial User"
  },
  "data": {

    "01:05巴爾地摩金鶯": {

      "info": {
        "away": "芝加哥白襪", 
        "home": "巴爾地摩金鶯", 
        "lottery_id": "255", 
        "time": "2021-07-12T01:05"
      }, 

      "odds": [
        {
          "away_handi": 1.75, 
          "away_is_plus": 0, 
          "away_normal": 1.45, 
          "big": 1.65, 
          "home_handi": 1.75, 
          "home_normal": 2.15, 
          "small": 1.85, 
          "total": 10.5, 
          "update_time": "2021-07-11T11:58"
        }, 
        {
          "away_handi": 1.55, 
          "away_is_plus": 0, 
          "away_normal": 1.4, 
          "big": 1.9, 
          "home_handi": 1.95, 
          "home_normal": 2.3, 
          "small": 1.6, 
          "total": 10.5, 
          "update_time": "2021-07-11T21:18"
        }
      ], 
      
      "score": {
        "away": 7, 
        "home": 5
      }

    }

    "01:10克里夫蘭印地安人": {

      "info": {
        "away": "堪薩斯皇家", 
        "home": "克里夫蘭印地安人", 
        "lottery_id": "259", 
        "time": "2021-07-12T01:10"
      }, 

      "odds": [
        {
          "away_handi": 1.5, 
          "away_is_plus": 1, 
          "away_normal": 2.05, 
          "big": 1.75, 
          "home_handi": 2.05, 
          "home_normal": 1.5, 
          "small": 1.75, 
          "total": 9.5, 
          "update_time": "2021-07-11T22:38"
        }
      ]

      # 因延賽，無比賽結果
    }, 
  }
}

以下三個皆為必填參數

名稱	描述
<sport>	任選下列其中一種聯盟 `NBA`：美國職籃 `MLB`：美國大聯盟 `NPB`：日本職棒 `KBO`：韓國職棒 `CPB`：中華職棒 `FTB`：足球 `TNS`：網球 `ICE`：冰球
<game_date>	欲查詢的日期，必須按照此格式 `YYYY-MM-DD`：如`2020-08-01` 免費密鑰為（過去30天~明天）、訂閱密鑰為（過去180天~明天）
access_token	輸入您的密鑰

以下一個為選填參數

名稱	描述
alliance	限 <sport> 為 `FTB` 、 `TNS` 或 `ICE` 時有效，可篩選聯盟名稱與 access_token 設定於相同位置，如： `data = {'access_token': access_token, 'alliance': '英格蘭超級聯賽'}`

回傳格式為 JSON 字串

名稱	項目	描述
header	expiry_date	密鑰的過期日，格式為`YYYY-MM-DD`
	remain_count_today	當日剩餘的使用次數，免費密鑰每日 20 次
	status	`SUCCESS`正常執行，其他可參考錯誤代碼
	user	免費用戶 Trial User，或訂閱會員的信箱
data	比賽名稱	比賽時間+主場隊伍全名如：`13:00中日龍`、`10:00洛杉磯湖人`
	info	比賽資訊 `away`：客場名稱 `home`：主場名稱 `lottery_id`：台彩賽事編號 `time`：比賽時間 `alliance`：足球聯盟名稱
	odds	賠率使用陣列 list 堆疊，項目如下 `away_is_plus`：客場是否為受讓方 `away_handi`：客場讓分盤的賠率值 `away_normal`：客場不讓分盤的賠率值 `home_handi`：主場讓分盤的賠率值 `home_normal`：主場不讓分盤的賠率值 `total`：總分盤的界線值 `big`：大分賠率 `small`：小分賠率 `update_time`：賠率更新時間籃球和網球則又包含： `handi`：讓分值。棒球均為1.5、足球均為1，省略此項足球、網球和冰球則可能又包含： `big_15`：1.5大分賠率 `big_25`：2.5大分賠率 `big_35`：3.5大分賠率 `small_15`：1.5小分賠率 `small_25`：2.5小分賠率 `small_35`：3.5小分賠率 `num_024`：總分偶數賠率 `num_135`：總分奇數賠率 `tie_handi`：讓分盤和局賠率 `tie_normal`：不讓分盤和局賠率
	score	若完賽，會顯示比分 `away`：客場得分 `home`：主場得分

※ 若該玩法未開盤，賠率會顯示 0

錯誤代碼


# Python 範例：取得項目

import json

result = json.loads(response.text)

# 當日所有的比賽名稱
print(list(result['data'].keys()))

# 顯示該比賽的賠率記錄
print(result['data']['17:00阪神虎'])

# 查看代碼
print(result['header']['status'])

# 今日剩餘次數
print(result['header']['remain_count_today'])

正常執行會顯示代碼 SUCCESS，其他錯誤訊息可參考下表：

錯誤代碼	描述
WARNING_01	當日無比賽或比賽尚未開盤
ERROR_00	未夾帶 `access_token` 參數
ERROR_01	錯誤的密鑰
ERROR_02	`<sport>`的名稱有誤，限`NBA`、`MLB`、`NPB`、`KBO`、`CPB`、`FTB`、`TNS`
ERROR_03	`<game_date>`的格式有誤，必須是`YYYY-MM-DD`
ERROR_04	超過每日限定額度
ERROR_05	訂閱已到期
ERROR_06	欲查詢的日期超過限制，免費密鑰為（過去30天~明天）、訂閱密鑰為（過去180天~明天）
ERROR_07	執行 API 的間隔時間小於 5 秒
ERROR_08	伺服器異常，請稍後再試

取得密鑰

此文件已過期，請使用第二代運彩 API。

服務條款

本服務限於學術研究、數據分析等用途，賠率資料為台灣運彩所擁有，本站僅就資料庫與伺服器之硬體設備進行收費，亦不保證資料的正確性與完整性，如因此導致任何其他責任皆由使用者自行負責，概與本站無涉。

聯絡信箱

sportsbot.tw@gmail.com