Skip to main content
POST
/
v1
/
cashout-requests
/
{id}
/
cancel
curl -X POST https://api.totalis.trade/v1/cashout-requests/c3d4e5f6-7890-abcd-ef12-34567890abcd/cancel \
  -H "X-API-Key: $TOTALIS_API_KEY"

# No response body
This endpoint mirrors Cancel quote request — but its response shape has not been verified against the live API. Confirm field names and shapes with engineering before treating this page as authoritative.
Cancel an active cashout request. The backing market maker’s pending buyback quote, if any, is invalidated and the request is removed from the live stream. Returns 204 No Content on success. You can only cancel a cashout request while its status is active. cancelled is a documented terminal status on the cashout-request stream — this endpoint produces it.

​
Authentication

API key required. Pass your API key in the X-API-Key header. 
X-API-Key: <your-api-key>
A Privy JWT (Authorization: Bearer <jwt>) is also accepted — see Authentication.

​
Path parameters

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

​
Response

Returns 204 No Content with no response body.

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key.
403FORBIDDENYou do not own this cashout request.
404NOT_FOUNDCashout request not found.
409CONFLICTCashout request is not active — already committing, committed, declined, expired, or cancelled.
curl -X POST https://api.totalis.trade/v1/cashout-requests/c3d4e5f6-7890-abcd-ef12-34567890abcd/cancel \
  -H "X-API-Key: $TOTALIS_API_KEY"

# No response body