PinBook Odds

Pinnacle Odds - PinBook Sport API is a RESTful service for getting pre-match and live odds from Pinnacle. Historical odds, score and results. Updates without delay. Sports: Soccer, Tennis, Basketball, Hockey, American football, MMA, Baseball, Cricket, Esports (CS2 (CS:GO), Dota 2, LoL (League of legends), Valorant, Rocket League). **Support**: [[e-mail]](mailto:[e-mail]) / t.me/api_tipsters | **Other sports api:** https://rapi.one | Other Books: https://oddsfe.com/

原始信息汇总

PinBook Odds 数据集概述

基本信息

• 数据集名称: PinBook Odds
• 提供商: Tipsters CO
• 类别: 体育
• API类型: RESTful 服务
• 主要功能: 获取赛前和实时赔率、历史赔率、比分和结果

服务指标

• 流行度: 8.8
• 服务等级: 100%
• 延迟: 48ms
• 测试状态: N/A

订阅计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月
• ULTRA: $39.00 / 月
• MEGA: $99.00 / 月

支持的体育项目

• 足球、网球、篮球、冰球、美式足球、MMA、棒球、手球、排球、板球
• 电子竞技: CS2 (CS:GO)、Dota 2、LoL (League of legends)、Valorant、Rocket League

核心特性

• 提供赛前和实时赔率
• 提供历史赔率、比分和结果
• 无延迟更新

端点列表

1. GET List of Archive events
2. GET Betting status
3. GET List of Leagues
4. GET List of Markets
5. GET List of Periods
6. GET Event Details
7. GET List of Sports
8. GET List of Special markets

关键使用说明

获取赔率列表流程

1. 使用 @List of sports 端点获取体育项目列表。
2. 使用 @List of markets 端点，通过 sport_id 获取市场列表。可传递 event_type 和 is_have_odds 参数。
3. 使用 @List of Special markets 端点，通过 sport_id 获取特殊市场列表（如球员道具、期货、双方球队得分等）。
4. 使用 @List of archive events 端点，通过 sport_id 获取赛事列表（存档或赛程）。
5. 使用 @Event details 端点，通过 event_id 获取赔率历史。

参数与数据更新

• 使用 since 参数进行增量数据获取。首次调用不带此参数以获取全部数据，后续使用响应中的 last 时间戳作为 since 值，仅获取变更数据。
• 不带 since 参数的调用在5分钟内不得超过15次。

数据字段与状态说明

• 赛事类型: prematch (赛前) 或 live (实时)。
• 周期状态: 1 - 在线，开放投注；2 - 离线，不开放投注。
• 特殊市场状态: O - 开放投注；H - 暂时不可用；I - 一条或多条投注线有红圈（最大投注额较低）。
• 周期结果状态: 1 - 已结算；2 - 重新结算；3 - 取消；4 - 重新结算为取消；5 - 已删除。
• 主客队判定: 需通过 @/kit/v1/leagues 端点查询 home_team_type 字段 (Team1 或 Team2)。
• 周期编号含义: 需通过 @kit/v1/meta-periods 端点查询（如 num_0 对应“全场”，num_1 对应“上半场”）。

市场开放投注判断

方法一：同时满足以下条件：

1. 周期状态为 1。
2. 市场（周期）有赔率。
3. 周期的截止时间 (cutoff) 在未来。

方法二：检查 ["periods"]->["num_..."]->["meta"]->["open_..."] 的值（如 open_money_line）。

其他技术细节

• 所有时间均为 GMT (0)。
• 事件是否结束可通过 @/kit/v1/archive 和 @/kit/v1/details 端点检查 "cutoff" 值及结算状态。
• 处理重复的父级事件时，默认使用标识符值更大的事件，并监控结算信息端点，丢弃已删除或已结算的事件。

支持与文档

• 文档链接: https://pinbook.bapi.info/
• 支持邮箱: [e-mail]
• 支持Telegram: https://t.me/api_tipsters
• 其他体育API: https://rapi.one/sports/
• 其他博彩数据源: https://oddsfe.com/
• OpenAPI规范: Pinnacle Odds - OpenAPI Specification

代码示例 (Python)

提供了使用 requests 库循环获取市场数据的完整Python代码示例，包括请求头设置、参数传递、错误处理和增量更新逻辑。

搜集汇总

背景与挑战

背景概述

PinBook Odds数据集通过RESTful API提供Pinnacle博彩公司的实时与历史赔率数据，覆盖足球、篮球等传统体育及CS:GO等电子竞技项目，支持无延迟更新。数据包含比分、赛果等信息，可通过指定联系方式获取支持。