Create RFQ
Create a new Block RFQ. For taker only.
Endpoint
block/rfqs/create_rfq
Parameters
| Parameter |
Type |
Required |
Description |
| accountId |
long |
true |
Signalplus account ID |
| label |
string |
false |
User defined label for the Block RFQ (maximum 64 characters) |
| makers |
array of string |
false |
The exchange Desk Names the RFQ was directed towards |
| disclosed |
boolean |
false |
Determines whether the RFQ is non-anonymous |
| legs |
array of objects |
true |
The individual legs of the RFQ |
| > instrumentName |
string |
true |
Instrument name |
| > quantity |
string |
true |
This value multiplied by the ratio of a leg gives trade size on that leg |
| > side |
string |
true |
The direction of the leg. Valid values: buy, sell |
| hedge |
object |
false |
Hedge leg of the Block RFQ. There is only one hedge leg allowed per Block RFQ |
| > instrumentName |
string |
true |
Instrument name |
| > quantity |
string |
true |
It represents the requested trade size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin |
| > side |
string |
true |
The direction of the leg. Valid values: buy, sell |
| > price |
string |
true |
Price of a quote |
| strategy |
string |
false |
Combo trade strategy |
Request Example
{
"rid": 716396245765857200,
"method": "block/rfqs/create_rfq",
"params": {
"label": "716396245765857131",
"accountId": 10003723,
"makers": null,
"disclosed": true,
"legs": [
{
"instrumentName": "BTC-USDC-20251226-160000-P",
"ratio": null,
"side": "sell",
"quantity": "0.880",
"price": null
},
{
"instrumentName": "BTC-USDC-20251226-160000-C",
"ratio": null,
"side": "sell",
"quantity": "1.000",
"price": null
},
{
"instrumentName": "BTC-USDC-20251226-140000-P",
"ratio": null,
"side": "buy",
"quantity": "0.290",
"price": null
}
],
"hedge": {
"instrumentName": "BTC-USDC-PERP",
"quantity": "0.1",
"side": "buy",
"price": "110000"
},
"strategy": null
}
}
Response
| Name |
Type |
Description |
| quantity |
string |
This value multiplied by the ratio of a leg gives trade size on that leg |
| blockRfqId |
string |
The exchange created unique identifier of the RFQ |
| accountId |
long |
Signalplus account ID |
| createdAt |
long |
The time in UNIX milliseconds since the epoch when the RFQ was created |
| expiresAt |
long |
The time in UNIX milliseconds since the epoch when the RFQ expires |
| makers |
Array of strings |
The exchange Desk Names the RFQ was directed towards. An empty array is returned if role == maker |
| role |
string |
The role of the user to the RFQ. Valid values: taker, maker |
| legs |
Array of Objects |
The composite Instrument legs of the RFQ |
| > instrumentName |
string |
Instrument name |
| > ratio |
int |
The relative multiplier applied to the quantity of the Instrument's amount relative to the amount of the RFQ |
| > side |
string |
The direction of the composite leg relative to the RFQ. Valid values: buy, sell |
| > price |
string |
null for non-hedge legs |
| > quantity |
string |
The total size of the composite Instrument legs, equals to RFQ's quantity. Quantity * ratio is the real quantity of leg |
| hedge |
object |
Hedge leg of the Block RFQ. There is only one hedge leg allowed per Block RFQ |
| > instrumentName |
string |
Instrument name |
| > quantity |
string |
It represents the requested trade size. For perpetual and inverse futures the amount is in USD units. For options and linear futures it is the underlying base currency coin |
| > side |
string |
The direction of the leg. Valid values: buy, sell |
| > price |
string |
Hedge price |
| disclosed |
boolean |
Indicates whether the RFQ was created as non-anonymous, meaning taker and maker aliases are visible to counterparties |
| label |
string |
RFQ creator label of the RFQ |
| status |
string |
The availability of the RFQ to trade. Valid values: create, open, filled, traded, cancelled, expired, closed |
| closedReason |
string |
The reason the RFQ is no longer available. null if the RFQ's status == open |
| taker |
string |
Present only when disclosed is true |
| strategy |
string |
Combo trade strategy |
Response Example
{
"rid": 716396245765857200,
"result": {
"blockRfqId": "792633537032424109",
"accountId": 10003723,
"createdAt": 1759044969818,
"expiresAt": 1759045269818,
"makers": null,
"role": "taker",
"legs": [
{
"instrumentName": "BTC-USDC-20251226-160000-P",
"ratio": 88,
"side": "sell",
"quantity": "0.01",
"price": null
},
{
"instrumentName": "BTC-USDC-20251226-160000-C",
"ratio": 100,
"side": "sell",
"quantity": "0.01",
"price": null
},
{
"instrumentName": "BTC-USDC-20251226-140000-P",
"ratio": 29,
"side": "buy",
"quantity": "0.01",
"price": null
}
],
"hedge": {
"instrumentName": "BTC-USDC-PERP",
"quantity": "0.1",
"side": "buy",
"price": "110000"
},
"quantity": "0.01",
"disclosed": true,
"label": "716396245765857131",
"status": "open",
"closedReason": null,
"strategy": "CUSTOM",
"taker": "duplicate_test_1758872672048"
}
}