Skip to main content

MULTILEG ORDER BOOK

This API returns the multileg / spread order book records, including all legs and associated execution details.

🔍 Query Parameters

ParameterTypeRequiredDescriptionExample / Enum
offsetintegerNoPage number for pagination1
limitintegerNoNumber of records per page20
orderStatusnumberNoOrder filter1 = Pending, 2 = Completed, -1 = All
orderTypestringNoType of multileg orders"multileg", "spread"

🔑 Header Parameters

HeaderTypeDescriptionExample
Content-TypestringRequest payload formatapplication/json
AuthorizationstringAccess token{{access_token}}
x-api-keystringAPI key{{x-api-key}}

🟢 Success Response - 200 OK

Content-Type: application/json

FieldTypeDescriptionExample
statusstringStatus of API call"success"
codestringResponse code"200"
messagestringSuccess message"Multileg order book fetched successfully"
dataarrayList of multileg ordersRefer Data Object Fields
metadataobjectSummary informationRefer Metadata Fields

📦 Data Object Fields

FieldTypeDescriptionExample / Enum
order_idstringUnique order ID"ORD12345"
client_order_nostringClient order number"CLORD001"
gateway_order_nostringGateway order number"GW000123"
segment_idintegerExchange segment ID1
exchangestringExchange segment"NSE_FO"
book_typeintegerBook type1
leg_indicatorstringMultileg type"SPREAD", "2L", "3L"
statusstringOrder status"OPEN", "COMPLETE", "CANCELLED"
order_timestampstringOrder placed time"2026-05-27 10:00:00"
order_modified_timestampstringLast modified time"2026-05-27 10:05:00"
settlement_daysintegerSettlement days2
spread_symbolstringSpread symbol"NIFTY-SPREAD"
error_reasonstringError message"Rejected due to margin"
validitystringOrder validity"IOC", "DAY"
spread_tokenintegerSpread token56789
ordertimeintegerOrder time1716796800
order_identifierstringCustom identifier"ML123"

📘 Leg 1 Object Fields

FieldTypeDescriptionExample / Enum
transaction_typestringBUY or SELL"BUY"
instrumentnumberInstrument type1
symbolstringSymbol"NIFTY"
expiry_datestringExpiry date"2026-06-25"
strike_pricestringStrike price"18000"
option_typestringOption type"CE", "PE"
total_quantityintegerTotal quantity50
traded_quantityintegerExecuted quantity25
pending_quantityintegerPending quantity25
order_pricenumberOrder price100.5
scrip_tokenintegerToken12345
exchange_order_nostringExchange order ID"EX12345"
product_typestringProduct type"MIS", "NRML"
price_tickintegerTick size5
decimal_locnumberDecimal precision2
market_lotintegerLot size50

📘 Leg 2 Object Fields

(Same structure as Leg 1)

📘 Leg 3 Object Fields

(Same structure as Leg 1)

📊 Metadata Fields

FieldTypeDescriptionExample
total_recordsnumberTotal orders count100
all_recordsnumberAll orders count100
completed_recordsnumberCompleted orders count60
open_recordsnumberOpen orders count40