REST API›Trade›Orders

POST

RFQ - Request for Quote

Solicits a quote for the requested size in base or counter currency.

The returned quote is valid until expirationDate. Use POST /accounts/{accountId}/rfq/order with the quote id to place an order priced off this quote. Requesting an identical quote (same account, product, side, quantity and quantity currency) while an identical quote is still active returns the existing quote.

Path Params

  • accountId string required
    The ID of the account

Body Params

object

  • product string required
    Product name in BASE-QUOTE format (e.g. BTC-USD). Must be an RFQ-supported product.
  • side string enum required
    The side of the order
    buysell
  • quantity string required
    Requested quantity, denominated in quantityCurrency
  • quantityCurrency string required
    Currency the quantity is denominated in (base or quote currency of the product)

Responses

200
An RFQ quote

Response Body

object

  • id string uuid
    ID of the RFQ quote. Pass it as quoteId when placing an RFQ order.
  • product string
    Product name
  • side string enum
    The side of the order
    buysell
  • quotedPrice string
    All-in price the client pays (or receives, on sells)
  • quotedQuantity string
    Quantity denominated in quotedQuantityCurrency
  • quotedQuantityCurrency string
    Currency the quote is denominated in
  • quantityCurrency string
    Currency of the client-requested quantity (echoes the request)
  • quantity string
    Client-requested quantity (echoes the request)
  • expirationDate string date-time
    Time after which the quote can no longer be used to place an order
400
Bad request - Invalid quote parameters

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
401
Unauthorized - Invalid or missing authentication

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
403
Forbidden - RFQ disabled for your enterprise, or the product does not support RFQ

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
422
Unprocessable Entity - JSON payload is improperly formatted

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
429
Too Many Requests - Rate limit exceeded

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
500
Internal Server Error

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.
503
No liquidity - No valid quote before the timeout

Response Body

object

  • error string required
  • errorName string required
  • reqId string required
  • context object
    Optional structured metadata for REST validation failures. The schema is fixed for client contract stability.
    context object
    • errorName string required
      Same value as the top-level errorName.
    • field string
      Request field associated with the validation failure.
    • message string
      Human-readable field-level validation message.