Multi Order

This API allows you to place multiple orders in a single request.

USE CASE

Place multiple buy or sell orders in a single request.

Details

You can place upto 10 orders simultaneously via the API.
While Placing Multi orders you need to pass an ARRAY containing the orders request attributes
Send an array of up to 10 orders. Each order uses the same attributes as the Single Order API.
Placing orders needs an app with the Order Placement permission.
Placing, modifying and cancelling orders together must stay within 10 orders per second. Requests beyond this limit are rejected.
Price inputs must be multiples of the symbol tick size, and quantity must follow the lot-size rules, for every order in the array.
orderTag, when passed, must be 1 to 30 letters or digits and cannot be your client ID or Untagged.
The response has one entry per order, each with its own statusCode, code, message and order id. Check every entry, not only the top-level status.
To get hedge margin benefits on related orders, use this API rather than the Multi-leg Order API, which does not support them.
To change or cancel these orders, use Modify Multi Order or Cancel Multi Order.
For order types, product types, validations and sync vs async behaviour, refer to the Order Placement Guide.
When order rate limiting is triggered, the API returns 429 Too Many Requests.
Retry timing is provided through response headers, not in the response body.
Retry-After — Wait time before retrying, in seconds
X-Retry-After-Ms — Wait time before retrying, in milliseconds
Use the retry interval returned in the response headers before sending another order request.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes

Attribute	Data Type	Description
`symbol`*	string	Eg: NSE:SBIN-EQ
`qty`*	int	The quantity should be in multiples of lot size for derivatives.
`type`*	int	1 => Limit Order 2 => Market Order 3 => Stop Order (SL-M) 4 => Stoplimit Order (SL-L) View Details
`side`*	int	1 => Buy -1 => Sell View Details
`productType`*	string	CNC => For equity only INTRADAY => Applicable for all segments. MARGIN => Applicable only for derivatives MTF => Approved Symbols Only View Details
`limitPrice`*	float	Default => 0 Provide valid price for INTRADAY, CNC, MTF, or MARGIN (required for Limit and Stoplimit orders).
`stopPrice`*	float	Default => 0 Provide valid price for INTRADAY, CNC, MTF, or MARGIN (required for Stop and Stoplimit orders).
`disclosedQty`*	int	Default => 0 Allowed only for Equity
`validity`*	string	IOC => Immediate or Cancel DAY => Valid till the end of the day
`offlineOrder`*	boolean	False => When market is open True => When placing AMO order
`stopLoss`	float	Default => 0 Provide valid price for INTRADAY, CNC, MTF, or MARGIN.
`takeProfit`	float	Default => 0 Provide valid price for INTRADAY, CNC, MTF, or MARGIN.

Response Attributes

Attribute	Data Type	Description
`s`	string	Overall status of the batch request: `ok` or `error`.
`code`	int	Overall response code for the batch request, e.g. `200`.
`message`	string	Overall message for the batch request (empty string on success).
`data`	array	Array of per-order results, one entry for each order submitted in the request array, in the same order.
`data[].statusCode`	int	HTTP-style status code for this individual order within the batch, e.g. `200` on success or `400` on failure.
`data[].statusDescription`	string	HTTP status description for this individual order, e.g. `HTTP OK` or `400 Bad Request`.
`data[].body`	object	Result for this order. It has the same fields as the Single Order response.
`data[].body.s`	string	ok / error
`data[].body.code`	int	This is the code to identify specific responses If 201 comes in code it implies that order request has been made but no acknowledgement has been received in this case check orderbook before placing order
`data[].body.message`	string	Message to clarify the request status. Eg: Order submitted successfully. Your Order Ref. No.119062829763
`data[].body.id`	string	The order number of the placed order. Eg: 119031547242

Request

from fyers_apiv3 import fyersModel

client_id = "XC4XXXXM-100"
access_token = "eyJ0eXXXXXXXX2c5-Y3RgS8wR14g"
# Initialize the FyersModel instance with your client_id, access_token, and enable async mode
fyers = fyersModel.FyersModel(client_id=client_id, token=access_token,is_async=False, log_path="")

data = [{
    "symbol":"NSE:SBIN-EQ",
    "qty":1,
    "type":1,
    "side":1,
    "productType":"INTRADAY",
    "limitPrice":0,
    "stopPrice":0,
    "validity":"DAY",
    "disclosedQty":0,
    "offlineOrder":False,
},
{
    "symbol":"NSE:IDEA-EQ",
    "qty":1,
    "type":1,
    "side":1,
    "productType":"INTRADAY",
    "limitPrice":0,
    "stopPrice":0,
    "validity":"DAY",
    "disclosedQty":0,
    "offlineOrder":False,
},{
    "symbol":"NSE:SBIN-EQ",
    "qty":1,
    "type":1,
    "side":1,
    "productType":"INTRADAY",
    "limitPrice":0,
    "stopPrice":0,
    "validity":"DAY",
    "disclosedQty":0,
    "offlineOrder":False,
},
{
    "symbol":"NSE:IDEA-EQ",
    "qty":1,
    "type":1,
    "side":1,
    "productType":"INTRADAY",
    "limitPrice":0,
    "stopPrice":0,
    "validity":"DAY",
    "disclosedQty":0,
    "offlineOrder":False,
}]

response = fyers.place_basket_orders(data=data)
print(response)

{
        "s":"ok",
        "code":200,
        "message":"",
        "data":[{"statusCode":200,
              "body":{
                        "s":"ok",
                        "code":1101,
                        "message":"Order submitted successfully. Your Order Ref. No.52104097619",
                        "id":"52104097619"
                    },
        "statusDescription":"HTTP OK"
        },
        {
        "statusCode":200,
        "body":{
        "s":"ok",
        "code":1101,
        "message":"Order submitted successfully. Your Order Ref. No.52104097620",
        "id":"52104097620"
        },
          "statusDescription":"HTTP OK"
        },
        {
        "statusCode":200,
        "body":{
        "s":"ok",
        "code":1101,
        "message":"Order submitted successfully. Your Order Ref. No.52104097621",
        "id":"52104097621"
        },
        "statusDescription":"HTTP OK"
        },
        {
        "statusCode":400,
        "body":{
          "s":"error",
          "code":-392,
          "message":"Price should be in multiples of tick size.",
          "id":""
          },
        "statusDescription":"400 Bad Request"
    }]
 }

Multi Order

Request Attributes

Response Attributes

Video learning