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

# Get combo cashout quote

> See what a combo can be cashed out for right now

Returns the amount you would receive for cashing out an open combo now, or the reason cashout is unavailable. This quote is authoritative — `cashoutAvailable` on the combo only tells you cashout is offered.

Cashout is available only while the combo is `PENDING`, before any leg's game has started, while every leg's market is open, and while the value is positive. See [Cashout](https://docs.bayse.markets/concepts/combos.md#cashout).

## Authentication

Read authentication required — `X-Public-Key` header.

## Path parameters

**comboId** `string` *required*

UUID of the combo.

## Request body

No request body.

## Example request

```bash cURL theme={null}
curl -X POST "https://relay.bayse.markets/v1/pm/combos/3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73/cashout/quote" \
  -H "X-Public-Key: pk_live_abcdef123456"
```

```javascript Node.js theme={null}
const comboId = '3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73';
const response = await fetch(
  `https://relay.bayse.markets/v1/pm/combos/${comboId}/cashout/quote`,
  {
    method: 'POST',
    headers: { 'X-Public-Key': 'pk_live_abcdef123456' },
  }
);
const quote = await response.json();
if (!quote.available) {
  console.log('Cashout unavailable:', quote.reason);
}
```

```python Python theme={null}
import requests

combo_id = '3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73'
resp = requests.post(
    f'https://relay.bayse.markets/v1/pm/combos/{combo_id}/cashout/quote',
    headers={'X-Public-Key': 'pk_live_abcdef123456'},
)
resp.raise_for_status()
quote = resp.json()
if not quote['available']:
    print('Cashout unavailable:', quote['reason'])
```

```go Go theme={null}
req, _ := http.NewRequest(
    "POST",
    "https://relay.bayse.markets/v1/pm/combos/3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73/cashout/quote",
    nil,
)
req.Header.Set("X-Public-Key", "pk_live_abcdef123456")
resp, _ := http.DefaultClient.Do(req)
```

## Response

**comboId** `string`

UUID of the combo.

**available** `boolean`

Whether you can cash out now.

**reason** `string`

Why cashout is unavailable. Present only when `available` is `false`.

**price** `number`

Current cashout price per combo share (0.00–1.00).

**amount** `number`

What you would receive, in `currency`.

**currency** `string`

`USD` or `NGN`.

```json 200 OK — available theme={null}
{
  "comboId": "3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73",
  "available": true,
  "price": 0.21,
  "amount": 11.67,
  "currency": "USD"
}
```

```json 200 OK — unavailable theme={null}
{
  "comboId": "3f8a2c61-9d4e-4b7a-8c15-6e2f0a9b4d73",
  "available": false,
  "reason": "Cashout is not available once a game has started",
  "price": 0,
  "amount": 0,
  "currency": "USD"
}
```

```json 404 Not Found theme={null}
{
  "error": "Not Found",
  "message": "Combo not found",
  "statusCode": 404
}
```

> [!TIP]
>
> The cashout value moves with the leg markets. [Cash out combo](https://docs.bayse.markets/api-reference/pm/cashout-combo.md) re-prices at execution, so the amount you receive can differ from this quote.


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