{ "$schema": "http://json-schema.org/draft-07/schema#", "title": "StopLossOrder", "description": "A StopLossOrder is an order that is linked to an open Trade and created with a price threshold. The Order will be filled (closing the Trade) by the first price that is equal to or worse than the threshold. A StopLossOrder cannot be used to open a new Position.", "type": "object", "properties": { "id": { "type": "string", "description": "The Order's identifier, unique within the Order's Account.", "format": "The string representation of the OANDA-assigned OrderID. OANDA-assigned OrderIDs are positive integers, and are derived from the TransactionID of the Transaction that created the Order." }, "createTime": { "type": "string", "description": "The time when the Order was created.", "format": "The RFC 3339 representation is a string conforming to https://tools.ietf.org/rfc/rfc3339.txt. The Unix representation is a string representing the number of seconds since the Unix Epoch (January 1st, 1970 at UTC). The value is a fractional number, where the fractional part represents a fraction of a second (up to nine decimal places)." }, "state": { "type": "string", "description": "The current state of the Order.", "enum": [ "PENDING", "FILLED", "TRIGGERED", "CANCELLED" ] }, "clientExtensions": { "$ref": "#/definitions/ClientExtensions" }, "type": { "type": "string", "description": "The type of the Order. Always set to \"STOP_LOSS\" for Stop Loss Orders.", "enum": [ "MARKET", "LIMIT", "STOP", "MARKET_IF_TOUCHED", "TAKE_PROFIT", "STOP_LOSS", "TRAILING_STOP_LOSS", "FIXED_PRICE" ] }, "guaranteedExecutionPremium": { "type": "string", "description": "The premium that will be charged if the Stop Loss Order is guaranteed and the Order is filled at the guaranteed price. It is in price units and is charged for each unit of the Trade.", "format": "A decimal number encoded as a string. The amount of precision provided depends on what the number represents." }, "tradeID": { "type": "string", "description": "The ID of the Trade to close when the price threshold is breached.", "format": "The string representation of the OANDA-assigned TradeID. OANDA-assigned TradeIDs are positive integers, and are derived from the TransactionID of the Transaction that opened the Trade." }, "clientTradeID": { "type": "string", "description": "The client ID of the Trade to be closed when the price threshold is breached." }, "price": { "type": "string", "description": "The price threshold specified for the Stop Loss Order. If the guaranteed flag is false, the associated Trade will be closed by a market price that is equal to or worse than this threshold. If the flag is true the associated Trade will be closed at this price.", "format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument." }, "distance": { "type": "string", "description": "Specifies the distance (in price units) from the Account's current price to use as the Stop Loss Order price. If the Trade is short the Instrument's bid price is used, and for long Trades the ask is used.", "format": "A decimal number encoded as a string. The amount of precision provided depends on what the number represents." }, "timeInForce": { "type": "string", "description": "The time-in-force requested for the StopLoss Order. Restricted to \"GTC\", \"GFD\" and \"GTD\" for StopLoss Orders.", "enum": [ "GTC", "GTD", "GFD", "FOK", "IOC" ] }, "gtdTime": { "type": "string", "description": "The date/time when the StopLoss Order will be cancelled if its timeInForce is \"GTD\".", "format": "The RFC 3339 representation is a string conforming to https://tools.ietf.org/rfc/rfc3339.txt. The Unix representation is a string representing the number of seconds since the Unix Epoch (January 1st, 1970 at UTC). The value is a fractional number, where the fractional part represents a fraction of a second (up to nine decimal places)." }, "triggerCondition": { "type": "string", "description": "Specification of which price component should be used when determining if an Order should be triggered and filled. This allows Orders to be triggered based on the bid, ask, mid, default (ask for buy, bid for sell) or inverse (ask for sell, bid for buy) price depending on the desired behaviour. Orders are always filled using their default price component.\nThis feature is only provided through the REST API. Clients who choose to specify a non-default trigger condition will not see it reflected in any of OANDA's proprietary or partner trading platforms, their transaction history or their account statements. OANDA platforms always assume that an Order's trigger condition is set to the default value when indicating the distance from an Order's trigger price, and will always provide the default trigger condition when creating or modifying an Order.\nA special restriction applies when creating a guaranteed Stop Loss Order. In this case the TriggerCondition value must either be \"DEFAULT\", or the \"natural\" trigger side \"DEFAULT\" results in. So for a Stop Loss Order for a long trade valid values are \"DEFAULT\" and \"BID\", and for short trades \"DEFAULT\" and \"ASK\" are valid.", "enum": [ "DEFAULT", "INVERSE", "BID", "ASK", "MID" ] }, "guaranteed": { "type": "boolean", "description": "Flag indicating that the Stop Loss Order is guaranteed. The default value depends on the GuaranteedStopLossOrderMode of the account, if it is REQUIRED, the default will be true, for DISABLED or ENABLED the default is false." }, "fillingTransactionID": { "type": "string", "description": "ID of the Transaction that filled this Order (only provided when the Order's state is FILLED)", "format": "String representation of the numerical OANDA-assigned TransactionID" }, "filledTime": { "type": "string", "description": "Date/time when the Order was filled (only provided when the Order's state is FILLED)", "format": "The RFC 3339 representation is a string conforming to https://tools.ietf.org/rfc/rfc3339.txt. The Unix representation is a string representing the number of seconds since the Unix Epoch (January 1st, 1970 at UTC). The value is a fractional number, where the fractional part represents a fraction of a second (up to nine decimal places)." }, "tradeOpenedID": { "type": "string", "description": "Trade ID of Trade opened when the Order was filled (only provided when the Order's state is FILLED and a Trade was opened as a result of the fill)", "format": "The string representation of the OANDA-assigned TradeID. OANDA-assigned TradeIDs are positive integers, and are derived from the TransactionID of the Transaction that opened the Trade." }, "tradeReducedID": { "type": "string", "description": "Trade ID of Trade reduced when the Order was filled (only provided when the Order's state is FILLED and a Trade was reduced as a result of the fill)", "format": "The string representation of the OANDA-assigned TradeID. OANDA-assigned TradeIDs are positive integers, and are derived from the TransactionID of the Transaction that opened the Trade." }, "tradeClosedIDs": { "type": "array", "description": "Trade IDs of Trades closed when the Order was filled (only provided when the Order's state is FILLED and one or more Trades were closed as a result of the fill)", "items": { "type": "string", "description": "The Trade's identifier, unique within the Trade's Account.", "format": "The string representation of the OANDA-assigned TradeID. OANDA-assigned TradeIDs are positive integers, and are derived from the TransactionID of the Transaction that opened the Trade." } }, "cancellingTransactionID": { "type": "string", "description": "ID of the Transaction that cancelled the Order (only provided when the Order's state is CANCELLED)", "format": "String representation of the numerical OANDA-assigned TransactionID" }, "cancelledTime": { "type": "string", "description": "Date/time when the Order was cancelled (only provided when the state of the Order is CANCELLED)", "format": "The RFC 3339 representation is a string conforming to https://tools.ietf.org/rfc/rfc3339.txt. The Unix representation is a string representing the number of seconds since the Unix Epoch (January 1st, 1970 at UTC). The value is a fractional number, where the fractional part represents a fraction of a second (up to nine decimal places)." }, "replacesOrderID": { "type": "string", "description": "The ID of the Order that was replaced by this Order (only provided if this Order was created as part of a cancel/replace).", "format": "The string representation of the OANDA-assigned OrderID. OANDA-assigned OrderIDs are positive integers, and are derived from the TransactionID of the Transaction that created the Order." }, "replacedByOrderID": { "type": "string", "description": "The ID of the Order that replaced this Order (only provided if this Order was cancelled as part of a cancel/replace).", "format": "The string representation of the OANDA-assigned OrderID. OANDA-assigned OrderIDs are positive integers, and are derived from the TransactionID of the Transaction that created the Order." } } }