体育博彩API集成：赔率、投注与结算
为您的博彩平台提供赔率数据、投注下单和投注结算：一个 JSON API、分步文档，以及我们团队提供的 API 咨询。
体育博彩集成的四个组成部分
只选择产品需要的部分：可以只接入赔率数据，也可以接入从赔率到派彩的完整流程。
您的设计，我们的数据：打造自己的博彩平台
赔率实时变动的 Live 比赛、在接受投注前校验价格的投注单，以及玩家历史记录中已结算的投注。设计由您决定，数据、赔率校验和结算由 SportAPI 提供。
- Live 和 Prematch 赛事线
- 赔率实时变动
- 下注时校验赔率
- 网站和移动应用
~20分钟
借助现成示例，即可看到显示真实赛事的第一个页面
1天
借助 AI 代理和我们面向 AI 的文档，完成赔率、投注和结算
5–30天
普通内部开发团队所需时间，取决于经验
2天
免费访问所有体育项目的 Prematch 和 Live 数据，用于测试集成
从网站上的赔率到派彩
六个调用覆盖完整的投注周期。与 SportAPI 通信的是您的服务器，玩家只看到您的界面。
- 01↓ →
体育菜单
menu 返回 Prematch 或 Live 的体育项目、国家和赛事。
- 02↓ →
赛事和赔率
events 和 event 返回比赛、市场和当前赔率。
- 03↓ →
投注指针
选中的结果以指针形式传递，并附带玩家看到的赔率。
- 04↓ →
提交投注单
coupons/place 校验赔率，接受单式或串关投注。
- 05↓ →
结算
比赛结束后投注单完成结算，您会收到带签名的 callback。
- 06
派彩
您的系统将奖金计入玩家余额。
玩家与您通信，您与 SportAPI 通信
网站和应用只调用您的后端。后端保管 API 密钥，为所有玩家统一缓存赛事线，将投注发送到 SportAPI，并通过带签名的 callback 接收结算结果。
- API 密钥绝不进入浏览器
- 所有玩家共用一个缓存
- 余额和规则由您掌控
- HMAC 签名的 callback
上线六步走
完成第 1–3 步，网站上就能展示实时体育赛事线。第 4–6 步仅在您通过 SportAPI 接受投注时需要。
1. 获取测试密钥
通过 Telegram 提交申请。试用期为 2 天，可访问所有体育项目的 Prematch 和 Live 数据。
2. 第一个请求
在 Package header 中携带密钥调用 menu，搭建第一个赛事页面。
3. 赔率和 Live 更新
加载赛事和赔率，按推荐间隔刷新 Live 数据，隐藏被锁定的结果。
打开4. 接受投注
获取 JWT，根据选中的结果生成投注指针并提交投注单。
打开5. 接收结算
验证 callback 的 HMAC 签名，或轮询已结算的投注单；每个批次只处理一次。
打开6. 正式上线
选择套餐，切换到生产密钥，并保留轮询作为 callback 的备用方案。
投注自动结算，无需人工处理
比赛结束后，每张投注单都会自动得到结果：赢、输、退款，或亚洲盘口的赢半。callback 带来派彩金额，重试不会导致重复派彩，停机后可通过轮询恢复结果。
- 单式和串关
- 赢、输、退款、赢半
- 借助 batchId 安全重试
- 停机后恢复结果
获取赔率，提交投注：两个请求
赔率数据使用 Package header 中的 API 密钥。投注下单使用 JWT 和所选结果的指针。cURL、Python、PHP 和 JavaScript 的完整示例请见文档。
# 1. Live 体育菜单（Sport Line API）
curl 'https://YOUR_API_DOMAIN/v1/menu/live/cn' \
--header 'Package: YOUR_API_KEY'
# 2. 提交单式投注（Coupon API）
curl -X POST "$BASE_URL/api/partner/coupons/place" \
--header "Authorization: Bearer $CLIENT_TOKEN" \
--header "Content-Type: application/json" \
--data '{"list_bets": ["line#737779544#1#1#0#1.85"], "amount": 10}'您负责的部分和我们负责的部分
您负责的部分
您的服务器保管 API 密钥并发出所有请求。玩家账户和余额、界面和支付由您运营，展示哪些体育项目和市场也由您决定。
我们负责的部分
赔率数据、下注时的赔率校验、结算及结果推送、带示例的文档以及 API 咨询。我们不替您编写代码，但我们的团队可以额外收费为您完成集成。
集成费用
赔率数据按体育项目数量按月付费。先从覆盖所有体育项目的 2 天免费试用开始。 投注下单和结算（Coupon API）：每月 $300 起，每月另含 $20 用于测试投注。 预付多个月，最高可节省 30%。
一项体育运动，用于在真实产品上测试集成。
- 体育项目: 1
- Prematch + Live
- 语言: EN
- 顶级联赛
- 支持: 8/5
十项体育运动，适合成长中的博彩平台。
- 体育项目: 10
- Prematch + Live
- 语言: EN, RU
- 顶级联赛
- 支持: 12/7
全部体育项目和电竞，适合完整的博彩平台。
- 体育项目: 全部
- Prematch + Live
- 语言: EN, RU
- 顶级联赛
- 包含电竞
- 支持: 24/7
体育博彩API集成常见问题
体育博彩API集成如何运作
体育博彩API集成为您的博彩产品接入三样它无法自行生产的东西：带有当前赔率的体育赛事线、基于该赛事线接受投注的能力，以及赛后结算。在 SportAPI 中，每个部分都是独立的 JSON API，因此您可以先从赔率数据开始，之后再添加投注下单，而无需重写前端。
体育博彩API集成分步说明
第一部分是赔率数据。您的服务器请求体育菜单、赛事列表以及包含市场和赔率的完整赛事，保存标识符，并按推荐间隔刷新 Live 数据。被锁定的结果必须在界面中禁用，否则玩家会尝试在已关闭的价格上下注。
第二部分是投注下单。玩家确认投注单后，您的后端会发送每个所选结果的指针以及玩家看到的赔率。赔率校验会根据您选择的模式拒绝投注单或接受新价格，因此玩家永远不会以已不存在的赔率成交。
第三部分是结算。赛事结束后，投注单自动结算，结果附带 HMAC 签名发送到您的 callback。您的系统将奖金计入玩家余额，并继续轮询已结算的投注单作为保障。
博彩公司业务的投注API：需要规划什么
首先规划服务器端。API 密钥和 JWT 绝不能进入浏览器；所有请求都经过您的后端，后端同时缓存赛事线，帮助您避开请求限制。还要确定展示哪些体育项目和市场、如何显示赔率变化，以及如何处理被拒绝的投注单。
然后规划对账。可靠的集成会保存每张投注单的编号，确保每个 callback 批次只处理一次，并能在停机后恢复结果。这三条规则可以防止代价最高的集成错误：重复派彩和投注丢失。
集成服务还是自行开发
大多数团队自行完成集成：文档为每个方法提供请求和响应示例，还有面向 AI 编程代理的版本。API 咨询免费。如果没有开发人员，SportAPI 团队可以额外收费完成集成，您也可以借助体育博彩插件或交钥匙体育博彩平台更快上线。
上线检查清单
切换到生产密钥之前，请检查四件事。网站上的赛事线与同一赛事的 API 响应一致，包括被锁定的结果。赔率已变化的投注单严格按照您选择的模式被拒绝或接受，并且玩家能看到原因。已结算的投注单只入账一次，即使重放同一个 callback 也是如此。将 callback 接口停止一小时后，轮询能够恢复所有结果。如果这四项在试用密钥上全部通过，集成就可以迎接真实玩家了。
常见集成错误
从浏览器调用 API，导致密钥泄露。刷新 Live 数据的频率高于推荐间隔，触发限制。把 HTTP 200 当作成功，却不检查响应中的业务代码。同一个 callback 再次到达时重复派彩。这些问题在集成指南和投注下单快速指南中都有详细说明。