RFQ

private/send_quote

Maker-side call that submits a priced, signed quote in response to an existing RFQ. You provide the priced legs, direction, max fee, an EIP-712 signature (signer, signature, nonce, expiry), and optional label or MMP flag. The quote's signature is verified and validated against the referenced RFQ before it is stored. Returns the created quote. Requires trade scope for every instrument quoted.

post/private/send_quote

Request

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

Request body

clientstring
direction'buy' | 'sell' required
extra_feestring decimal

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

labelstring
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
noncestring required
referral_codestring
rfq_idstring uuid required

UUID v4 string

signaturestring required
signature_expiry_secinteger required
signerstring required

20-byte Ethereum address as a 0x-prefixed lowercase hex 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.