GTT Single Order

This API allows you to place a single GTT (Good Till Trigger) order that stays active until its trigger price is hit or you cancel it.

USE CASE

Set a target or stop-loss on a holding or position, or queue a new order that is sent only when your trigger price is reached.

Details

This type is used to create a single GTT order.
It supports placing orders for CNC, Margin, and MTF.
It can be applied either as a Target or Stop Loss for your existing holdings/positions.
Alternatively, it can be used to create a GTT order for a new position/holding.
A GTT order stays active for up to one year, until its trigger is hit or you cancel it.
A single GTT uses leg1 only. leg2 is used only for OCO orders, which have their own GTT OCO Order page.
Response code 1101 means the order was placed. Code 201 means it is in transit, so confirm it in the GTT Order Book.
Keep the returned id. You need it to modify or cancel the order while it is still pending.
orderTag is optional. FYERS adds 1:GTT at the start of your tag. Without a tag the order gets 2:GTTUntagged.
Rate limits differ between the Standard and Prime plans. See Plans & rate limits.

Request Attributes

Attribute	Data Type	Description
`Side`	int	Indicates the side of the order: `1` for buy, `-1` for sell.
`symbol`*	string	The instrument's unique identifier, e.g., "NSE:CHOLAFIN-EQ"
`productType`*	string	The product type for the order. Valid values: "CNC", "MARGIN", "MTF".
`orderInfo`*	object	Contains information about the GTT/OCO order legs.
`orderInfo.leg1`*	object	Details for GTT order leg. Mandatory for all orders.
`orderInfo.leg1.price`*	float	Price at which the order
`orderInfo.leg1.triggerPrice`	float	Trigger price for the GTT order. NOTE: for OCO order this leg trigger price should be always above LTP
`orderInfo.leg1.qty`*	int	Quantity for the GTT order leg.
`orderInfo.leg2`*	object	Details for OCO order leg. Optional and included only for OCO orders.
`orderInfo.leg2.price`*	float	Price at which the second leg of the OCO order should be placed.
`orderInfo.leg2.triggerPrice`*	float	Trigger price for the second leg of the OCO order. NOTE: for OCO order this leg trigger price should be always below LTP
`orderInfo.leg2.qty`*	int	Quantity for the second leg of the OCO order..
`orderTag`	string	ordertag provided when placing the order Note: `1:GTT` will be concatenated at the start of tag provided by user. Default value if tag not provided when order is placed is `2:GTTUntagged`

Response Attributes

Attribute	Data Type	Description
`code`	int	Status code indicating the outcome of the request: `1101`: Order placed successfully. `201`: Order is in transit. Confirm details using the Orderbook API. Other codes represent specific error conditions.
`message`*	string	Descriptive message about the request status, e.g., "Successfully placed order".
`s`*	string	Request status indicator: "ok" for success, "error" for failure.
`id`*	string	Unique identifier for the placed order, returned when the order is successfully processed.

Request

from fyers_apiv3 import fyersModel

client_id = "XC4XXXXM-100"
access_token = "eyJ0eXXXXXXXX2c5-Y3RgS8wR14g"
# Initialize the FyersModel instance with your client_id, access_token, and enable async mode
fyers = fyersModel.FyersModel(client_id=client_id, token=access_token,is_async=False, log_path="")

data = {
      "side": 1,
      "symbol": "NSE:SBIN-EQ",
      "productType":"CNC",
      "orderInfo": {
          "leg1": {
              "price": 1000,
              "triggerPrice": 1000,
              "qty": 3
          }
      }
  }
response = fyers.place_gtt_order(data=data)
print(response)

{
    "code": 1101,
    "message": "Successfully placed order",
    "s": "ok",
    "id":"25012400002099"
  }