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

# v0.1.16 — October 27, 2026

> Combos: combine 2 to 10 outcomes into one position

## New feature

### Combos

A combo is a single position built from 2 to 10 legs, where each leg is one market outcome. The whole slip is priced as one `price` and `multiplier`, and it wins only if every leg wins. You can cash out an open combo before any of its games start.

Combos are not the same as `combined` events. See [Combos](https://docs.bayse.markets/concepts/combos.md) for pricing, voided legs, settlement, and cashout rules.

***

## New endpoints

| Method | Path | Auth | Description |
| - | - | - | - |
| `POST` | [`/v1/pm/combos/quote`](https://docs.bayse.markets/api-reference/pm/get-combo-quote) | Read | Price a set of selections as one combo. |
| `POST` | [`/v1/pm/combos`](https://docs.bayse.markets/api-reference/pm/place-combo) | Write | Place a combo from a quote. `quoteId` is the idempotency key. |
| `GET` | [`/v1/pm/combos`](https://docs.bayse.markets/api-reference/pm/list-combos) | Read | List your combos, newest first. Filter by `status`. |
| `GET` | [`/v1/pm/combos/{comboIdOrCode}`](https://docs.bayse.markets/api-reference/pm/get-combo) | Read | Get a combo by ID or 8-character share code. |
| `POST` | [`/v1/pm/combos/{comboId}/cashout/quote`](https://docs.bayse.markets/api-reference/pm/get-combo-cashout-quote) | Read | See what a combo can be cashed out for now. |
| `POST` | [`/v1/pm/combos/{comboId}/cashout`](https://docs.bayse.markets/api-reference/pm/cashout-combo) | Write | Cash out an open combo at its current value. |

```bash theme={null}
POST /v1/pm/combos/quote
{
  "selections": [
    {"marketId": "f6a7b8c9-d0e1-2345-fabc-678901234567", "outcomeId": "01234567-89ab-cdef-0123-456789abcdef"},
    {"marketId": "c9d0e1f2-a3b4-5678-cdef-901234567890", "outcomeId": "34567890-bcde-f012-3456-789abcdef012"}
  ],
  "currency": "USD"
}
```

***

## New WebSocket channel

### `combos` on `/ws/v1/user`

A private channel for your own combos. Subscribe with `{"type": "subscribe", "channel": "combos", "auth": {"apiKey": "pk_live_..."}}`.

* **`combo_placed`** — sent once when you place a combo.
* **`combo_updated`** — sent on every later state change: a game starting, the cashout window closing, settlement, cashout, and the payout landing.

Each event carries the full current state of the combo. See [Combos WebSocket](https://docs.bayse.markets/websocket/combos.md).

***

## New query parameter

### List events — `GET /v1/pm/events`

* **`comboEligible`** (boolean) — Return only events whose markets can be used as combo legs. Composes with all other filters.
  ```bash theme={null}
  GET /v1/pm/events?sportGameSlug=bm-game-20260524-mci-avl&comboEligible=true
  # Returns the combinable markets for one fixture
  ```

***

## Response schema changes

### Event response

| Field | Type | Description |
| - | - | - |
| `comboEligible` | boolean | The event's markets can be used as combo legs. |
| `combosOnly` | boolean | The event can only be traded inside a combo. Regular orders are not accepted. |


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