This document outlines the appropriate format that the traders must follow while writing the webhook payload for setting up the following types of Shares orders to be executed into Oanda.
Let’s get started 🚀
The traders can write the webhook payload for setting up market orders using these three payload fields:
- Symbol
- Action
- Quantity
Symbol
The ticker symbol of the asset. Oanda expresses this asset class as single ticker symbol of share. For example, NFLX, AAPL and AMZN.
Action
The signal action indicates the type of trade to be executed. It can be one of the following:
- Buy: Triggers an action to buy the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Example
I. Buy
{
"symbol": "AAPL",
"action": "buy",
"quantity": 123
}
I. Sell
{
"symbol": "AAPL",
"action": "sell",
"quantity": 123
}
The traders can write the webhook payload for setting up Limit orders using these three payload fields:
- Symbol
- Action
- Quantity
- Limit_price
Symbol
The ticker symbol of the asset. Oanda expresses this asset class by a single ticker symbol of share. For example, NFLX, AAPL and AMZN.
Action
The signal action indicates the type of trade to be executed. It can be one of the following:
- Buy: Triggers an action to buy the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Limit_price
An optional field specifying the execution price for a "BUY" or "SELL" trade. If specified, the trade will be executed at the specified limit price. If not, the trade will be executed at the current market price.
EXAMPLE
I. Buy
{
"symbol": "AAPL",
"action": "buy",
"quantity": 123,
"limit_price": 123.98
}
I. Sell
{
"symbol": "AAPL",
"action": "sell",
"quantity": 123,
"limit_price": 123.98
}
The traders can write the webhook payload for setting up Stop orders using these three payload fields:
- Symbol
- Action
- Quantity
- Stop_price
Symbol
The ticker symbol of the asset. Oanda expresses this asset class by a single ticker symbol of share. For example, NFLX, AAPL and AMZN.
Action
The signal action indicates the type of trade to be executed. It can be one of the following:
- Buy: Triggers an action to buy the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Stop_price
An optional field specifying the price level at which a stop-loss or stop-limit order should be triggered. It helps limit potential losses by automatically closing the position when the specified price is reached.
EXAMPLE
I. Buy
{
"symbol": "AAPL",
"action": "buy",
"quantity": 123,
"Stop_price": 123.98
}
I. Sell
{
"symbol": "AAPL",
"action": "sell",
"quantity": 123,
"Stop_price": 123.98
}
The traders can write the webhook payload for setting up Stop-Limit orders using these tfive payload fields:
- Symbol
- Action
- Quantity
- Limit_price
- Stop_price
Symbol
The ticker symbol of the asset. Oanda expresses this asset class as single ticker symbol of share. For example, NFLX, AAPL and AMZN.
Action
The signal action indicates the type of trade to be executed. It can be one of the following:
- Buy: Triggers an action to buy the asset.
- Sell: Triggers an action to sell the asset.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Limit_price
An optional field specifying the execution price for a "BUY" or "SELL" trade. If specified, the trade will be executed at the specified limit price. If not, the trade will be executed at the current market price.
Stop_price
An optional field specifying the price level at which a stop-loss or stop-limit order should be triggered. It helps limit potential losses by automatically closing the position when the specified price is reached.
EXAMPLE
I. Buy
{
"symbol": "AAPL",
"action": "buy",
"quantity": 123,
"limit_price": 123.98,
"Stop_price": 123.98
}
I. Sell
{
"symbol": "AAPL",
"action": "sell",
"quantity": 123,
"limit_price": 123.98,
"Stop_price": 123.98
}