---
title: "What a set of holdings would fetch if sold now"
method: POST
path: "/v1/liquidation"
---

# What a set of holdings would fetch if sold now

`POST /v1/liquidation`

## Request

- Base URL: `https://qmax.exchange/api`
- URL: `https://qmax.exchange/api/v1/liquidation`
- Auth: none declared

Each holding is run through the router as a sale of the whole amount, so the answer counts the depth of the QX order book and the QSwap pool and every fee, not just units times the last price. Where the market cannot take the whole holding, only the part it can take is counted and the holding is marked incomplete. Each asset is priced on its own. Nothing is sent or reserved.

## Request body

- object
  - `holdings` object[], required
    - `asset` string, required
    - `qty` integer, required

## Response `200`

{ items: [{ asset, qty, fillableQty, proceedsQu, avgPriceQu, midValueQu, haircutPct, venues, complete, error? }], totalProceedsQu, totalMidQu, incomplete, at }

## Other responses

- `400`: Invalid holdings

---

[API](https://skmtc.dev/qmax/apis/qmax-api.md) · [All operations](https://skmtc.dev/qmax/apis/qmax-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qmax/apis/qmax-api/revisions/af70e2813a7a?raw)