Skip to Content
API ReferenceTradingOrder PlacementAsyncMulti Order
Open in GPTGPTOpen in ClaudeClaude

Multi Order

This API allows you to place multiple orders in a single request without waiting for the exchange response.

USE CASE

Open several positions together in one request and follow each order on the General WebSocket or order book.

Note

Each order in the array is queued and processed respecting 10 orders per second. The HTTP response returns id_fyers. Exchange id and terminal status come from the General WebSocket and Order Book.

stopLoss and takeProfit are not supported with async order placement.

Details

  • Body is an array of order objects (same fields as sync multi-order). POST to /api/v3/multi-order/async.
  • For /sync vs /async behavior, queuing, 10 OPS, id_fyers and hosts, see the Order Placement Guide.
  • Placing orders needs an app with the Order Placement permission.
  • Send an array of order objects with the same fields as the sync Multi Order API.
  • An HTTP 200 response only means the orders were queued. It does not mean they were placed or accepted by the exchange.
  • Price inputs must be multiples of the symbol tick size, and quantity must follow the lot-size rules, for every order.
  • To change or cancel these orders, use Modify Multi Order or Cancel Multi Order.
  • Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes

AttributeData TypeDescription
symbol*stringEg: NSE:SBIN-EQ
qty*intThe 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
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
stopLossfloat
  • Default => 0
  • Provide valid price for INTRADAY, CNC, MTF, or MARGIN.
takeProfitfloat
  • Default => 0
  • Provide valid price for INTRADAY, CNC, MTF, or MARGIN.
Last updated on
Single OrderGTT Orders