Skip to navigation

Execute RFQ

Queues a taker limit Fill-or-Kill order against an RFQ.

Execution is asynchronous. Subscribe to the private WebSocket channel rfq before sending the request. A 202 Accepted response contains a Paradex request_id and confirms only that the command was queued. The later WebSocket RESULT event with the same request_id reports success or failure; on success, result.order_id is the venue-issued order identifier.

quantity must be a positive decimal string. side is BUY or SELL. price is the signed net strategy price, so zero and negative values are valid for multi-leg credit strategies.

side must be a direction the RFQ was accepted for, which its create result reports as result.allowed_side: the direction an RFQ created with a side was committed to, or either direction for a TWO_WAY one. An execute on any other side is rejected by the RESULT event, because the collateral held against the RFQ never covered it. An empty result.allowed_side is an RFQ Paradex did not risk-check, which holds no such collateral and accepts either direction.

Validation or risk-check failures that occur after queueing are reported by the WebSocket RESULT event.

Authentication

Authorizationstring
API Key authentication via header

Path parameters

rfq_idstringRequired

Paradigm-issued RFQ id

Request

Order details
pricestringRequired

Signed decimal strategy price; zero and negative values are valid

quantitystringRequired
Positive decimal strategy quantity
sideenumRequired
Taker order side
Allowed values:
labelstringOptional

User-defined order label

Response

Accepted
accepted_atintegerOptional
Unix milliseconds when the request was queued
request_idstringOptional

request_id identifies this request. It is echoed on the RESULT event delivered later on the WebSocket rfq channel, so a client with several requests in flight can match each outcome to the request that caused it. On Create it is the only identifier available until the venue issues the rfq_id.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error