latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-20125174417.3 KB

e8fca3e578c7

Rfqs

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.

post/rfqs/drafts

Request body

counterpartiesstring[]

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

is_anonymousboolean

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

labelstring

User-defined RFQ label; ignored for drafts

max_slippagestring

MaxSlippage bounds how far this RFQ may execute from mark, as a fraction of underlying spot, replacing the configured bound for this RFQ only. Empty leaves the configured one in place. Ignored for drafts.

quantitystring required

Positive total strategy size

strategystring

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

Example request

{
  "is_anonymous": true,
  "label": "my-rfq",
  "legs": [
    {
      "market": "BTC-USD-PERP",
      "price": "30000.00",
      "ratio": "1",
      "side": "BUY"
    }
  ],
  "max_slippage": "0.002",
  "quantity": "100",
  "strategy": "straddle"
}

Response

Created

created_atinteger

Unix milliseconds

idstring

Opaque application-generated RFQ draft identifier

quantitystring
strategystring

User-facing strategy label

updated_atinteger

Unix milliseconds

Example response

{
  "created_at": 1640995200000,
  "id": "1784275070090201698744820000",
  "legs": [
    {
      "market": "BTC-USD-PERP",
      "price": "50000",
      "ratio": "1"
    }
  ],
  "quantity": "10",
  "strategy": "straddle",
  "updated_at": 1640995200000
}