> ## 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 betslip channel - Live prices and stake limits

> Subscribe to selections on the Apexium API WebSocket and receive their betslip, the price and stake limits after your account's rules, on every change.

The `betslip` channel streams what [`GET /v1/betslip`](https://docs.apexiumbet.com/api-reference/overview#betslip) returns: the price and stake limits of a selection at each bookmaker, after the rules of your account. This is the price you place at. It can differ from the `odds` channel: see [Feed odds and the betslip](https://docs.apexiumbet.com/guides/feed-odds-and-betslip.md).

## Subscribe

Log in with `betslip` in `channels`, then send one frame per selection:

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

* **`playerId`** is optional and defaults to `0`.
* **`bookmakers`** is optional. Without it, every bookmaker of your account is quoted, as with `GET /v1/betslip`.

The server answers with the selection and the bookmakers it quotes:

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

## Updates

Then, and on every change of price or limit:

```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
}
```

The payload has the shape and the values of `GET /v1/betslip`. A `price` sent as `minPrice` places at the bookmaker's current price. A change of your account's rules shows on the socket within about 10 seconds.

## Unsubscribe

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

The server answers `betslip_unsubscribed`. Closing the connection unsubscribes everything.

## Limits and refusals

* **50 selections per account.** They are summed over its connections; one more closes the connection with [`4004`](https://docs.apexiumbet.com/websocket/close-codes#4004).
* **Bookmakers closed to the API** are not quoted. Naming one in `bookmakers` comes back as an `error` frame with `BOOKMAKER_NOT_AVAILABLE_VIA_API`. A subscription keeps the bookmakers it started with until you send `subscribeBetslip` again or reconnect.
* **Refusals.** A selection that cannot be quoted, such as one without odds, comes back as an `error` frame with the code of the [error catalogue](https://docs.apexiumbet.com/api-reference/errors.md). The connection stays open.
* **After a reconnect**, send your `subscribeBetslip` frames again.


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