Skip to main content

Place Order - Any Scrip

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.

🔑Header Parameters

HeaderTypeRequiredDescriptionExample
content_typeStringYesMIME type of the requestapplication/json
authorizationStringYesBearer token for user authenticationBearer {access_token}
x-api-keyStringYesAPI Key provided{x-api-key}

📦Request Body Schema

FieldTypesRequiredDescriptionExample/ENUM
scrip_infoObjectYesProvide either (exchange + token) or detailed scrip fields{exchange: NSE, token: 12345}
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
StatusStringIndicates the result of API Call"sucess"
CodeStringResponse code corresponding to the request"s101"
MessageStringDescriptive message for the response"order entry sent to OMS"
DataObjectContains the order informationSee below

📘Data Object Info field

FieldsTypeDescriptionExample/ENUM
orderIdstringSystem generated order ID"NWSYF00005>3"
post/transactional/v1/orders/regular