Create RFQ

Create RFQ. Up to 50 requests per second.

info

• Only supports UTA2.0 accounts
• Only supports full position and combined margin mode
• Not supported by demo users
• Cannot choose oneself as the bidder

HTTP Request

POST/v5/rfq/create-rfq

Request Parameters

Parameter	Required	Type	Comments
counterparties	true	array	Spread combination symbol name
rfqLinkId	false	string	Custom RFQ ID The length should be between 1-32 bits Combination of letters (case sensitive) and numbers An rfqLinkId expires after three months – after which it can be reused Open orders must have a unique ID whereas orders that have reached a final/terminated status do not have to be unique.
anonymous	false	boolean	Whether or not it is anonymous inquiry. The default value is false. When it is true the identity of the inquiring party will not be revealed even after the transaction is concluded. When anonymous is true, the deskCode field returned by Get RFQ will be an empty string
strategyType	false	string	Strategy type, if it is a custom inquiry, strategyType is custom, if it is a product combination provided by the system, it is the combination type; the default is custom; non-custom combinations have rate optimization, currently 50%; the transaction rate between LPs is currently 30%
list	true	array of objects	Combination transaction list Use Get RFQ Configuration to confirm the maximum length of the combination (maxLegs) The base coin and settle coin of all combinations must be the same Symbols under the same category must be unique
> category	true	string	Product type: Unified account: spot, linear,option
> symbol	true	string	Name of the transaction contract. No inquiries are allowed in the last 30 minutes before contract settlement
> side	true	string	Inquiry transaction direction: Buy , Sell
> qty	true	string	If the number of transactions exceeds the position size, the position will then open in the reverse direction
hedge	false	array of objects	Delta Hedge leg object (single object, not an array). The entire hedge object is optional; if omitted, this RFQ has no hedge leg
> category	true	string	Product type. Only linear is supported initially (perpetual / linear delivery futures)
> symbol	true	string	Hedge contract name, e.g. BTCUSDT (perpetual) or BTC-27JUN25 (linear delivery futures). The underlying asset must match the main strategy legs (list). Cross-asset hedging is not supported
> side	true	string	Inquiry transaction direction: Buy, Sell
> qty	true	string	Trade quantity. If it exceeds the position size, the position will open in the reverse direction
> price	false	string	Taker's desired Delta Hedge execution price, passed to the market maker for reference only. The maker may override this price in create-quote. Price validation reuses the existing derivatives limit-price logic; out-of-range values are automatically corrected

Response Parameters

Parameter	Type	Comments
result	array	Order ID
list	array of objects
> rfqId	string	Inquiry ID
> rfqLinkId	string	Custom inquiry ID
> status	string	Status of the RFQ: Active Canceled Filled Expired Failed
> expiresAt	string	The inquiry's expiration time (ms)
> deskCode	string	Inquiring party's unique identification code

Request Example

HTTP

POST /v5/rfq/create-rfq HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1744083949347
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 115

{
    "counterparties": ["SPMAKERTEST"],
    "rfqLinkId": "V2-Integration-Test-RFQ",
    "anonymous": false,
    "strategyType": "custom",
    "list": [
        {
            "category": "option",
            "symbol": "BTC-25JUL25-100000-C",
            "side": "Buy",
            "qty": "100"
        }
    ],
    "hedge": [
        {
            "category": "linear",
            "symbol": "BTCUSDT",
            "side": "Sell",
            "qty": "46",
            "price": "121500.0"
        }
    ]
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
)
print(session.create_rfq(
    counterparties=["SPMAKERTEST"],
    rfqLinkId="V2-Integration-Test-RFQ",
    anonymous=False,
    strategyType="custom",
    list=[
        {
            "category": "option",
            "symbol": "BTC-25JUL25-100000-C",
            "side": "Buy",
            "qty": "100"
        }
    ],
    hedge=[
        {
            "category": "linear",
            "symbol": "BTCUSDT",
            "side": "Sell",
            "qty": "46",
            "price": "121500.0"
        }
    ]
))

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "rfqId": "17526315514105706281",
        "rfqLinkId": "rfq00993",
        "status": "Active",
        "expiresAt": "1752632151414",
        "deskCode": "LP2"
    },
    "retExtInfo": {},
    "time": 1752631551419
}