RFQ

private/cancel_quote

Cancels one open quote owned by the subaccount, identified by quote_id (optionally further constrained by rfq_id, label, or nonce). Returns the cancelled quote, or a quote-not-found error if it does not exist or is no longer open. Requires an RFQ trade scope.

post/private/cancel_quote

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/cancel_quote
  • Auth: none declared

Request body

labelstring nullable
noncestring nullable
quote_idstring uuid required

UUID v4 string

rfq_idstring uuid nullable

Optional UUID v4 string

subaccount_idinteger required

Response

Success

batch_status'Batching' | 'Executing' | 'Da' | 'Proving' | 'Settling' | 'Settled' | 'BatchingError' | 'ExecutingError' | 'DaError' | 'ProvingError' | 'SettlingError' | 'SettledError'

Batch lifecycle status — the single source of lifecycle truth for every operation in the batch (individual ops carry no status of their own). Each stage has a healthy variant and a corresponding ...Error variant meaning that stage failed. Serialized as the variant name (string) in API responses.

cancel_reason'' | 'user_request' | 'insufficient_margin' | 'signed_max_fee_too_low' | 'mmp_trigger' | 'cancel_on_disconnect' | 'session_key_deregistered' | 'subaccount_withdrawn' | 'rfq_no_longer_open' | 'compliance' | 'validation_failed' required
creation_timestampinteger required
direction'buy' | 'sell' required
extra_feestring decimal required

Non-negative decimal string of the human value (e.g. "1.5"), up to 12 fractional digits; a string or JSON number is accepted

feestring decimal required

Non-negative decimal string of the human value (e.g. "1.5"), up to 12 fractional digits; a string or JSON number is accepted

fill_pctstring decimal required

Non-negative decimal string of the human value (e.g. "1.5"), up to 12 fractional digits; a string or JSON number is accepted

is_transferboolean required
labelstring required
last_update_timestampinteger required
legs_hashstring required
liquidity_role'maker' | 'taker' required
max_feestring decimal required

Non-negative decimal string of the human value (e.g. "1.5"), up to 12 fractional digits; a string or JSON number is accepted

mmpboolean required
noncestring required
quote_idstring uuid required

UUID v4 string

rfq_idstring uuid required

UUID v4 string

signature_expiry_secinteger required
status'open' | 'filled' | 'cancelled' | 'expired' required
subaccount_idinteger required
tx_hashstring nullable

Blockchain transaction hash (only for executed quotes).

Changes

No recorded changes to this operation across all 1 revision of this API.