> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oddspapi.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 博彩商覆盖 —— Sharp 书、交易所与零售博彩商

> OddsPapi 在 350+ 家博彩公司上的覆盖：sharp 交易型博彩商、交易所与预测市场、零售体育博彩商 —— 含各博彩商的能力、新鲜度上限与状态信号。

OddsPapi 聚合 **350+ 家博彩公司**，以对价格发现最重要的博彩商为核心，而非为了一个漂亮的总数。您可访问的目录由密钥决定 —— 实时列表请查询 `GET /bookmakers`。

***

## 分类

**Sharp 交易型博彩商** —— 数据源的核心。定价最准确、主导全球体育预测的博彩商（如 Pinnacle、Singbet、Circa Sports）。交易系统以它们为基准，且它们携带[投注限额](/zh/websocket/channels/odds#投注限额)与完整的传输时间戳链。

**交易所与预测市场** —— 实时价格附带[订单簿深度](/zh/websocket/channels/odds#高级元数据meta)：`meta.back` / `meta.lay` 的 `{ price, size }` 阶梯，跨场馆形态统一（如 Betfair、Polymarket）。非体育预测主题以期货形式覆盖，参见[按运动划分的覆盖](/zh/coverage)。

**欧洲、美国及加密货币博彩商** —— 跨地区的广泛零售覆盖（如 DraftKings、Stake、BC.Game）。

**亚洲盘口为一等公民**：亚洲让分盘市场类型、四分之一盘结算（`HALFWIN` / `HALFLOSS`），以及[`currencies`](/zh/websocket/channels/currencies) 频道上用于本金与限额换算的法币 + 加密货币汇率。

***

## 一家博彩商可能携带什么

并非每项能力在每家博彩商都存在 —— 博彩商公布什么，决定了我们能传递什么。请检查具体字段，而不要假定：

| 能力       | 出现位置                                      | 说明                                                                                  |
| -------- | ----------------------------------------- | ----------------------------------------------------------------------------------- |
| 价格       | `price`、`priceAmerican`、`priceFractional` | 始终存在                                                                                |
| 投注限额     | outcome 上的 `limit`                        | 几乎每家 sharp 博彩商都携带                                                                   |
| 订单簿深度    | `meta.back` / `meta.lay`                  | 交易所与预测市场                                                                            |
| 场内原生 ID  | `bookmakerMarketId`、`bookmakerOutcomeId`  | 随每条价格在实时数据流上传输 —— 用于订单路由                                                            |
| 博彩商自身时间戳 | `bookmakerChangedAt`                      | 博彩商提供时可用；支持精确的延迟测量                                                                  |
| 主盘标记     | `mainLine`                                | 无需订阅所有替代盘口即可跟踪头部价格                                                                  |
| 赛事层映射    | `bookmakerFixtureId`、`fixturePath`        | 在 [`bookmakers`](/zh/websocket/channels/bookmakers) 频道上；也可用 `GET /fixtures/mapping` |

***

## 各博彩商元数据

`GET /bookmakers` 返回目录及规划集成所需的运营字段：

| 字段                                   | 含义                                  |
| ------------------------------------ | ----------------------------------- |
| `slug`                               | 用于 `bookmakers` 过滤与 `oddsId` 的稳定标识符 |
| `bookmakerName`                      | 展示名称                                |
| `active`                             | 当前是否正在采集该博彩商                        |
| `websocketPregame` / `websocketLive` | 该博彩商可用的交付模式                         |
| `maxDelayPregameInSec`               | 赛前新鲜度上限                             |
| `maxDelayPregameMainInSec`           | 赛前主盘新鲜度上限                           |
| `maxDelayLiveInSec`                  | 滚球新鲜度上限                             |

`maxDelay*` 字段给出各模式的最大预期刷新延迟 —— 在博彩商提供可用时间戳时基于实测（当前为滚动 p50），否则为估计值。各博彩商的代表性 p50 发布在[延迟与新鲜度](/zh/api-reference/reliability#延迟与新鲜度)。

***

## 状态信号

覆盖不仅是"这家博彩商在不在列表里"，还包括"它此刻是否最新"。[`bookmakers`](/zh/websocket/channels/bookmakers) 频道按博彩商、按赛事报告：

* `hasOdds` —— 该博彩商当前在这场赛事上提供赔率
* `staleOdds` —— 连接已降级，新鲜度无法保证（视为熔断开关）
* `suspended` —— 该博彩商的赔率已暂停
* `participantsRotated` —— 该博彩商的主客队分配与 OddsPapi 基准不同

请把 `staleOdds`、`suspended`、`marketActive` 与 `active` 接入同一个"此价格是否可交易"的判定。参见[可靠性与运维](/zh/api-reference/reliability)。

***

## 发现您的目录

```bash theme={null}
curl 'https://v5.oddspapi.io/en/bookmakers?apiKey=YOUR_KEY'
```

博彩商访问权按密钥授予，且 `odds`、`bookmakers`、`oddsFutures`、`bookmakersFutures` 为博彩商门控频道 —— 您收到的是密钥允许范围与登录时所发 `bookmakers` 过滤条件的交集。参见[认证与过滤](/zh/websocket/auth)。