台灣運彩賠率 API
台灣運彩是台灣唯一合法的體育投注莊家，期望與國人一起關心運動賽事，透過運動彩券發行產生的盈餘，能夠持續挹注國內運動產業的發展。賠率反應著賽事的結果，透過數值變化，可推測項目熱度與趨勢。以下服務為從開盤到賽前的完整賠率記錄，包含讓分、不讓分、總分盤、角球等項目。
如何使用
| 服務端點 | |
| GET | https://api.sportsbot.tech/v2/odds |
| 參數 | 內容 |
|
必填 sport |
String 賽事類型，支援下列幾種聯盟 |
|
必填 date |
String 日期，限定格式YYYY-MM-DD |
|
選填 mode |
String 賠率涵蓋範圍 |
程式範例
Note
試用密鑰每日限額 20 次，其餘規範請參考密鑰說明，並取得您的專屬密鑰。
import requests
params = {'sport': 'FTB', # 選擇賽事
'date': 'YYYY-MM-DD', # 指定日期
'mode': 'close'} # close, open, both, all
headers = {'X-JBot-Token': 'YOUR_TOKEN'} # 填寫密鑰
url = 'https://api.sportsbot.tech/v2/odds'
res = requests.get(url, headers=headers, params=params)
print(res.json())
const axios = require('axios');
async function run(){
const params = {
sport: 'FTB', // 選擇賽事
date: 'YYYY-MM-DD', // 指定日期
mode: 'close' // close, open, both, all
};
const headers = {'X-JBot-Token': 'YOUR_TOKEN'}; // 填寫密鑰
const url = 'https://api.sportsbot.tech/v2/odds';
try{
const response = await axios.get(url, {params, headers});
console.log(response.data);
}catch(error){
console.error(error.message);
}
}
run();
require 'uri'
require 'json'
require 'net/http'
params = {
'sport' => 'FTB', # 選擇賽事
'date' => 'YYYY-MM-DD', # 指定日期
'mode' => 'close' # close, open, both, all
}
url = URI('https://api.sportsbot.tech/v2/odds')
url.query = URI.encode_www_form(params)
request = Net::HTTP::Get.new(url)
request['X-JBot-Token'] = 'YOUR_TOKEN' # 填寫密鑰
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
response = http.request(request)
puts JSON.parse(response.body)
using System;
using System.Net.Http;
using System.Threading.Tasks;
using System.Collections.Generic;
using System.Linq;
class Program
{
static async Task Main(string[] args)
{
var client = new HttpClient();
var parameters = new Dictionary<string, string>
{
{"sport", "FTB"}, // 選擇賽事
{"date", "YYYY-MM-DD"}, // 指定日期
{"mode", "close"} // close, open, both, all
};
var url = "https://api.sportsbot.tech/v2/odds?" + ToQueryString(parameters);
var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.Add("X-JBot-Token", "YOUR_TOKEN"); // 填寫密鑰
HttpResponseMessage response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
}
static string ToQueryString(Dictionary<string, string> parameters)
{
var keyValuePairs = parameters.Select(kv => $"{Uri.EscapeDataString(kv.Key)}={Uri.EscapeDataString(kv.Value)}");
return string.Join("&", keyValuePairs);
}
}
<?php
$params = [
'sport' => 'FTB', // 選擇賽事
'date' => 'YYYY-MM-DD', // 指定日期
'mode' => 'close' // close, open, both, all
];
$url = 'https://api.sportsbot.tech/v2/odds?' . http_build_query($params);
$headers = ['X-JBot-Token: YOUR_TOKEN']; // 填寫密鑰
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
echo $response;
curl_close($ch);
?>
回傳格式
回傳均為 JSON 格式，範例如下：
{
"status": "OK", // 狀態，"OK"或其他錯誤訊息
"user": {
"day_limit": 300, // 每日限額
"day_used": 1, // 已使用次數
"email": "Trial User", // 訂閱者信箱
"expiry": "2025-12-31" // 訂閱期限
},
"data": [ // 回傳資料為 list，包含每場賽事資訊
{
"id": "300", // 台灣運彩賽事編號
"time": "2024-02-23T08:00", // 開賽時間
"away": "奧蘭多魔術", // 客場名稱
"home": "克里夫蘭騎士", // 主場名稱
"league": "美國職籃", // 聯盟名稱
// 賠率 odds 為 list
// 若 mode 為 open 或 close，陣列數量為 1
// 若 mode 為 both，陣列數量為 2 或 1 (開盤後只有一筆，open/close 相同)
"odds": [
{
"update": "2024-02-23T07:47:30", // 數據更新時間
"normal": { // 不讓分盤
"a": 2.4, // 客場賠率
"h": 1.36, // 主場賠率
"s": 2 // 串關數
},
"handi": { // 讓分盤
"-4.5": { // 主場讓分值
"a": 1.87, // away 客場 +4.5 賠率
"h": 1.63, // home 主場 -4.5 賠率
"m": false, // 是否為主要玩法
"s": 2 // 串關數
},
"-5.5": { // 主場讓分值
"a": 1.76, // away 客場 +5.5 賠率
"h": 1.74, // home 主場 -5.5 賠率
"m": true, // 三種讓分值中，此為主要玩法
"s": 2
},
"-6.5": {
"a": 1.63,
"h": 1.87,
"m": false,
"s": 2
}
},
"total": { // 總分盤
"213.5": { // 總分值 213.5
"m": false, // 是否為主要玩法
"o": 1.7, // over 大分
"s": 2, // 串關數
"u": 1.8 // under 小分
},
"214.5": { // 總分值 214.5
"m": true,
"o": 1.76,
"s": 2,
"u": 1.74
},
"215.5": {
"m": false,
"o": 1.84,
"s": 2,
"u": 1.66
}
},
"total_away": { // 客場總分盤
"104.5": { // 開盤數量不固定，可能一組至多組
"o": 1.74,
"s": 2,
"u": 1.76
}
},
"total_home": { // 主場總分盤
"109.5": {
"o": 1.73,
"s": 2,
"u": 1.77
},
"112.5": {
"o": 1.75,
"s": 2,
"u": 1.75
},
"113.5": {
"o": 1.8,
"s": 2,
"u": 1.7
}
}
// 足球還有
// corner 角球數讓分盤
// total_corner 角球數總分盤
}
]
}
}
// 若 mode = both，則可能出現 odds 長度 1 或 2
{
"status": "OK",
"user": { ... },
"data": [
{
// 賽事 1，省略部分資訊
// oods 有 2 筆賠率，代表初盤和尾盤不同
"odds": [
{...}, {...}
]
},
{
// 賽事 2，省略部分資訊
// oods 只有 1 筆，代表開盤後只有一筆，故初盤/尾盤相同
"odds": [
{...}
]
},
}
補充說明
- 若未開盤，則不存在對應的鍵值
- 資料更新頻率約為每 10-20 分鐘