# Quote a redeem order on any pool

`POST /dex/pools/{poolNft}/orders/redeem/check` · Lithos client API · Lithos Dex

Source: https://lithosprotocol.org/docs/api/check-ld-pool-redeem-order

What closing a provision through an order returns now, and the fees the placement would claim from the vault first. A fill forfeits anything left unclaimed.

## Parameters

| Name | In | Type | Required | Description |

|---|---|---|---|---|

| `poolNft` | path | string | yes | The pool's NFT id, 64 hex characters |

## Request body

`LDPoolRedeemRequest`, application/json.

- `provisionBoxId` (string, required): The live provision box to close
- `executorFee` (string): nanoERG the filler keeps. Omitted, from lithosdex.orders.
- `maxMinerFee` (string): Most of the executor fee a broadcast fill may pay as a network fee. Below executorFee.

## Responses

### 200: The quote

`LDPoolRedeemQuote`

- `poolNFT` (string, required)
- `provisionBoxId` (string, required)
- `shares` (string, required)
- `amountX` (string, required): The provision's share of reserve X; nanoERG for an ERG/token pool
- `amountY` (string, required)
- `claimableX` (string, required): Claimed from the vault by the placement. A fill forfeits anything unclaimed.
- `claimableY` (string, required)
- `provisionValue` (string, required)
- `ergReturned` (string, required): nanoERG back beside the reserves, net of the fee where it comes out of them
- `withinMinSupply` (boolean, required): False when the pool refuses to close this provision
- `executorFee` (string, required)
- `maxMinerFee` (string, required)
- `totalErgRequired` (string, required)
- `networkFee` (string, required)

### 400: The request is malformed, or names a token the pool does not hold.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### 404: No LithosDex pool with that NFT, or no live provision with that id.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### 503: The pool index is still building, or the node could not be read. Retry.

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

### default: Error

`ApiError`

- `error` (integer, required): Error code
- `reason` (string, required): Error message explaining the reason of the error
- `detail` (string, required): Detailed error description

## Example request

```bash
curl -X POST "http://localhost:9000/dex/pools/{poolNft}/orders/redeem/check" \
  -H "Content-Type: application/json" \
  -d '{ "provisionBoxId": "string", "executorFee": "string", "maxMinerFee": "string" }'
```

## Example response

```json
{
  "poolNFT": "string",
  "provisionBoxId": "string",
  "shares": "string",
  "amountX": "string",
  "amountY": "string",
  "claimableX": "string",
  "claimableY": "string",
  "provisionValue": "string",
  "ergReturned": "string",
  "withinMinSupply": true,
  "executorFee": "string",
  "maxMinerFee": "string",
  "totalErgRequired": "string",
  "networkFee": "string"
}
```