---
title: "place super order"
method: POST
path: "/super/orders"
tags: ["Super Order"]
---

# place super order

`POST /super/orders`

The order API allows you to place a new order.

## Headers

- `access-token` string, required

## Request body

- SuperOrderRequest
  - `dhanClientId` string — User specific identification generated by Dhan
  - `correlationId` string — 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 — | **Enums** | **Exchange** | **Segment** | |--------------|--------------|-------------------| | NSE_EQ | NSE | Equity Cash | | NSE_FNO | NSE | Futures & Options | | NSE_COMM | NSE | Commodity | | BSE_EQ | BSE | Equity Cash | | BSE_FNO | BSE | Futures & Options | | MCX_COMM | MCX | Commodity |
  - `productType` 'CNC' | 'INTRADAY' | 'MARGIN' | 'MTF' — | **Enum Values** | **Description** | |-----------------|------------------------------------------------| | CNC | Cash & Carry for equity deliveries | | INTRADAY | Intraday for Equity, Futures & Options | | MARGIN | Carry Forward in Futures & Options | | MTF | Margin Traded Fund |
  - `orderType` 'LIMIT' | 'MARKET' — | **Enum Values** | **Description** | |------------------|-----------------------------| | LIMIT | For Limit Order types | | MARKET | For market Order types |
  - `securityId` string — Exchange standard identification for each scrip
  - `quantity` integer — Number of shares for the order
  - `price` number, float — Price at which order is placed
  - `targetPrice` number, float — Target price for the Super Order
  - `stopLossPrice` number, float — Stop Loss Price for the Super Order
  - `trailingJump` number, float — Price Jump by which Stop Loss should be trailed

## Response `200`

Successful Operation

- OrderStatusResponse
  - `orderId` string — Order specific identification generated by Dhan
  - `orderStatus` 'TRANSIT' | 'PENDING' | 'REJECTED' | 'CANCELLED' | 'PART_TRADED' | 'TRADED' | 'EXPIRED' | 'MODIFIED' | 'TRIGGERED' | 'INACTIVE' — | **Enum Values** | **Description** | |-----------------|---------------------------------------------| | TRANSIT | Did not reach the exchange server | | PENDING | Reached at exchange end, awaiting execution | | REJECTED | Rejected at exchange/broker’s end | | CANCELLED | Cancelled by user | | PART_TRADED | Partially Executed | | TRADED | Executed | | EXPIRED | Validity of order is expired |

---

[API](https://skmtc.dev/dhan/apis/dhanhq-api.md) · [All operations](https://skmtc.dev/dhan/apis/dhanhq-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dhan/dhanhq-api/revisions/2d368b9ed32d/schema)