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

# WebSocket 投注单频道 - 实时价格与投注额限额

> 在 Apexium API WebSocket 上订阅选项，并在每次变化时收到其投注单：经账户规则处理后的价格和投注额限额。

`betslip` 频道以数据流形式提供 [`GET /v1/betslip`](https://docs.apexiumbet.com/zh/api-reference/overview#投注单) 返回的内容：某个选项在每家博彩公司经您账户规则处理后的价格和投注额限额。这是您下单所用的价格。它可能与 `odds` 频道不同：参见[行情赔率与投注单](https://docs.apexiumbet.com/zh/guides/feed-odds-and-betslip.md)。

## 订阅

在 `channels` 中带上 `betslip` 登录，然后为每个选项发送一个帧：

```json theme={null}
{
  "type": "subscribeBetslip",
  "fixtureId": "id1000001770366972",
  "outcomeId": 101,
  "playerId": 0,
  "bookmakers": ["sharpbet", "vertex"]
}
```

* **`playerId`** 可选，默认为 `0`。
* **`bookmakers`** 可选。不提供时，会对您账户的每家博彩公司报价，与 `GET /v1/betslip` 相同。

服务器回复该选项及其报价的博彩公司：

```json theme={null}
{ "type": "betslip_subscribed", "fixtureId": "id1000001770366972", "outcomeId": 101, "playerId": 0, "bookmakers": ["sharpbet", "vertex"] }
```

## 更新

之后，每当价格或限额变化时：

```json theme={null}
{
  "channel": "betslip",
  "type": "betslip",
  "payload": {
    "fixtureId": "id1000001770366972",
    "outcomeId": 101,
    "playerId": 0,
    "bookmakers": [
      {
        "bookmaker": "sharpbet",
        "active": true,
        "price": "1.952",
        "minStake": { "amount": "1.00", "amountCents": 100, "currency": "USD" },
        "maxStake": { "amount": "850.00", "amountCents": 85000, "currency": "USD" }
      }
    ]
  },
  "ts": 1791413359090,
  "seq": 3
}
```

数据内容的结构和数值与 `GET /v1/betslip` 相同。把 `price` 作为 `minPrice` 发送时，会以博彩公司当前的价格下单。您账户规则的变化会在大约 10 秒内体现在连接上。

## 取消订阅

```json theme={null}
{ "type": "unsubscribeBetslip", "fixtureId": "id1000001770366972", "outcomeId": 101, "playerId": 0 }
```

服务器回复 `betslip_unsubscribed`。关闭连接会取消所有订阅。

## 限制与拒绝

* **每个账户 50 个选项。** 所有连接合计；再多一个，连接会以 [`4004`](https://docs.apexiumbet.com/zh/websocket/close-codes#4004) 关闭。
* **对 API 关闭的博彩公司**不会报价。在 `bookmakers` 中指定其中一家会以 `error` 帧返回 `BOOKMAKER_NOT_AVAILABLE_VIA_API`。已打开的订阅会保留订阅时的博彩公司，直到您再次发送 `subscribeBetslip` 或重新连接。
* **拒绝。** 无法报价的选项（例如没有赔率的选项）会以 `error` 帧返回，其中带有[错误目录](https://docs.apexiumbet.com/zh/api-reference/errors.md)中的代码。连接保持打开。
* **重连之后**，请重新发送您的 `subscribeBetslip` 帧。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.