Skip to main content
DELETE
/
v1
/
mm
/
quote-requests
/
{id}
/
quote
curl -X DELETE https://api.totalis.trade/v1/mm/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/quote \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_version": 1,
    "request_hash": "sha256:9f86d08..."
  }'

# No response body
Withdraw your active quote from a quote request. If the quote has already expired naturally, the response indicates already_expired instead of returning an error.
Withdraw only when you want to retract a quote on the current version that you no longer want to honor — for example, your price moved before the user committed. You do not need to withdraw when the request changes version: your prior-version quote is invalidated automatically. To quote the new version, just submit again with the new request_version and request_hash.

​
Authentication

API key required. Pass your market maker API key in the X-API-Key header. 
X-API-Key: <key>

​
Path Parameters

​
id
string
required
The quote request ID (UUID).

​
Request Body (optional)

​
request_version
integer
The request version your quote was submitted for. Defaults to the current version if omitted.
​
request_hash
string
The request hash your quote was submitted for. Defaults to the current hash if omitted.

​
Response

Returns 204 No Content when the quote is successfully withdrawn. If the quote had already expired naturally, returns 200 OK: 
{
  "data": {
    "status": "already_expired"
  }
}

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key.
404NOT_FOUNDQuote request not found.
409CONFLICTNo active quote to withdraw, request expired, no longer active, or version mismatch. See details.reason.
curl -X DELETE https://api.totalis.trade/v1/mm/quote-requests/1a6d1f06-9d4f-47cb-994b-3bdfbbef7e40/quote \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_version": 1,
    "request_hash": "sha256:9f86d08..."
  }'

# No response body