DHdhan
Forever Order

place forever order

Changed on

The order request api allows you place a new forever order.

post/forever/orders

Request

  • Base URL
    https://api.dhan.co/v2
  • URL
    https://api.dhan.co/v2/forever/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

orderFlag'SINGLE' | 'OCO'
Enum ValuesDescription
SINGLEFor GTT Order types
OCOFor OCO Order types
transactionType'BUY' | 'SELL' required

Signifies the type of transaction whether it's BUY or SELL

exchangeSegment'NSE_EQ' | 'NSE_FNO' | 'BSE_EQ' | 'BSE_FNO'
EnumsExchangeSegment
NSE_EQNSEEquity Cash
NSE_FNONSEFutures & Options
BSE_EQBSEEquity Cash
BSE_FNOBSEFutures & Options
productType'CNC' | 'MTF' | 'MARGIN'
Enum ValuesDescription
CNCCash & Carry for equity deliveries
MTFMargin Traded Fund
MARGINCarry Forward in Futures & Options
orderType'LIMIT' | 'MARKET'
Enum ValuesDescription
LIMITFor Limit Order types
MARKETFor market Order types
validitystring

Valid for 1Year/Expiry

securityIdstring

Exchange standard identification for each scrip

quantityinteger

Number of shares for the order

disclosedQuantityinteger

Number of shares visible (Keep more than 30% of quantity)

pricenumber float

Price at which order is placed

triggerPricenumber float

Price at which the order is triggered

price1number float

Target price for OCO order

triggerPrice1number float

Target trigger price For OCO order

quantity1integer

Target Quantity for OCO order

Response

Successful operation

orderIdstring

Order specific identification generated by Dhan

orderStatus'PENDING' | 'REJECTED' | 'CANCELLED' | 'EXPIRED'
Enum ValuesDescription
PENDINGReached at exchange end, awaiting execution
REJECTEDRejected at exchange/broker’s end
CANCELLEDCancelled by user
EXPIREDValidity of order is expired

Changes