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

{
  "data": {
    "status": "declined",
    "noop": false
  }
}
Permanently refuse to quote a cashout request when the position can’t be priced and won’t become priceable on retry — a leg is already decided, unrecognized, or its live odds sit outside the band. The user’s stream surfaces a terminal status: declined immediately instead of waiting out the ~90 s TTL. Use this only for a permanent decline. For a transient refuse (a leg has no trustworthy live price right now), stay silent — the request rides its TTL so a later quote can still land. See Market making → When to refuse. This endpoint is single MM scoped and idempotent: declining an already terminal request is a noop (noop: true).

​
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 cashout request ID (UUID).

​
Request body

No body.

​
Response

​
data
object

​
Errors

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid API key.
403FORBIDDENYou are not the counterparty MM for this position.
404NOT_FOUNDCashout request not found.
curl -X POST https://api.totalis.trade/v1/mm/cashout-requests/c3d4e5f6-7890-abcd-ef12-34567890abcd/decline \
  -H "X-API-Key: $API_KEY"

{
  "data": {
    "status": "declined",
    "noop": false
  }
}