DHdhan
Super Order

place super order

Changed on

The order API allows you to place a new order.

post/super/orders

Request

  • Base URL
    https://api.dhan.co/v2
  • URL
    https://api.dhan.co/v2/super/orders
  • Auth
    none declared. Required headers: access-token

Headers

access-tokenstring required

Request body

dhanClientIdstring

User specific identification generated by Dhan

correlationIdstring

The user/partner generated id for tracking back

transactionType'BUY' | 'SELL' required

The trading side of transaction

exchangeSegment'NSE_EQ' | 'NSE_FNO' | 'NSE_COMM' | 'BSE_EQ' | 'BSE_FNO' | 'MCX_COMM' required
EnumsExchangeSegment
NSE_EQNSEEquity Cash
NSE_FNONSEFutures & Options
NSE_COMMNSECommodity
BSE_EQBSEEquity Cash
BSE_FNOBSEFutures & Options
MCX_COMMMCXCommodity
productType'CNC' | 'INTRADAY' | 'MARGIN' | 'MTF'
Enum ValuesDescription
CNCCash & Carry for equity deliveries
INTRADAYIntraday for Equity, Futures & Options
MARGINCarry Forward in Futures & Options
MTFMargin Traded Fund
orderType'LIMIT' | 'MARKET'
Enum ValuesDescription
LIMITFor Limit Order types
MARKETFor market Order types
securityIdstring

Exchange standard identification for each scrip

quantityinteger

Number of shares for the order

pricenumber float

Price at which order is placed

targetPricenumber float

Target price for the Super Order

stopLossPricenumber float

Stop Loss Price for the Super Order

trailingJumpnumber float

Price Jump by which Stop Loss should be trailed

Response

Successful Operation

orderIdstring

Order specific identification generated by Dhan

orderStatus'TRANSIT' | 'PENDING' | 'REJECTED' | 'CANCELLED' | 'PART_TRADED' | 'TRADED' | 'EXPIRED' | 'MODIFIED' | 'TRIGGERED' | 'INACTIVE'
Enum ValuesDescription
TRANSITDid not reach the exchange server
PENDINGReached at exchange end, awaiting execution
REJECTEDRejected at exchange/broker’s end
CANCELLEDCancelled by user
PART_TRADEDPartially Executed
TRADEDExecuted
EXPIREDValidity of order is expired

Changes

  • 2d368b9ed32dRevision changes
    • info

      added the new NSE_COMM enum value to the request property

    • info

      the request property's maxLength was increased from 25 to 30