Skip to main content

Order Book

This call displays all the orders placed by the User in a single window.

🔍Query Parameters

FieldsTypeRequiredDescriptionExample/Enum
offsetintegernoSpecifies the page number of the collection to be displayedoffset=1
limitintegernoLimits the number of items on the pagelimit=20
orderstatusstringnoFilters Order by Status: 1=pending , 2 = completed, -1 = All ordersorder status = 1

🔑Header Parameters

FieldsTypeRequiredDescriptionExample/Enum
AuthorizationstringyesBearer token for authenticationaccess_token
Content_typestringyesMIME Typeapplication/JSON
x-api-keystringnoAPI key provided by bearerx-api-key

🟢Success Response - 200K

FieldsTypeDescriptionExample/Enum
statusstringRequest statusSucess
codestringResponse codes-101
messagestringMessage correspondingOrder fetched successfully
dataarrayList of orders with detailed infoSee below table
metadataobjectMetadata regarding total/completed/open ordersSee below table

📑Order object fields (Each item in data)

FieldsTypeDescriptionExample/Enum
order_idstringSystem-generated unique order numberORD123456789
exchangestringExchange segmentsBSE
scrip_tokenintegerToken number of the scrip/instrument101234
exchange_order_nostringExchange order numberEXORD123456789
statusstringStatus of the orderCompleted
error_reasonstringError message if order is cancelle/ rejeted/not modifiedInsufficient funds
transaction_typestringOrder type: Buy or SellBUY
product_typestringProduct typeDELIVERY
order_typestringOrder TypesLIMIT
total_quantityintegerOriginal quantity of the order100
pending_quantityintegerQuantity still pending0
traded_quantityintegerTraded quantity100
disclosed_quantityintegerDisplay quantity in the market0
order_pricenumberPrice at which order was placed105.50
trigger_pricenumberTrigger price104.00
validitystringOrder ValidityDAY
validity_dayintegerValidity in days (for GTD orders)5
symbolstringSymbol code from exchangeRELIANCE
seriesstringSeries of the instrumentEQ
instrumentsnumberInstrument identifier123456
expiry_datestringExpiry date or contracts2025-06-02
strike pricestringStrike price in paise15000
option_typestringCE (call) or PE(put)CE
market_lotintegerLot size of the scrip1
order_timestampstringTime when OMS registered the order2025-06-01T10:20
exchange_timestampstringTime when exchange resgistered the order2025-06-01T10:20
inititated_bystringApplication ID that placed the orderAPP123
modified_bystringApplication ID that modified the orderAPP456
is_amo_orderstringWhether it is AMO (After Market Order)false
gateway_order_idstringInternal gateway orderIDGW123456
order_identifierstringOptional field for trackin the orderuser001
bracket_detailsobjectsPresent if order is BOSee below table

📑Bracket details object fields

FieldsTypeDescriptionExample/Enum
parent_order_IDstringOrder ID of main legORD123
leg_indicatorstringIdentifies leg type (main, stoploss, profit)MAIN
stoploss_pricenumberStoploss price95.00
stoploss_trigger_pricenumberstoploss trigger price94.00
profit_pricenumberTarget profit price110.00
stoploss_jump_pricenumberStoploss trail jump price0.50
ltp_jump_pricenumberLTP trail jump price0.25
bo_order_idstringBracket order IDBO12345
bo_order_statusstringStatus of Bracket OrderEXECUTED
bo_modify_flagnumberLegs allowed to be modified (0-7)0- Modification is not allowed 1- Main leg 2- Stop loss leg 4- Profit leg 6- Both stop loss & profit leg 7- All legs6

📑Metadata Fields

FieldsTypeDescriptionExample/Enum
total_recordsnumberTotal order count55
all_recordsnumberAll order count55
completed_recordsnumberTotal completed orders26
open_recordsnumberTotal open/pending orders10
get/transactional/v1/orders