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

# 枚举值 - 状态ID、赛段和结算状态

> OddsPapi API中所有固定枚举值的完整参考：statusId生命周期值、period键以及结算状态。

本页列举了线上传输中使用的每一套**固定词汇表**。这些值是公共契约的一部分：现有值是**冻结的**（含义永不改变，也不会消失），新值只会以**追加**方式加入 —— 请在客户端中优雅地处理未知值。

***

## statusId（赛事 / 期货生命周期）

每个赛事和期货的生命周期。冻结集合：

| statusId | Slug        | live | 含义             |
| -------: | ----------- | :--: | -------------- |
|      `0` | `pregame`   |   否  | 已排期，尚未开始。      |
|      `1` | `live`      |   是  | 正在进行中。         |
|      `2` | `finished`  |   否  | 已结束；最终比分/结果可用。 |
|      `3` | `cancelled` |   否  | 已取消 / 不会进行。    |

说明：

* `statusName` 是翻译后的显示标签（跟随语言前缀）；`statusId` 是稳定的键 —— 请始终基于 ID 做分支判断。
* 状态只会**向前**推进（`0 → 1 → 2`，或任意状态 → `3`）；永远不会回退。

***

## period

比分、统计和盘口数据都以一套**通用赛段词汇表**为键，因此相同的键适用于所有运动。一个赛段的*具体含义*取决于该运动的结构 —— 请使用赛事的 `expectedPeriods` 和 `periodLength` 来解读（例如 `p1` 在足球中是半场，在 NBA 篮球中是一节，在网球中是一盘，在电竞中是一张地图）。

### 全场键

| 值           | 含义                                                                         |
| ----------- | -------------------------------------------------------------------------- |
| `result`    | 整场比赛比分 —— 包含迄今为止所有已进行部分的主比分。                                               |
| `fulltime`  | 仅常规时间（不含加时和点球）。                                                            |
| `overtime`  | 仅加时 / 补时赛段。                                                                |
| `penalties` | 点球大战。**当前行为：** 该键携带的是点球*之后*的比分（累计值），而非仅点球赛段本身 —— 这与其他全场键不一致，将在未来版本中改为仅赛段值。 |

### 编号赛段

| 值            | 含义                                                        |
| ------------ | --------------------------------------------------------- |
| `p1` … `p12` | 该运动自然结构中的第 *N* 个赛段：半场、节、盘、地图、局或回合（例如 `p10`–`p12` 覆盖拳击回合）。 |

### 组合赛段

连续赛段之和，用于以组合赛段提供盘口的场景：

| 值                      | 典型用途                 |
| ---------------------- | -------------------- |
| `p1+p2`                | 以节为单位的运动中的上半场（例如篮球）。 |
| `p3+p4`                | 以节为单位的运动中的下半场。       |
| `p1+p2+p3+p4+p5`       | 组合的多赛段区间。            |
| `fulltime+overtime`    | 常规时间加加时。             |
| `p3+p4+overtime`       | 含加时的下半场。             |
| `p4+overtime`          | 含加时的最后一节。            |
| `p6+p7+p8+p9+overtime` | 组合的比赛后段局数区间（例如棒球）。   |

### 子赛段键（盘内的局）

| 值                | 含义                                                               |
| ---------------- | ---------------------------------------------------------------- |
| `p1g1` … `p5g13` | 第 *X* 个赛段/盘内的第 *Y* 局 —— 以网球为主：第 1–5 盘、第 1–12 局，`g13` = 抢七。       |
| `currentgame`    | 指向**正在进行的**一局的滚动指针（例如网球当前局的比分）。它始终只是实时指针 —— 已结算的逐局事实使用 `pXgY` 键。 |

<Note>
  赛段词汇表是**仅追加**的：新的运动可能引入额外的键（例如飞镖 leg 或电竞回合的子赛段网格）。切勿硬编码一份穷举列表 —— 请优雅地处理未知的赛段键。
</Note>

***

## settlementStatus

结算端点返回的逐选项评级：

| 值           | 含义                        |
| ----------- | ------------------------- |
| `WIN`       | 选项获胜 —— 全额派彩。             |
| `LOSE`      | 选项失败。                     |
| `PUSH`      | 作废 / 恰好打平盘口线 —— 退还本金。     |
| `HALFWIN`   | 一半本金获胜，一半退还（亚洲四分之一盘）。     |
| `HALFLOSS`  | 一半本金失败，一半退还（亚洲四分之一盘）。     |
| `CANCELLED` | 盘口作废（赛事取消、盘口不可操作）—— 退还本金。 |
| `UNDECIDED` | （暂时）无法评级 —— 结果数据不足或待定。    |

对于非明确评级（`CANCELLED` / `UNDECIDED`），结算行会带有一个 `reason` 字符串来解释原因。

***

## 开放词汇表（非枚举）

以下词汇表是**随时间增长的字符串集合** —— 单个值稳定，但永不穷尽：

* **`marketType`** —— 盘口种类（`1x2`、`totals`、`spreads`、`players-shots` 等）。参见[概念 → 盘口与选项](/zh/api-reference/concepts)。
* **`eventType`** —— events 频道上的比赛中动作类型（`goal`、`card_yellow`、`corner_taken`、`substitution`、`var` 等）。
* **`statType`** —— stats 频道上的可计数统计聚合（`score`、`corners`、`cards`、`aces` 等）。

请将它们视为不透明标识符：匹配您支持的值，忽略其余值。