> ## 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.

# 盘口覆盖 —— 市场类型、线值、赛段与球员盘

> OddsPapi 覆盖哪些盘口：市场类型、赛段范围、亚洲盘与欧洲让分盘、大小球、球员盘，以及如何通过 GET /markets 枚举各运动的完整盘口图谱。

盘口并不是每项运动的固定清单 —— 它们由一套确定性分解生成，因此同一个投注在任何地方都解析到相同的标识符。本页说明存在哪些盘口以及如何枚举；机制细节参见[盘口和选项](/zh/api-reference/concepts#盘口和选项)。

***

## 一个盘口如何被寻址

```
marketType → period → handicap（线值）→ side   [+ 可选球员]
```

| 层级   | 字段            | 示例                  |
| ---- | ------------- | ------------------- |
| 盘口种类 | `marketType`  | `totals`            |
| 赛段   | `period`      | `fulltime`、`p1`     |
| 线值   | `handicap`    | `2.5`、`-0.25`、`0.0` |
| 方向   | `outcomeName` | `Over` / `Under`    |
| 球员   | `playerId`    | 非球员盘为 `0`           |

有两个后果值得在设计时考虑：

* **每个不同的线值都是独立的 `marketId`。**"大 2.5"与"大 3.5"是不同盘口，而非同一盘口的两个选项。单个 `marketId` 内的选项只是该确切线值的各个方向。
* **`marketId` 等于该盘口的第一个 `outcomeId`**，`marketLength` 是方向数量 —— 因此单个 `marketId` 下的选项无需任何额外元数据即构成完整的概率空间。

***

## 盘口类别

`marketType` 是**开放词汇表** —— 每个值稳定，但整体会随时间增长。代表性类型：

| `marketType`       | 盘口                      |
| ------------------ | ----------------------- |
| `1x2`              | 三项赛果                    |
| `moneyline`        | 两项胜负（适用时含加时）            |
| `totals`           | 大 / 小于某线值               |
| `teamtotals-team1` | 单队大 / 小球                |
| `spreads`          | 亚洲让分盘                   |
| `spreads-european` | 欧洲（三项）让分盘               |
| `bothteamsscore`   | 双方球队进球                  |
| `drawnobet`        | 平局退款                    |
| `oddeven`          | 单 / 双                   |
| `players-…`        | 球员盘（例如 `players-shots`） |

这并非完整图谱 —— 随着覆盖增长会追加新类型，且各运动可用的类型不同。请用 `GET /markets` 枚举真实图谱，而不要硬编码。

***

## 赛段范围

盘口通过 `period` 限定到某个赛段，所有运动共用同一套词汇：`fulltime`、`result`、`overtime`、`penalties`、编号赛段 `p1`…`p12`、组合赛段（`p1+p2`、`fulltime+overtime` 等），以及盘内局的子赛段键（`p1g1`…`p5g13`、`currentgame`）。

赛段的*含义*取决于运动 —— `p1` 在足球中是半场，在 NBA 篮球中是一节，在网球中是一盘，在电竞中是一张地图。请用赛事的 `expectedPeriods` 与 `periodLength` 来解读。完整列表参见[枚举 → period](/zh/api-reference/enumerations#period)。

***

## 球员盘

盘口携带 `playerProp` 标记，球员盘的价格携带非零 `playerId`：

```
{fixtureId}:{bookmaker}:{outcomeId}:{playerId}
```

`outcomeId` 编码了除球员之外的一切 —— 市场类型、赛段、线值与方向 —— 因此同一项球员盘在两名球员上共享 `outcomeId`，仅 `playerId` 不同。阵容可通过 `GET /players` 发现。

***

## 枚举图谱

```bash theme={null}
# 某运动的全部盘口及其选项
curl 'https://v5.oddspapi.io/en/markets?sportId=11&apiKey=YOUR_KEY'

# 解析特定盘口或选项
curl 'https://v5.oddspapi.io/en/markets?marketIds=111,113&apiKey=YOUR_KEY'
curl 'https://v5.oddspapi.io/en/markets?outcomeIds=114&apiKey=YOUR_KEY'
```

```json theme={null}
{
  "marketId": 111,
  "marketLength": 2,
  "sportId": 11,
  "playerProp": false,
  "handicap": 0.0,
  "period": "result",
  "marketType": "moneyline",
  "marketName": "Winner (incl. overtime)",
  "marketNameShort": "Winner",
  "outcomes": [
    { "outcomeId": 111, "outcomeName": "1" },
    { "outcomeId": 112, "outcomeName": "2" }
  ]
}
```

`marketName` / `marketNameShort` 跟随请求的[语言前缀](/zh/api-reference/concepts#语言前缀)，仅用于展示 —— 逻辑请基于 `marketId`、`outcomeId`、`marketType` 与 `period` 分支。

***

## 某场赛事实际有哪些盘口

`GET /markets` 描述某运动**存在**哪些盘口；某场赛事**此刻被定价**的盘口来自赔率本身。拉取 `GET /fixtures/odds`（或仅主盘的 `/fixtures/odds/main`）并按 `marketId` 分组。各博彩商提供的盘口与线值不同，`mainLine` 标记各家的头部线值。

<Note>
  `marketType` 只增不改：新值随覆盖增长出现，含义永不改变。请匹配您支持的类型并忽略其余，而不要在遇到未知值时失败。
</Note>

***

## 结算

评级遵循同一套坐标。亚洲四分之一盘在 `WIN` / `LOSE` / `PUSH` 之外结算为 `HALFWIN` / `HALFLOSS`，且评级基于与博彩商无关的选项键 `{fixtureId}:{outcomeId}:{playerId}`。参见[枚举 → settlementStatus](/zh/api-reference/enumerations#settlementstatus)与[支撑体育博彩](/zh/guides/sportsbook)。