Order

Place multi order

This API allows you to place multiple orders to the exchange via Upstox.

post/v2/order/multi/place

Request

  • Base URL: https://api-v2.upstox.com
  • URL: https://api-v2.upstox.com/v2/order/multi/place
  • Auth: OAuth 2 (authorization code, authorization URL https://api-v2.upstox.com/v2/login/authorization/dialog, token URL https://api-v2.upstox.com/v2/login/authorization/token)

Headers

Originstring

Request body

quantityinteger required

Quantity with which the order is to be placed

product'I' | 'D' required

Signifies if the order was either Intraday, Delivery, CO or OCO

validity'DAY' | 'IOC' required

It can be one of the following - DAY(default), IOC

pricenumber float required

Price at which the order will be placed

tagstring
sliceboolean required

To divide the order line based on predefined exchange definitions

instrument_tokenstring required

Key of the instrument

order_type'MARKET' | 'LIMIT' | 'SL' | 'SL-M' required

Type of order. It can be one of the following MARKET refers to market order LIMIT refers to Limit Order SL refers to Stop Loss Limit SL-M refers to Stop Loss Market

transaction_type'BUY' | 'SELL' required

Indicates whether its a buy or sell order

disclosed_quantityinteger required

The quantity that should be disclosed in the market depth

trigger_pricenumber float required

If the order is a stop loss order then the trigger price to be set is mentioned here

is_amoboolean required

Signifies if the order is an After Market Order

correlation_idstring required

A unique identifier for tracking individual orders within the batch

market_protectionnumber float

Optional parameter defining the market protection percentage for the multi order

Example request

[
  {
    "quantity": 1,
    "product": "D",
    "validity": "DAY",
    "instrument_token": "NSE_EQ|INE848E01016",
    "order_type": "MARKET",
    "transaction_type": "BUY",
    "market_protection": 3
  }
]

Response

Successful

status'success' | 'error' | 'partial_success'

Example response

{
  "data": [
    {
      "correlation_id": "213fsf2324"
    }
  ],
  "errors": [
    {
      "correlation_id": "213fsf2324"
    }
  ],
  "summary": {
    "total": 3,
    "success": 2,
    "error": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.