Skip to main content

Place Multileg/Spread Order

This API allows you to place multileg (spread) orders- such as 2-leg or 3-leg strategy orders.

🔑Header Parameters

FieldsTypeRequiredDescriptionExample/Enum
AuthorizationstringyesBearer token for authenticationaccess_token
Content_typestringyesType of content being sentapplication/json
x-api-keystringyesAPI key provided by bearerx-api-key

📦Request Body Schema

FieldsTypeRequiredDescriptionExample/ENUM
TypestringYesType of multileg order"2L" "3L"
order typestringYesOrder type. Only RL or RL-MKT supported"RL"
order_identifierstringNoOptional Identifier for users own tracking (max 10 Chars)"Myorder1"
vailditystringYesOrder Validity . Default is "IOC""IOC"
algo_idstringNoAlgo ID for automated strategies"A001"
leg_detailsarray of objectYesArray of order legs ( 1 or more)See below table

📋Leg details object fields

FieldsTypeRequiredDescriptionExample/ENUM
leg_nointegerYesUnique identifier of the leg (eg, 1, 2, 3)1
scrip_infoobjectyesInstrument detailsSee below table
transactional_typestringyesBuy or sell"BUY"
quantitynumberyesQuantity of the contracts75
pricestringyesPrice for the leg150.25
othersobjectyesMeta data like lot size, tick sizeSee below table

📋Scrip_info object fields

FieldsTypeRequiredDescriptionExample/Enum
exchangestringyesExchange segments"NSE_FO"
scrip_tokenintegerOptionalUnique token ID of the instrument10125
symbolstringOptionalSymbol from the exchange master file"NIFTY"
seriesstringOptionalSeries code (for equitites)"EQ"
expiry_datestringOptionalExpiry date (yyyy-mm-dd)"2025-06-08"
strike_pricenumberOptionastrike price (in paise) for options"175000"
option_typestringOptional"CE" for call , "PE", for Put"CE"

📋Others object (Instrumental Meta Info)

FieldsTypeRequiredDescriptionExample/Enum
market_lotintegerYesLot size of the instrument75
price_ticknumberYesMinimum price movement0.05
decimal_locnumberYesDecimal locator for the price2

🟢Success Response - 200 K

FieldsTypeDescriptionExample/Enum
StatusstringStatus of API Call"success"
CodestringResponse code"s-101"
messagestringOrder placement Message"Order entry sent to OMS"
dataobjectContains additional details detailsSee below table

📘Data Object Info Field

FieldTypeDescriptionExample/Enum
order idstringInternal order ID assigned by system"SPRD12345"
gateway_order_nostringGateway order reference number"03280004"
post/transactional/v1/orders/multileg