Skip to main content

Get RFQs

Obtain historical inquiry information. Up to 50 requests per second

info
  • Obtain historical RFQs. This data is not real-time. Please see Get RFQs (real-time).
  • If both rfqId and rfqLinkId are passed, only rfqId is considered.
  • Sort in reverse order according to the creation time of rfq and return it.

HTTP Request

GET/v5/rfq/rfq-list

Request Parameters

ParameterRequiredTypeComments
rfqIdfalse**stringInquiry ID
rfqLinkIdfalsestringCustom ID for RFQ; specify rfqLinkId to only check the last 3 months, traderType is quote, this field is invalid
traderTypefalsestringTrader type, quote , request. Default: quote
statusfalsestringStatus of the RFQ: Active Canceled Filled Expired Failed
limitfalseintegerReturn the number of items. [1, 100]. Default: 50
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

ParameterTypeComments
resultarrayObject
> cursorstringRefer to the cursor request parameter
> listarrayAn array of RFQs
>> rfqIdstringInquiry ID
>> rfqLinkIdstringCustom RFQ ID. Not publicly disclosed.
>> counterpartiesarray of sringsList of bidders
>> expiresAtstringThe inquiry's expiration time (ms)
>> strategyTypestringInquiry label
>> statusstringStatus of the RFQ: Active PendingFill Canceled Filled Expired Failed
> acceptOtherQuoteStatusstringWhether to accept non-LP quotes. The default value is false: false: Default value, do not accept non-LP quotes. true: Accept non-LP quotes
>> deskCodestringThe unique identification code of the inquiring party, which is not visible when anonymous was set to true when the RFQ was created
>> anonymousbooleanWhether the RFQ is anonymous
>> createdAtstringTime (ms) when the trade is created in epoch, such as 1650380963
>> updatedAtstringTime (ms) when the trade is updated in epoch, such as 1650380964
>> legsarray of objectsCombination transaction
>>> categorystringcategory. Valid values include: linear, option and spot
>>> symbolstringThe unique instrument ID
>>> sidestringInquiry direction: Valid values are Buy and Sell.
>>> qtystringOrder quantity of the instrument.
>> hedgearray of objectsDelta Hedge leg object
>>> categorystringProduct type. Unified account: spot, linear, option
>>> symbolstringName of the trading contract
>>> sidestringInquiry transaction direction: Buy, Sell
>>> qtystringTrade quantity. If it exceeds the position size, the position will open in the reverse direction
>>> pricestringTaker's desired Delta Hedge execution price, passed to the market maker for reference only. The maker is not obligated to quote the hedge leg. If the taker sets this price and the hedge leg is ultimately executed, it will be filled at this price

Request Example

GET /v5/rfq/rfq-list HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1676430842094
X-BAPI-RECV-WINDOW: 5000
X-BAPI-SIGN: XXXXXX

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"cursor": "",
"list": [
{
"rfqLinkId": "",
"rfqId": "1756885055799241492396882271696580",
"counterparties": [
"hashwave2"
],
"strategyType": "custom",
"expiresAt": "1756885655801",
"status": "Active",
"acceptOtherQuoteStatus":"false",
"deskCode": "1nu9d1",
"anonymous": false,
"createdAt": "1756885055801",
"updatedAt": "1756885055801",
"legs": [
{
"category": "option",
"symbol": "BTC-25JUL25-100000-C",
"side": "Buy",
"qty": "100"
}
],
"hedge": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Sell",
"qty": "46",
"price": "121500.0"
}
]
},
{
"rfqLinkId": "",
"rfqId": "1756874158983736854420161904593980",
"counterparties": [
"hashwave2"
],
"strategyType": "custom",
"expiresAt": "1756874758985",
"status": "Expired",
"deskCode": "1nu9d1",
"createdAt": "1756874158985",
"updatedAt": "1756874764046",
"legs": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Buy",
"qty": "1"
}
]
},
{
"rfqLinkId": "",
"rfqId": "1756871488168105512459181956436945",
"counterparties": [
"hashwave2"
],
"strategyType": "custom",
"expiresAt": "1756872088171",
"status": "Canceled",
"deskCode": "1nu9d1",
"createdAt": "1756871488171",
"updatedAt": "1756871494505",
"legs": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Buy",
"qty": "1"
}
]
}
]
},
"retExtInfo": {},
"time": 1756885352116
}