GTT Order¶

Type	APIs	Details
POST	{{BASE_URL}}open-api/od/v1/orders/gtt/execute	Initiates a new GTT order with the defined trigger conditions and target price levels.
GET	{{BASE_URL}}/open-api/od/v1/orders/gtt/orderbook	Fetches the list of all active, triggered, and cancelled GTT (Good Till Triggered) orders placed by the user, including their current status and details.
POST	{{BASE_URL}}open-api/od/v1/orders/gtt/modify	Allows updates to an existing GTT order’s parameters like trigger price, quantity before it is triggered.
POST	{{BASE_URL}}open-api/od/v1/orders/gtt/cancel	Removes a previously placed GTT order that has not yet been triggered or executed.

Place GTT Order¶

Request Structure

{
 "tradingSymbol": "SILVER25SEP25C100000",
 "exchange": "MCX",
 "transactionType": "SELL",
 "orderType": "LIMIT",
 "product": "INTRADAY",
 "validity": "DAY",
 "quantity": 3,
 "price": 100,
 "orderComplexity": "REGULAR",
 "instrumentId": "460125",
 "gttType": "LTP_A_O",
 "gttValue": "12" 
}

Input parameters

Field	Type	Description
tradingSymbol	String	The symbol representing the trading instrument (e.g., SILVER25SEP25C100000).
exchange	String	Code representing the exchange where the trade is executed.
transactionType	String	Type of transaction, indicating whether the trade is a "BUY" or "SELL".
orderType	String	Order type: Limit, Market, SL, SLM.
product	String	Product category of the trade (e.g., INTRADAY, LONGTERM, MTF).
validity	String	Validity period of the order (e.g., DAY, IOC).
quantity	Integer	Quantity of the instrument to trade.
price	Float	Price at which the order should be placed (used for LIMIT orders).
orderComplexity	String	Complexity level of the order (e.g., REGULAR, AMO).
instrumentId	String	Unique ID of the instrument to trade.
gttType	String	GTT (Good Till Triggered) type – e.g., LTP_A_O.
gttValue	Float	Trigger price value for GTT orders.

Response Structure

{
"status": "Ok",
"message": "Success",
"result": [
            {
                "requestTime": "09:57:23 09-07-2025",
                "orderNo": "25070900000061",
                "status": null,
                "message": null
            }
        ]
}

Response Parameters

Field	Type	Description
requestTime	String	Timestamp when the request was received (Format: HHss DD-MM-YYYY).
orderNo	String	Unique order number generated by the system.
status	String	Current status of the order, if available.
message	String	Additional information or error message, if any.

GTT Order Book¶

Response Structure

{
"status": "Ok",
"message": "Success",
"result": [
            {
            "gttType": "LTP_A_O",
            "orderNo": "25062500000298",
            "tradingSymbol": "GOLDENTOBC-BZ",
            "exchange": "NSE",
            "token": "11619",
            "remarks": "",
            "validity": "GTT",
            "orderTime": "16:37:17 25-06-2025",
            "priceprecision": "2",
            "lotSize": "1",
            "tickSize": "0.01",
            "transType": "BUY",
            "priceType": "LIMIT",
            "qty": "100",
            "price": "37.00",
            "product": "LONGTERM",
            "gttValue": "37.00",
            "orderType": "REGULAR",
            "disclosedQty": null,
            "formattedInsName": "GOLDENTOBC-BZ"
          }
     ]
}

Response Parameters

Field	Type	Description
gttType	String	Type of GTT order (e.g., LTP_A_O).
orderNo	String	Unique order number assigned.
tradingSymbol	String	Trading instrument symbol.
exchange	String	Code representing the exchange where the trade is executed.
token	String	Instrument token.
remarks	String	Additional notes or remarks (can be blank).
validity	String	Validity period of the order (e.g., DAY, IOC).
orderTime	String	Timestamp of order (format: HHss DD-MM-YYYY).
priceprecision	String	Decimal precision allowed for price.
lotSize	String	Lot size for the instrument.
tickSize	String	Minimum price movement.
transType	String	Transaction type (BUY or SELL).
priceType	String	Price entry type (e.g., LIMIT, MARKET).
qty	String	Quantity ordered.
price	String	Order price.
product	String	Product category of the trade (e.g., INTRADAY, LONGTERM, MTF).
gttValue	String	Trigger price for GTT.
orderType	String	Order type: Limit, Market, SL, SLM.
disclosedQty	String	Disclosed quantity (if any).
formattedInsName	String	User-friendly instrument name.

Modify GTT Order¶

Request Structure

{
    "tradingSymbol": "SILVER25SEP25C100000",
    "exchange": "MCX",
    "orderType": "LIMIT",
    "product": "LONGTERM",
    "validity": "DAY",
    "quantity": 3,
    "price": "3590.00",
    "orderComplexity": "REGULAR",
    "instrumentId": "460125",
    "gttType": "LTP_A_O",
    "gttValue": "3598",
    "brokerOrderId": "25070700000196"
}

Input parameters

Field	Type	Description
tradingSymbol	String	Symbol for the trading instrument (e.g., SILVER25SEP25C100000).
exchange	String	Code representing the exchange where the trade is executed.
orderType	String	Order type: Limit, Market, SL, SLM.
product	String	Product category of the trade (e.g., INTRADAY, LONGTERM, MTF).
validity	String	Validity period of the order (e.g., DAY, IOC).
quantity	Integer	Quantity to trade (e.g., 3).
price	String	Price at which the order is to be placed.
orderComplexity	String	Complexity level of the order (e.g., REGULAR, AMO).
instrumentId	String	Unique instrument ID.
gttType	String	Type of GTT trigger (e.g., LTP_A_O).
gttValue	String	Trigger price value for the GTT order.
brokerOrderId	String	Unique identifier from the broker for this order.

Response Structure

{
"status": "Ok",
"message": "Success",
"result": [
            {
            "requestTime": "10:05:25 09-07-2025",
            "orderNo": "25070900000067",
            "status": null,
            "message": null
            }
        ]
}

Response Parameters

Field	Type	Description
requestTime	String	Timestamp when the request was received (Format: HHss DD-MM-YYYY).
orderNo	String	Unique order number generated by the system.
status	String	Current status of the order, if available.
message	String	Additional information or error message, if any.

Cancel Order¶

Request Structure

{
    "brokerOrderId":"250526000002881"
}

Input Parameters

Field	Type	Description
brokerOrderId	String	Unique ID assigned to the order by the broker.

Response Structure

{
"status": "Ok",
"message": "Success",
"result": [
            {
            "requestTime": "10:06:54 09-07-2025",
            "orderNo": "25070900000067",
            "status": null,
            "message": null
            }
          ]
}

Response Parameters

Field	Type	Description
requestTime	String	Timestamp when the request was received (Format: HHss DD-MM-YYYY).
orderNo	String	Unique order number generated by the system.
status	String	Current status of the order, if available.
message	String	Additional information or error message, if any.