OANDA · Schema
TakeProfitOrderTransaction
A TakeProfitOrderTransaction represents the creation of a TakeProfit Order in the user's Account.
ForexFX TradingCFD TradingFinancial ServicesTrading APIs
Properties
| Name | Type | Description |
|---|---|---|
| id | string | The Transaction's Identifier. |
| time | string | The date/time when the Transaction was created. |
| userID | integer | The ID of the user that initiated the creation of the Transaction. |
| accountID | string | The ID of the Account the Transaction was created for. |
| batchID | string | The ID of the "batch" that the Transaction belongs to. Transactions in the same batch are applied to the Account simultaneously. |
| requestID | string | The Request ID of the request which generated the transaction. |
| type | string | The Type of the Transaction. Always set to "TAKE_PROFIT_ORDER" in a TakeProfitOrderTransaction. |
| tradeID | string | The ID of the Trade to close when the price threshold is breached. |
| clientTradeID | string | The client ID of the Trade to be closed when the price threshold is breached. |
| price | string | The price threshold specified for the TakeProfit Order. The associated Trade will be closed by a market price that is equal to or better than this threshold. |
| timeInForce | string | The time-in-force requested for the TakeProfit Order. Restricted to "GTC", "GFD" and "GTD" for TakeProfit Orders. |
| gtdTime | string | The date/time when the TakeProfit Order will be cancelled if its timeInForce is "GTD". |
| triggerCondition | string | 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, |
| reason | string | The reason that the Take Profit Order was initiated |
| clientExtensions | object | |
| orderFillTransactionID | string | The ID of the OrderFill Transaction that caused this Order to be created (only provided if this Order was created automatically when another Order was filled). |
| replacesOrderID | string | The ID of the Order that this Order replaces (only provided if this Order replaces an existing Order). |
| cancellingTransactionID | string | The ID of the Transaction that cancels the replaced Order (only provided if this Order replaces an existing Order). |
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "TakeProfitOrderTransaction",
"description": "A TakeProfitOrderTransaction represents the creation of a TakeProfit Order in the user's Account.",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The Transaction's Identifier.",
"format": "String representation of the numerical OANDA-assigned TransactionID"
},
"time": {
"type": "string",
"description": "The date/time when the Transaction 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)."
},
"userID": {
"type": "integer",
"description": "The ID of the user that initiated the creation of the Transaction."
},
"accountID": {
"type": "string",
"description": "The ID of the Account the Transaction was created for.",
"format": "\"-\"-delimited string with format \"{siteID}-{divisionID}-{userID}-{accountNumber}\""
},
"batchID": {
"type": "string",
"description": "The ID of the \"batch\" that the Transaction belongs to. Transactions in the same batch are applied to the Account simultaneously.",
"format": "String representation of the numerical OANDA-assigned TransactionID"
},
"requestID": {
"type": "string",
"description": "The Request ID of the request which generated the transaction."
},
"type": {
"type": "string",
"description": "The Type of the Transaction. Always set to \"TAKE_PROFIT_ORDER\" in a TakeProfitOrderTransaction.",
"enum": [
"CREATE",
"CLOSE",
"REOPEN",
"CLIENT_CONFIGURE",
"CLIENT_CONFIGURE_REJECT",
"TRANSFER_FUNDS",
"TRANSFER_FUNDS_REJECT",
"MARKET_ORDER",
"MARKET_ORDER_REJECT",
"FIXED_PRICE_ORDER",
"LIMIT_ORDER",
"LIMIT_ORDER_REJECT",
"STOP_ORDER",
"STOP_ORDER_REJECT",
"MARKET_IF_TOUCHED_ORDER",
"MARKET_IF_TOUCHED_ORDER_REJECT",
"TAKE_PROFIT_ORDER",
"TAKE_PROFIT_ORDER_REJECT",
"STOP_LOSS_ORDER",
"STOP_LOSS_ORDER_REJECT",
"TRAILING_STOP_LOSS_ORDER",
"TRAILING_STOP_LOSS_ORDER_REJECT",
"ORDER_FILL",
"ORDER_CANCEL",
"ORDER_CANCEL_REJECT",
"ORDER_CLIENT_EXTENSIONS_MODIFY",
"ORDER_CLIENT_EXTENSIONS_MODIFY_REJECT",
"TRADE_CLIENT_EXTENSIONS_MODIFY",
"TRADE_CLIENT_EXTENSIONS_MODIFY_REJECT",
"MARGIN_CALL_ENTER",
"MARGIN_CALL_EXTEND",
"MARGIN_CALL_EXIT",
"DELAYED_TRADE_CLOSURE",
"DAILY_FINANCING",
"RESET_RESETTABLE_PL"
]
},
"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 TakeProfit Order. The associated Trade will be closed by a market price that is equal to or better than this threshold.",
"format": "A decimal number encodes as a string. The amount of precision provided depends on the Instrument."
},
"timeInForce": {
"type": "string",
"description": "The time-in-force requested for the TakeProfit Order. Restricted to \"GTC\", \"GFD\" and \"GTD\" for TakeProfit Orders.",
"enum": [
"GTC",
"GTD",
"GFD",
"FOK",
"IOC"
]
},
"gtdTime": {
"type": "string",
"description": "The date/time when the TakeProfit 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"
]
},
"reason": {
"type": "string",
"description": "The reason that the Take Profit Order was initiated",
"enum": [
"CLIENT_ORDER",
"REPLACEMENT",
"ON_FILL"
]
},
"clientExtensions": {
"$ref": "#/definitions/ClientExtensions"
},
"orderFillTransactionID": {
"type": "string",
"description": "The ID of the OrderFill Transaction that caused this Order to be created (only provided if this Order was created automatically when another Order was filled).",
"format": "String representation of the numerical OANDA-assigned TransactionID"
},
"replacesOrderID": {
"type": "string",
"description": "The ID of the Order that this Order replaces (only provided if this Order replaces an existing Order).",
"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."
},
"cancellingTransactionID": {
"type": "string",
"description": "The ID of the Transaction that cancels the replaced Order (only provided if this Order replaces an existing Order).",
"format": "String representation of the numerical OANDA-assigned TransactionID"
}
}
}