Submit firm quote

REQUEST wss://connection.bitvavo.com:8004/rfq/v1 firmQuote

Submits a firm quote during the collection window of an active RFQ cycle. Quotes that arrive after the window closes are rejected with collectionMiss.

Request

Schema

Body

actionstringrequired
Set to firmQuote to submit a firm quote.
Possible values: [firmQuote]
Example: firmQuote
requestIdinteger<int64>
An identifier that you assign to the request. The server echoes it back in the matching response so you can correlate the two.
Example: 9021001
rfqIdinteger<int64>required
The unique identifier of the RFQ session.
Example: 840001234567
rfqCycleIdinteger<int32>required
The identifier of the current cycle within the RFQ session. A cycle is one round of quote collection. It begins when the taker starts or refreshes the RFQ session, and ends when the collection window closes.
The value starts at 0 for the first cycle, and increases by 1 each time the taker refreshes the RFQ.
Example: 2
clientQuoteIdstring<uuid>required
A unique identifier (UUID) that you assign to the quote. Used for tracing only.
Example: 5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb
pricestringrequired
The price per unit of the base asset in the quote currency, with your spread included.
Example: 41280.55
operatorIdinteger<int64>
The numeric identifier of the operator.
Example: 12345
settlementAccountIdstring<uuid>
Optional. The account you want your side of the trade settled to. It must be on your settlement-account whitelist. If you omit this field, or if the account is not on the whitelist, your default settlement account is applied.
Example: 0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0

Example (body)

{
  "action": "firmQuote",
  "requestId": 9021004,
  "rfqId": 840001234567,
  "rfqCycleId": 2,
  "clientQuoteId": "5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb",
  "price": "41280.55",
  "operatorId": 12345,
  "settlementAccountId": "0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0"
}

Response

quoteAck

Schema

Schema

eventstringrequired
The quote entered the competition, and you are now a participant in the RFQ session.
Possible values: [quoteAck]
Example: quoteAck
rfqIdinteger<int64>required
The unique identifier of the RFQ session.
Example: 840001234567
rfqCycleIdinteger<int32>required
The identifier of the current cycle within the RFQ session. A cycle is one round of quote collection. It begins when the taker starts or refreshes the RFQ session, and ends when the collection window closes.
The value starts at 0 for the first cycle, and increases by 1 each time the taker refreshes the RFQ.
Example: 2
basestring
The code of the asset (for example, BTC or EUR).
Example: BTC
quote
clientQuoteIdstring<uuid>required
A unique identifier (UUID) that you assign to the quote. Used for tracing only.
Example: 5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb
quoteIdinteger<int64>required
The internal identifier of the quote, assigned by Bitvavo. Used for tracing and reporting.
Example: 90011223344
timestampinteger<int64>required
A Unix timestamp in milliseconds.
Example: 1739462400123
operatorIdinteger<int64>
The numeric identifier of the operator.
Example: 12345
requestIdinteger<int64>
An identifier that you assign to the request. The server echoes it back in the matching response so you can correlate the two.
Example: 9021001
settlementAccountIdstring<uuid>
The account that was applied to this quote. If you omitted settlementAccountId on the firmQuote, or sent an account that is not on your whitelist, this is your default settlement account.
Example: 0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0

Example (body)

{
  "event": "quoteAck",
  "rfqId": 840001234567,
  "rfqCycleId": 2,
  "base": "BTC",
  "quote": "EUR",
  "clientQuoteId": "5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb",
  "quoteId": 90011223344,
  "timestamp": 1739462400255,
  "settlementAccountId": "0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0"
}

quoteNack

Schema

Schema

eventstringrequired
The quote was rejected. The response includes a reason.
Possible values: [quoteNack]
Example: quoteNack
rfqIdinteger<int64>required
The unique identifier of the RFQ session.
Example: 840001234567
rfqCycleIdinteger<int32>required
The identifier of the current cycle within the RFQ session. A cycle is one round of quote collection. It begins when the taker starts or refreshes the RFQ session, and ends when the collection window closes.
The value starts at 0 for the first cycle, and increases by 1 each time the taker refreshes the RFQ.
Example: 2
basestring
The code of the asset (for example, BTC or EUR).
Example: BTC
quote
clientQuoteIdstring<uuid>required
A unique identifier (UUID) that you assign to the quote. Used for tracing only.
Example: 5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb
reasonstringrequired
The reason for the rejection. Possible values:
• unknownRfq — the rfqId or rfqCycleId does not match an active RFQ session or cycle.
• invalidPrice — the value of price is malformed or outside the acceptable limits.
• invalidQuoteAmount — the amount in the quote currency, derived from price and amount, is malformed or outside the acceptable limits.
• insufficientFunds — you do not have enough balance to back the quote.
• collectionMiss — the quote arrived after the collection window closed.
• quoteTooWide — the price of the quote is beyond the maximum spread allowed from the reference price.
Possible values: [unknownRfq, invalidPrice, invalidQuoteAmount, insufficientFunds, collectionMiss, quoteTooWide]
Example: invalidPrice
timestampinteger<int64>required
A Unix timestamp in milliseconds.
Example: 1739462400123
operatorIdinteger<int64>
The numeric identifier of the operator.
Example: 12345
requestIdinteger<int64>
An identifier that you assign to the request. The server echoes it back in the matching response so you can correlate the two.
Example: 9021001

