1. Introduction

The Modify Order API allows you to modify an already placed order’s parameters—such as quantity, price, validity, product type, and more—across supported segments and order types before it is executed or fully filled.

2. API Endpoint

POST <Base URL>/quick/order/vr/modify

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 uses a single field named jData, which is a URL-encoded JSON object.

Example Request

curl -X POST "<baseUrl>/quick/order/vr/modify" \\
  -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": "NRML",
    "pf": "N",
    "pr": "0",
    "pt": "MKT",
    "qt": "1",
    "rt": "DAY",
    "tp": "0",
    "ts": "TATAPOWER-EQ",
    "tt": "B",
    "no": "<orderNo>"
  }'

Example Request Body (jData)

{
  "tk": "*****",
  "mp": "0",
  "pc": "NRML",
  "dd": "NA",
  "dq": "0",
  "vd": "DAY",
  "ts": "******-**",
  "tt": "B",
  "pr": "3001",
  "tp": "0",
  "qt": "10",
  "no": "***************",
  "es": "nse_cm",
  "pt": "L"
}

Request Body Fields

Name Type Description Allowed / Example Values
tk string Token (Instrument token from scrip master, as pSymbol column) "11536", or as from the scrip master pSymbol column
fq string Filled Quantity (optional) "10", "0"
mp string Market protection value "0"
pc string Product code "NRML", "CNC", "MIS", "CO", "BO"
dd string Date/Days (trailing validity, if applicable) "NA" or as required
dq string Disclosed quantity "0" or a partial quantity
vd string Validity (order duration) "DAY", "IOC"
ts string Trading Symbol (from scrip master) "TCS-EQ", etc.
tt string Transaction type "B" (Buy), "S" (Sell)
pr string Price e.g., "3001"
tp string Trigger price (for SL, SL-M) "0" or actual trigger price
qt string Quantity e.g., "10"
no string Nest Order Number (system order id for the original order) e.g., "220106000000185"
es string Exchange Segment "nse_cm", "bse_cm", "nse_fo", "bse_fo", "cde_fo"
pt string Order Type "L" (Limit), "MKT" (Market), "SL" (Stoploss), "SL-M" (SL-Market)

5. Response

Example Success Response

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

200 Response Fields

Name Type Description
nOrdNo string New Order Number created or modified
stat string "Ok" if modification successful
stCode int HTTP status code, 200 for success