Create RFQ draft

POST

https://api.prod.paradex.trade/v1/rfqs/drafts

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.

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.

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