Place Order API

1. Introduction

The Place Order API allows you to place buy or sell orders across all supported exchange segments and order types. It supports product types like NRML, CNC, MIS, CO, and BO, and includes specialized fields for Bracket Orders (BO) and Cover Orders (CO).

2. API Endpoint

POST <Base URL>/quick/order/rule/ms/place

Replace <Base URL> with the relevant Kotak environment base URL provided in response from /tradeApiValidate api.

3. Headers

Name	Type	Description
accept	string	Should always be `application/json`
Sid	string	session sid generated on login
Auth	string	session token generated on login
neo-fin-key	string	static value: neotradeapi
Content-Type	string	Always `application/x-www-form-urlencoded`

4. Request Body

The request body is sent as a single field named jData, which is a stringified JSON object and must be URL-encoded.

Example Request

curl -X POST "<baseUrl>/quick/order/rule/ms/place" \
  -H "Auth: <session_token>" \
  -H "Sid: <session_sid>" \
  -H "neo-fin-key: neotradeapi" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode 'jData={
    "am": "NO",
    "dq": "0",
    "es": "nse_cm",
    "mp": "0",
    "pc": "CNC",
    "pf": "N",
    "pr": "0",
    "pt": "MKT",
    "qt": "1",
    "rt": "DAY",
    "tp": "0",
    "ts": "ITBEES-EQ",
    "tt": "B"
  }'

Example Request Body (`jData`)

{
  "am": "NO",
  "dq": "0",
  "es": "nse_cm",
  "mp": "0",
  "pc": "MIS",
  "pf": "N",
  "pr": "0",
  "pt": "L",
  "qt": "1",
  "rt": "DAY",
  "tp": "0",
  "ts": "******-**",
  "tt": "B",
 
}

<aside> 💡

Note on bracket orders and cover orders:

Bracket order and cover orders have been discontinued on Trade APIs since Apr 1, 2026.

</aside>

Request Body Fields

Name	Type	Description	Allowed / Example Values
am	string	After Market Order flag.	"NO" (normal), "YES" (AMO)
dq	string	Disclosed quantity.	"0" or a partial quantity
es	string	Exchange segment code.	"nse_cm", "bse_cm", "nse_fo", "bse_fo", "cde_fo", “mcx_fo”
mp	string	Market protection value (used in some market orders).	"0" or numerical value
pc	string	Product code.	"NRML", "CNC", "MIS", "CO", "BO", “MTF”
pf	string	Portfolio flag.	"N"
pr	string	Price for limit order, "0" for market order.	e.g. "0", "450.5"
pt	string	Order type.	"L" (Limit), "MKT" (Market), "SL" (Stoploss), "SL-M" (SL-Market)
qt	string	Order quantity.	e.g. "1", "100", etc.
rt	string	Validity or order duration.	"DAY", "IOC"
tp	string	Trigger price (used for SL/SL-M/CO).	"0" or actual trigger price.
ts	string	Trading symbol (from scrip master file).	e.g., "ITBEES-EQ"
tt	string	Transaction type.	"B" (Buy), "S" (Sell)

5. Response

Example Success Response

{
  "nOrdNo": "250720000007242",
  "stat": "Ok",
  "stCode": 200
}