Skip to navigation
Production API ReferenceRfqs

Create RFQ draft

Stores an RFQ-builder draft for the authenticated account.

A draft is inert: it is not sent to the RFQ venue and does not reserve margin. Each account may store at most 20 drafts. The request shares the RFQ-create schema, but only quantity, strategy, and legs are persisted; is_anonymous, counterparties, and label are ignored.

Draft validation permits work in progress. A draft accepts up to 25 legs. Quantity and ratios must be positive decimal strings, every market must exist on Paradex, side must be BUY or SELL, and a supplied hedge-leg price must be positive. strategy is limited to 64 bytes and defaults to custom when omitted. The cross-leg strategy rules enforced by RFQ creation do not apply until the draft is submitted through POST /v1/rfqs.

Authentication

Authorizationstring
API Key authentication via header

Request

RFQ draft create request (single common input with POST /rfqs; is_anonymous, counterparties and label are ignored for drafts)

legslist of objectsRequired

Strategy and optional fixed-price hedge legs; maximum 25

quantitystringRequired
Positive total strategy size
counterpartieslist of stringsOptional

Reserved for future use; currently ignored for RFQ creation and drafts

is_anonymousbooleanOptional

Whether to hide the taker desk name from RFQ counterparties; ignored for drafts

labelstringOptional

User-defined RFQ label; ignored for drafts

max_slippagestringOptional
MaxSlippage sets the collateral held against this RFQ while it is open, as a fraction of underlying spot, replacing the configured bound for this RFQ only. It does not limit the price the RFQ may execute at. Empty leaves the configured one in place. Ignored for drafts.
sideenumOptional

Side commits the RFQ to one direction of the strategy, which is then the only direction it may be executed in. Empty leaves it two-way. Ignored for drafts.

Allowed values:
strategystringOptional

Draft strategy label; maximum 64 bytes and defaults to custom for drafts; ignored on RFQ create

Response

Created
created_atintegerOptional
Unix milliseconds
idstringOptional

Opaque application-generated RFQ draft identifier

legslist of objectsOptional
quantitystringOptional
strategystringOptional

User-facing strategy label

updated_atintegerOptional
Unix milliseconds

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error