Place Multi Order¶

Use this page to submit multiple independent Trading API V3 single-instrument orders in one REST request.

Each object inside orders[] is a full single-order payload. Multi-order create uses the same endpoint as single-order create; the difference is only that the orders array contains more than one independent item.

This page is the REST V3 equivalent of placing several single-order payloads together. It is not the strategy-order flow. If one order object needs legs, use Place Strategy Order instead.

Scope

Use this page for several independent order items.

Every item:

has its own refId
has its own qty
has its own side
keeps isMultiLeg: false
does not send legs

Do not use this page for one strategy made from FNO legs. For one leg-based strategy order, use Place Strategy Order.

Endpoint¶

Method: POST
Endpoint: sentinel/orders/create

Basic Usage¶

{
  "orders": [
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 127000,
      "stratTags": ["rest-api-v3", "multi-order-buy"]
    },
    {
      "refId": 72329,
      "qty": 1,
      "side": "SELL",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 140000,
      "stratTags": ["rest-api-v3", "multi-order-sell"]
    }
  ]
}

Example Order Patterns¶

use one payload per order inside the list
mix any supported single-place-order case inside the same multi-order request
keep the order-specific fields inside each item
set isMultiLeg: false and the correct executionMode inside each item
add entryConfig or exitConfig only for the orders that require it
keep each item aligned to the same single-order field rules documented on Place Single Order

Limit + MarketTwo Limit OrdersLimit + StoplossGTE + Limit

{
  "orders": [
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 127000
    },
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "MARKET",
      "validityType": "IOC",
      "isMultiLeg": false,
      "executionMode": "ENTRY"
    }
  ]
}

{
  "orders": [
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 127000
    },
    {
      "refId": 72329,
      "qty": 1,
      "side": "SELL",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 140000
    }
  ]
}

{
  "orders": [
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 127000
    },
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY_AND_EXIT",
      "entryPrice": 127000,
      "exitConfig": {
        "stoplossParams": {
          "stoplossTriggerPrice": { "value": 126500 },
          "stoplossLimitPrice": { "value": 126400 }
        }
      }
    }
  ]
}

{
  "orders": [
    {
      "refId": 72329,
      "qty": 1,
      "side": "BUY",
      "deliveryType": "CNC",
      "priceType": "LIMIT",
      "validityType": "GTE",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "goodTillDate": "2026-10-31T15:10:00Z",
      "entryPrice": 127000
    },
    {
      "refId": 72329,
      "qty": 1,
      "side": "SELL",
      "deliveryType": "IDAY",
      "priceType": "LIMIT",
      "validityType": "DAY",
      "isMultiLeg": false,
      "executionMode": "ENTRY",
      "entryPrice": 140000
    }
  ]
}

Execution Modes¶

Value	Use
`ENTRY`	Standard entry-only order item
`ENTRY_AND_EXIT`	Order item that also carries exit controls such as stop-loss, target, or timed exit
`EXIT`	Exit-only order-management workflow when the item is intended only to manage the exit side

List Item Fields¶

Field	Type	Required	Description
`orders[].refId`	int	Yes	Instrument reference id for the item
`orders[].qty`	int	Yes	Quantity for the item
`orders[].side`	enum	Yes	`BUY` or `SELL`
`orders[].deliveryType`	enum	Yes	`IDAY` or `CNC`
`orders[].priceType`	enum	Yes	`LIMIT` or `MARKET`
`orders[].validityType`	enum	Yes	`DAY`, `IOC`, or `GTE`
`orders[].isMultiLeg`	boolean	Yes	Must remain `false` for independent items
`orders[].executionMode`	enum	Yes	`ENTRY`, `ENTRY_AND_EXIT`, or `EXIT` depending on the item
`orders[].entryPrice`	int	Conditional	Required for limit-based items
`orders[].entryConfig`	object	Conditional	Entry trigger or timed-entry controls for that item
`orders[].exitConfig`	object	Conditional	Stop-loss, target, trailing, or timed-exit controls for that item

Nested Condition Fields¶

Field	Type	Description
`entryConfig.triggers.ltp.atOrAbove.value`	int	Entry trigger above a price
`entryConfig.triggers.ltp.atOrBelow.value`	int	Entry trigger below a price
`entryConfig.entryTime`	string	Timed entry in ISO format
`exitConfig.exitTime`	string	Timed exit in ISO format
`exitConfig.stoplossParams.*`	object	Stop-loss configuration
`exitConfig.targetParams.*`	object	Target configuration

Response Fields¶

Field	Meaning
`orders[].intentOrderId`	Unique Trading API V3 order id for the item
`orders[].status`	Current state of the item
`orders[].orderQty`	Final accepted quantity for the item
`orders[].orderPrice`	Final normalized price for the item
`orders[].intentOrderType`	Normalized item family such as `REGULAR`, `TRIGGER`, or `FLEXI`

Response Shape¶

{
  "message": "order creation request pushed successfully",
  "orders": [
    {
      "intentOrderId": 9957,
      "status": "OPEN",
      "isMulti": false,
      "refId": 72329,
      "orderQty": 1,
      "orderPrice": 127000,
      "side": "BUY"
    },
    {
      "intentOrderId": 9958,
      "status": "OPEN",
      "isMulti": false,
      "refId": 72329,
      "orderQty": 1,
      "orderPrice": 140000,
      "side": "SELL"
    }
  ]
}

Important Rules¶

Multi-order and single-order create share the same REST route.
A multi-order request is only a batch of independent orders.
Keep all order-specific fields inside the relevant item instead of at the top level.
Keep isMultiLeg: false on every item in this page.
For one strategy order with multiple legs, use Place Strategy Order.