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


# API Endpoint

https://api.sportsbot.tech/odds_movements
                	

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

本站提供免費的密鑰,每天能使用 20 次,並可查詢三種球賽過去 30 天的資料。如有更多用量需求,請點選取得密鑰查看相關資訊。

如何使用


# Python 範例:執行 API

import requests

sport = 'NPB'
game_date = '2020-07-11' # 請更改至一個月內的日期
access_token = 'FREE_TEST_KEY_FOR_20_TIMES_PER_DAY'
endpoint = 'https://api.sportsbot.tech/odds_movements'

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

print(response.text)
                

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

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

# 得到的內容(部分省略)

{
  "header": {
    "expiry_date": "2020-12-31", 
    "remain_count_today": 19, 
    "status": "SECCESS", 
    "user": "Trial User"
  },
  "data": {
    "13:00中日龍": [
      {
        "away_handi": 1.9, 
        "away_is_plus": 0, 
        "away_normal": 1.55, 
        "big": 1.85, 
        "home_handi": 1.6, 
        "home_normal": 1.95, 
        "small": 1.65, 
        "total": 8.5, 
        "update_time": "2020-07-11T09:25"
      }
    ], 
    "17:00阪神虎": [
      {
        "away_handi": 2.15, 
        "away_is_plus": 0, 
        "away_normal": 1.7, 
        "big": 1.7, 
        "home_handi": 1.45, 
        "home_normal": 1.8, 
        "small": 1.8, 
        "total": 6.5, 
        "update_time": "2020-07-11T09:25"
      }, 
      {
        "away_handi": 2.05, 
        "away_is_plus": 0, 
        "away_normal": 1.65, 
        "big": 1.7, 
        "home_handi": 1.5, 
        "home_normal": 1.85, 
        "small": 1.8, 
        "total": 6.5, 
        "update_time": "2020-07-11T16:25"
      }
    ]
  }
}
                

以下三個皆為必填參數

名稱 描述
<sport> 任選下列其中一種聯盟
NBA:美國職籃
MLB:美國大聯盟
NPB:日本職棒
<game_date> 欲查詢的日期,必須按照此格式
YYYY-MM-DD:如2020-08-01
免費密鑰為(過去30天~明天)、訂閱密鑰為(過去180天~明天)
access_token 輸入您的密鑰或使用免費但具有限制的 FREE_TEST_KEY_FOR_20_TIMES_PER_DAY

回傳格式為 JSON 字串

名稱 項目 描述
header expiry_date 密鑰的過期日,格式為YYYY-MM-DD
remain_count_today 當日剩餘的使用次數,免費密鑰每日 20 次
status SECCESS正常執行,其他可參考錯誤代碼
user 免費用戶 Trial User,或訂閱會員的信箱
data 比賽名稱 比賽時間+主場隊伍全名
如:13:00中日龍10:00洛杉磯湖人
賠率使用陣列 list 堆疊,項目如下
away_is_plus:客場是否為受讓方
away_handi:客場讓分盤的賠率值
away_normal:客場不讓分盤的賠率值
home_handi:主場讓分盤的賠率值
home_normal:主場不讓分盤的賠率值
total:總分盤的界線值
big:大分賠率
small:小分賠率
update_time:賠率更新時間

錯誤代碼


# 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'])
                

正常執行會顯示代碼 SECCESS,其他錯誤訊息可參考下表:

錯誤代碼 描述
WARNING_01 當日無比賽或比賽尚未開盤
ERROR_00 未夾帶 access_token 參數
ERROR_01 錯誤的密鑰
ERROR_02 <sport>的名稱有誤,限NBAMLBNPB
ERROR_03 <game_date>的格式有誤,必須是YYYY-MM-DD
ERROR_04 超過每日限定額度
ERROR_05 訂閱已到期
ERROR_06 欲查詢的日期超過限制,免費密鑰為(過去30天~明天)、訂閱密鑰為(過去180天~明天)
ERROR_07 執行 API 的間隔時間小於 5 秒

取得密鑰

免費密鑰為所有人共同使用與計次,如有更多用量需求,可參考下列方案說明,如欲訂閱,請私訊 Facebook 粉絲頁

方案 可查詢日期 限額 球種 價錢
試用 過去30天~明天 20 次/日 NBA、MLB、NPB 免費
訂閱 過去180天~明天 300 次/日 NBA、MLB、NPB 1,000 元/月

服務條款

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

聯絡信箱

sportsbot.tw@gmail.com