Skip to main content

Place Order

This API allows you to place a fresh buy or sell order for any available script . Users can specify the type of order, the quantity, and other parameters to execute their trading orders.

📦Request Body Schema

FieldTypesRequiredDescriptionExample/ENUM
scrip_infoObjectYesProvide either (exchange + token) or detailed scrip fieldsSee below
transaction_typeStringYesBUY or SELLBUY/SELL
product_typeStringYesProduct type based on product strategyINTRADAY , DELIVERY
order_typeStringYesType of Order"RL-MKT, LIMIT,SL-MKT"
quantityintegerYesIndicates the total quantity for which the order should be placed.100
pricenumberConditionalDefault: 0 The price at which the order will be placed, specified in rupees.250.50
trigger_pricenumberConditionalTrigger price for the order, applicable only for Stop Loss Limit (SL) and Stop Loss Market orders (SL-MKT).245.00
disclosed_quantityintegerNoDisclosed quantity refers to the portion of the total order quantity that is visible in the market.20
validitystringNoDefault: "DAY" The Order Validity value will be dependant on exchange segments in which the order is being placed."DAY"
validity_daysintegerConditionalNumber of days for which the GTD order needs to be carried forward.7
is_amobooleanNoDefault: falseIndicates whether the order is an AMO (After Market Order). AMO orders are stored in the system and submitted to the exchange on the next trading day.true or false
order_identifierstringNo<=10 characters An optional field to apply to an order to track it.ORDER123
part_codestringNoParticipant Code of the CustodianPart001
algo_idstringNoAlgo id for strategy generated ordersALGO123
strategy_idstringNoStrategy id for strategy generated ordersSTRAT456
vender_codestringNoVender code for inhouse applicationVEND001

📝Scrip Info Object Fields

FieldTypeDescriptionExample/ENUM
exchangeStringExchange segments to which the order is to be sent"NSE_EQ"
scrip_tokenintegerExchange assigned identification number for the scrip or instrument10243
symbolstringSymbol code as per the exchnage's scrip master fileINFY
seriesstringSeries applicale to equity instrumentsEQ
expiry_datestringExpiry date of the contract in yyy-mm-dd format, applicable for futures and options.2025-10-31
strike_pricenumberStrike price of te contract (usually in paise), applicable for options160000
option_typestringIndicates the option type: CE for Call Option and PE for Put Option"CE", "PE"

🟢Success Response - 200 ok

Content-Type: application/json

FieldTypeDescriptionExample/ENUM
StatusStringStatus of API call"success"
CodeStringResponse code corresponding to the request"s101"
MessageStringDescriptive message for the response"Success Message"

🔴 Error Response - 400 Bad Request

FieldTypeDescriptionExample
statusstringStatus of the API call Default Error"error"
codestringError code indicating the failure"e-101"
messagestringSpecific message explaining the reason for failed request."Error Message"
post/transactional/v1/orders/regular