Create Combo
Method: private/create_combo
Parameters
| Parameter |
Type |
Required |
Description |
| trades |
Array of object |
true |
List of trades used to create a combo |
trades Object
| Parameter |
Type |
Required |
Description |
| instrumentName |
string |
true |
Instrument name |
| quantity |
string |
false |
It represents the requested trade size. For perpetual and inverse futures the amount is in USD units. For options and linear futures and it is the underlying base currency coin |
| side |
string |
true |
Direction of trade from the maker perspective |
Request Example
{
"rid": 1004,
"method": "private/create_combo",
"params": {
"trades": [
{
"instrumentName": "BTC-26JUN26-80000-C",
"quantity": "1",
"side": "buy"
},
{
"instrumentName": "BTC-26JUN26-90000-C",
"quantity": "1",
"side": "sell"
}
]
}
}
Response
| Name |
Type |
Description |
| createdAt |
long |
The timestamp (milliseconds since the Unix epoch) |
| comboId |
string |
Unique combo identifier |
| instrumentId |
integer |
Instrument id |
| legs |
array of object |
|
| > quantity |
integer |
Size multiplier of a leg. A negative value indicates that the trades on given leg are in opposite direction to the combo trades they originate from |
| > instrumentName |
string |
Unique instrument identifier |
| state |
string |
Combo state: "rfq", "active", "inactive" |
| stateTimestamp |
long |
The timestamp (milliseconds since the Unix epoch) |
Response Example
{
"rid": 1004,
"result": {
"createdAt": 1760172347000,
"comboId": "BTC-CS-26JUN26-80000_90000",
"instrumentId": 481831,
"legs": [
{"quantity": "1", "instrumentName": "BTC-26JUN26-80000-C"},
{"quantity": "-1", "instrumentName": "BTC-26JUN26-90000-C"}
],
"state": "active",
"stateTimestamp": 1760172347607
}
}