Example (body)

{
  "event": "quoteNack",
  "rfqId": 840001234567,
  "rfqCycleId": 2,
  "base": "BTC",
  "quote": "EUR",
  "clientQuoteId": "5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb",
  "reason": "invalidPrice",
  "timestamp": 1739462400255
}

rfqTrade

Schema

Schema

eventstringrequired
Your quote won — it had the best price and earliest arrival time, and the taker accepted it. You are the winning maker.
Possible values: [rfqTrade]
Example: rfqTrade
rfqIdinteger<int64>required
The unique identifier of the RFQ session.
Example: 840001234567
rfqCycleIdinteger<int32>required
The identifier of the current cycle within the RFQ session. A cycle is one round of quote collection. It begins when the taker starts or refreshes the RFQ session, and ends when the collection window closes.
The value starts at 0 for the first cycle, and increases by 1 each time the taker refreshes the RFQ.
Example: 2
rfqTypestringrequired
The type of the RFQ. Possible values:
• priceGuarantee — the standard Price Guarantee RFQ for spot markets.
• priceGuaranteeUK — the Price Guarantee RFQ variant for United Kingdom customers.
• priceGuaranteeConvert — the Price Guarantee RFQ variant used for asset-to-asset conversions (the Convert product).
Possible values: [priceGuarantee, priceGuaranteeUK, priceGuaranteeConvert]
Example: priceGuarantee
clientQuoteIdstring<uuid>required
A unique identifier (UUID) that you assign to the quote. Used for tracing only.
Example: 5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb
quoteIdinteger<int64>required
The internal identifier of the quote, assigned by Bitvavo. Used for tracing and reporting.
Example: 90011223344
tradeIdinteger<int64>required
The unique identifier of the resulting trade.
Example: 778899001
basestringrequired
The code of the asset (for example, BTC or EUR).
Example: BTC
quoterequired
takerSidestringrequired
The side of the trade from the perspective of the taker. Possible values:
• BUY — the taker buys the base asset.
• SELL — the taker sells the base asset.
Possible values: [BUY, SELL]
Example: BUY
pricestringrequired
The price per unit of the base asset in the quote currency, as you quoted it. Used for settlement.
Example: 41280.55
quantitystringrequired
The settled amount, denominated in the base asset.
Example: 0.25000000
operatorIdinteger<int64>
The numeric identifier of the operator.
Example: 12345
makerFeeBpsstringrequired
The maker fee in basis points.
Example: 80.0
feeQuantitystringrequired
The settled fee amount, denominated in feeCurrency. May be rounded.
Example: 8.25611200
quoteQuantitystringrequired
The settled amount, denominated in the quote asset. May be rounded.
Example: 10320.13750000
feeCurrencystringrequired
The asset in which the fee is denominated.
Example: EUR
settledbooleanrequired
Indicates whether the trade has been settled. Always true for Price Guarantee RFQ types.
Example: true
timestampinteger<int64>required
A Unix timestamp in milliseconds.
Example: 1739462400123

Example (body)

{
  "event": "rfqTrade",
  "rfqId": 840001234567,
  "rfqCycleId": 2,
  "rfqType": "priceGuarantee",
  "clientQuoteId": "5d8f2ab0-09d0-4f11-8b4a-3f8ea4c4a5cb",
  "quoteId": 90011223344,
  "tradeId": 778899001,
  "base": "BTC",
  "quote": "EUR",
  "takerSide": "BUY",
  "price": "41280.55",
  "quantity": "0.25000000",
  "operatorId": 12345,
  "makerFeeBps": "80.0",
  "feeQuantity": "8.25611200",
  "quoteQuantity": "10320.13750000",
  "feeCurrency": "EUR",
  "settled": true,
  "timestamp": 1739462405520
}