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
>> deskCodestringThe unique identification code of the inquiring party, which is not visible when anonymous was set to true when the RFQ was created
>> 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.

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",
"deskCode": "1nu9d1",
"createdAt": "1756885055801",
"updatedAt": "1756885055801",
"legs": [
{
"category": "linear",
"symbol": "BTCUSDT",
"side": "Buy",
"qty": "1"
}
]
},
{
"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
}