Batch Amend Order

Covers: Spot (UTA, UTA Pro) / Option (UTA, UTA Pro) / USDT Perpetual, USDC Perpetual, USDC Futures (UTA Pro)

tip

This endpoint allows you to amend more than one open order in a single request.

• You can modify unfilled or partially filled orders. Conditional orders are not supported.
• A maximum of 20 orders (option), 10 orders (linear) & 10 orders (spot) can be amended per request.

HTTP Request

POST /v5/order/amend-batch

Request Parameters

Parameter	Required	Type	Comments
category	true	string	Product type. linear, option, spot
request	true	array	Object
> symbol	true	string	Symbol name
> orderId	false	string	Order ID. Either orderId or orderLinkId is required
> orderLinkId	false	string	User customised order ID. Either orderId or orderLinkId is required
> orderIv	false	string	Implied volatility. option only. Pass the real value, e.g for 10%, 0.1 should be passed
> triggerPrice	false	string	For Perps & Futures, it is the conditional order trigger price. If you expect the price to rise to trigger your conditional order, make sure: triggerPrice > market price Else, triggerPrice < market price For spot, it is for tpslOrder or stopOrder trigger price
> qty	false	string	Order quantity after modification. Do not pass it if not modify the qty
> price	false	string	Order price after modification. Do not pass it if not modify the price
> tpslMode	false	string	TP/SL mode Full: entire position for TP/SL. Then, tpOrderType or slOrderType must be Market Partial: partial position tp/sl. Limit TP/SL order are supported. Note: When create limit tp/sl, tpslMode is required and it must be Partial Valid for linear
> takeProfit	false	string	Take profit price after modification. If pass "0", it means cancel the existing take profit of the order. Do not pass it if you do not want to modify the take profit. valid for spot, linear
> stopLoss	false	string	Stop loss price after modification. If pass "0", it means cancel the existing stop loss of the order. Do not pass it if you do not want to modify the stop loss. valid for spot, linear
> tpTriggerBy	false	string	The price type to trigger take profit. When set a take profit, this param is required if no initial value for the order
> slTriggerBy	false	string	The price type to trigger stop loss. When set a take profit, this param is required if no initial value for the order
> triggerBy	false	string	Trigger price type
> tpLimitPrice	false	string	Limit order price when take profit is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear
> slLimitPrice	false	string	Limit order price when stop loss is triggered. Only working when original order sets partial limit tp/sl. valid for spot, linear

Response Parameters

Parameter	Type	Comments
result	Object
> list	array	Object
>> category	string	Product type
>> symbol	string	Symbol name
>> orderId	string	Order ID
>> orderLinkId	string	User customised order ID
retExtInfo	Object
> list	array	Object
>> code	number	Success/error code
>> msg	string	Success/error message

---

Request Example

HTTP

POST /v5/order/amend-batch HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1672222935987
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "category": "option",
    "request": [
        {
            "symbol": "ETH-30DEC22-500-C",
            "qty": null,
            "price": null,
            "orderIv": "6.8",
            "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
        },
        {
            "symbol": "ETH-30DEC22-700-C",
            "qty": null,
            "price": "650",
            "orderIv": null,
            "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
        }
    ]
}

Python

from pybit.unified_trading import HTTP
session = HTTP(
    testnet=True,
    api_key="XXXXX",
    api_secret="XXXXX",
)
print(session.amend_batch_order(
    category="option",
    request=[
        {
            "category": "option",
            "symbol": "ETH-30DEC22-500-C",
            "orderIv": "6.8",
            "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2"
        },
        {
            "category": "option",
            "symbol": "ETH-30DEC22-700-C",
            "price": "650",
            "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52"
        }
    ]
))

Java

import com.bybit.api.client.restApi.BybitApiAsyncTradeRestClient;
import com.bybit.api.client.domain.ProductType;
import com.bybit.api.client.domain.TradeOrderType;
import com.bybit.api.client.domain.trade.*;
import com.bybit.api.client.service.BybitApiClientFactory;
import java.util.Arrays;
BybitApiClientFactory factory = BybitApiClientFactory.newInstance("YOUR_API_KEY", "YOUR_API_SECRET");
BybitApiAsyncTradeRestClient client = factory.newAsyncTradeRestClient();
var amendOrderRequests = Arrays.asList(TradeOrderRequest.builder().symbol("BTC-10FEB23-24000-C").qty("0.1").price("5").orderLinkId("9b381bb1-401").build(),
                TradeOrderRequest.builder().symbol("BTC-10FEB23-24000-C").qty("0.1").price("5").orderLinkId("82ee86dd-001").build());
var amendBatchOrders = BatchOrderRequest.builder().category(ProductType.OPTION).request(amendOrderRequests).build();
client.createBatchOrder(amendBatchOrders, System.out::println);

.Net

using bybit.net.api.ApiServiceImp;
using bybit.net.api.Models.Trade;
var order1 = new OrderRequest { Symbol = "XRPUSDT", OrderId = "xxxxxxxxxx", Qty = "10", Price = "0.6080" };
var order2 = new OrderRequest { Symbol = "BLZUSDT", OrderId = "xxxxxxxxxx", Qty = "15", Price = "0.6090" };
var orderInfoString = await TradeService.AmendBatchOrder(category:Category.LINEAR, request: new List<OrderRequest> { order1, order2 });
Console.WriteLine(orderInfoString);

Node.js

const { RestClientV5 } = require('bybit-api');

const client = new RestClientV5({
    testnet: true,
    key: 'apikey',
    secret: 'apisecret',
});

client
    .batchAmendOrders('option', [
        {
            symbol: 'ETH-30DEC22-500-C',
            orderIv: '6.8',
            orderId: 'b551f227-7059-4fb5-a6a6-699c04dbd2f2',
        },
        {
            symbol: 'ETH-30DEC22-700-C',
            price: '650',
            orderId: 'fa6a595f-1a57-483f-b9d3-30e9c8235a52',
        },
    ])
    .then((response) => {
        console.log(response);
    })
    .catch((error) => {
        console.error(error);
    });

Response Example

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "list": [
            {
                "category": "option",
                "symbol": "ETH-30DEC22-500-C",
                "orderId": "b551f227-7059-4fb5-a6a6-699c04dbd2f2",
                "orderLinkId": ""
            },
            {
                "category": "option",
                "symbol": "ETH-30DEC22-700-C",
                "orderId": "fa6a595f-1a57-483f-b9d3-30e9c8235a52",
                "orderLinkId": ""
            }
        ]
    },
    "retExtInfo": {
        "list": [
            {
                "code": 0,
                "msg": "OK"
            },
            {
                "code": 0,
                "msg": "OK"
            }
        ]
    },
    "time": 1672222808060
}