PLACE CART ORDERS API

This API places all the orders contained within a given order cart in a single call.

Endpoint: POST /transactional/v1/ordercart/placecartorders

🔑 Header Parameters

Header	Type	Description	Example
Content-Type	string	Specifies the media type of the request	application/json
Authorization	string	Bearer token for authenticated requests	{{access_token}}

📑 Request Body Parameters

Field	Type	Required	Description	Example
ordercartId	string	Yes	ID of the order cart to be executed	"2662 1D"
ordercartName	string	Yes	Name of the order cart	"CART01"
orders	array	Yes	Array of individual order objects to be placed	Refer below

📘 Orders Array — Order Object Fields

Field	Type	Required	Description	Example / Enum
scrip_info	object	Yes	Instrument details	Refer below
transaction_type	string	Yes	Order side	"BUY", "SELL"
product_type	string	Yes	Product type of the order	"DELIVERY"
order_type	string	Yes	Order type	"RL-MKT"
quantity	integer	Yes	Number of units to transact	2
price	string	Yes	Price per unit	"0.00"
trigger_price	string	No	Trigger price for SL orders	"0.00"
disclosed_quantity	integer	No	Quantity disclosed to the market	0
validity	string	No	Order validity	"DAY", "EOSESS"
is_amo	boolean	No	AMO (After Market Order) flag	false
order_identifier	string	No	Custom identifier, typically the cart ID	"2662 1D"

📘 scrip_info Object Fields

Field	Type	Required	Description	Example
exchange	string	Yes	Exchange segment	"NSE_EQ", "BSE_EQ"
scrip_token	integer	Yes	Exchange token of the instrument	22
symbol	string	Yes	Instrument trading symbol	"ACC"
series	string	Yes	Series of the instrument	"EQ", "A"
expiry_date	string	No	Expiry date for F&O instruments	""
strike_price	string	No	Strike price for options	"NaN"
option_type	string	No	Option type for derivatives	""

🟢 Success Response - 200 OK

Content-Type: application/json

Field	Type	Description	Example
status	string	Status of API call	"success"
code	string	Response code to user request	"s-101"
message	string	Success message	"Cart orders placed successfully"
data	array	Array of individual order results	Refer to Data Object Fields

📦 Data Object Fields

Each element in data corresponds to one order placed from the cart.

Field	Type	Description	Example
status	string	Status of the individual order	"success"
code	string	Response code for this order	"s-101"
message	string	Order submission message	"Order Entry Sent to OMS"
data	object	Order response containing the order ID	Refer below

📘 Nested data Object

Field	Type	Description	Example
orderId	string	System-generated order identifier	"OBAPJ00005F5"