Skip to content

Get Orders

Use this page to fetch grouped Trading API V3 order snapshots through the REST API.

This is the main REST V3 retrieval page for single orders, multi-order items, and strategy orders. Use it to review grouped order state after create, modify, or cancel requests.

Use the same retrieval endpoint for:

  • single orders
  • independent multi-order items
  • strategy orders

For strategy orders created with isMultiLeg: true, Trading API V3 returns one strategy-level order with isMulti: true and a non-empty legs list.

Endpoint

Method: GET
Endpoint: sentinel/orders

Base URLs

Environment Base URL
PROD https://api.nubra.io
UAT https://uatapi.nubra.io

Headers

Authorization: Bearer <session_token>
x-device-id: <device_id>

Basic Usage

curl --location 'https://api.nubra.io/sentinel/orders' \
--header 'Authorization: Bearer <session_token>' \
--header 'x-device-id: <device_id>'

Filter By intentOrderId

Use intentOrderId when you want to retrieve one or more specific Trading API V3 orders directly.

curl --location 'https://api.nubra.io/sentinel/orders?intentOrderId=11303' \
--header 'Authorization: Bearer <session_token>' \
--header 'x-device-id: <device_id>'

You can also pass several ids as a comma-separated list:

GET sentinel/orders?intentOrderId=12345,67890,11111

The response keeps the same bucketed structure. Matching orders appear inside the bucket that matches their current lifecycle state, such as open, cancelled, executed, expired, rejected, or gtt.

Filter By stratTags

Use stratTags when you want to retrieve orders associated with one or more existing strategy labels. Each tag value must use hyphen-separated text only.

curl --location 'https://api.nubra.io/sentinel/orders?stratTags=momentum-breakout,weekly-hedge' \
--header 'Authorization: Bearer <session_token>' \
--header 'x-device-id: <device_id>'

For filtering, pass one or more existing hyphenated tags as a comma-separated list. This is useful when orders need to be reviewed, reconciled, or tracked together.

Response Shape

{
  "orders": {
    "cancelled": [
    ],
    "executed": [
      {
        "intentOrderId": 11344,
        "exchange": "NSE",
        "status": "EXECUTED",
        "isMulti": true,
        "legs": [
          {
            "refId": 1504439,
            "refData": {
              "displayName": "NIFTY 23 JUN 26 24050 CE",
              "asset": "NIFTY",
              "exchange": "NSE",
              "derivativeType": "OPT",
              "optionType": "CE",
              "lotSize": 65,
              "tickSize": 5
            },
            "unitQty": 1,
            "orderQty": 65,
            "filledQty": 65,
            "filledPrice": 11895
          }
        ],
        "filledQty": 65,
        "orderQty": 65,
        "deliveryType": "IDAY",
        "priceType": "MARKET",
        "validityType": "IOC",
        "executionMode": "ENTRY",
        "entryConfig": {},
        "echoFields": "{\"omsType\":\"SINGLE\",\"orderType\":\"REGULAR\",\"displayName\":\"Custom Basket\"}",
        "ltp": 11780,
        "filledPrice": 11895,
        "positionId": "1504439_IDAY",
        "timestamps": {
          "intentCreatedAt": "2026-06-22T08:30:29.26418393Z",
          "sentToColoAt": "2026-06-22T08:30:29.267589752Z",
          "filledAt": "2026-06-22T08:30:30.189632177Z",
          "lastUpdatedAt": "2026-06-22T08:30:30.189632177Z"
        },
        "intentOrderType": "REGULAR",
        "side": "BUY",
        "exchangeOrderIds": {
          "1504439": [20]
        }
      }
    ],
    "expired": [],
    "gtt": [],
    "open": [
      {
        "intentOrderId": 11304,
        "exchange": "NSE",
        "status": "OPEN",
        "isMulti": false,
        "legs": null,
        "refId": 72329,
        "refData": {
          "displayName": "ICICIBANK",
          "asset": "ICICIBANK",
          "exchange": "NSE",
          "derivativeType": "STOCK",
          "optionType": "N/A",
          "lotSize": 1,
          "tickSize": 10
        },
        "filledQty": 0,
        "orderQty": 1,
        "deliveryType": "IDAY",
        "priceType": "LIMIT",
        "validityType": "DAY",
        "executionMode": "ENTRY",
        "stratTags": ["momentum-breakout"],
        "ltp": 136010,
        "orderPrice": 120000,
        "timestamps": {
          "intentCreatedAt": "2026-06-22T05:00:45.054721358Z",
          "sentToColoAt": "2026-06-22T05:00:45.060222428Z"
        },
        "intentOrderType": "REGULAR",
        "side": "BUY"
      }
    ],
    "rejected": []
  }
}

Response Notes

  • orders are grouped by status bucket instead of being returned as one flat list
  • common buckets include open, cancelled, executed, expired, rejected, and gtt
  • each order object contains the normalized V3 order model for its current lifecycle state
  • executed orders may additionally include fields such as filledPrice, positionId, and exchangeOrderIds
  • multi-leg and strategy-style responses may appear with isMulti: true and a populated legs list
  • single-order responses typically appear with isMulti: false, a top-level refId, and legs: null
  • strategy orders still appear as one grouped strategy-level order row; inspect isMulti, legs, orderQty, and intentOrderType inside that grouped response
  • use the gtt bucket when validating good-till orders returned by the API
  • query filters such as intentOrderId and stratTags narrow the result set, but the bucketed response contract remains unchanged

Use GET sentinel/orders for:

  • checking whether create requests were accepted
  • verifying whether modify requests actually changed orderPrice
  • inspecting lastModifiedAt, cancelledAt, and lastUpdatedAt
  • locating one or more specific orders through the intentOrderId query filter
  • retrieving related orders together through shared stratTags
  • checking whether a strategy order is still open as one grouped order or has progressed to later lifecycle states
NEO Assistant