This document outlines the appropriate format that the traders must follow while writing the webhook payload for setting up the following types of Options orders to be executed into E-trade.
Let’s get started 🚀
Market Order
The traders can write the webhook payload for setting up market orders using these four payload fields:
- Symbol
- Action
- Quantity
- Class
Symbol
The ticker symbol of the asset. E-Trade uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Strike price, and Option type.
The format is as follows:
[Stock Ticker Symbol] [Expiration Date] [Strike Price] [Option Type]
For example
AAPL 221121C00145000
AMZN 230915P00056000
META 230825P00150000
- "AAPL", "AMZN", and "META" are the stock ticker symbols for Apple Inc., Amazon.com Inc., and Meta Platforms Inc., respectively.
- "221121" represents the expiration date of the options contract in the format of YYMMDD (2022, Nov,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145", "560", and "150" are the respective strike prices of the call or put options.
Action
The signal action indicates the type of trade to be executed. It can be one of the following.
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
- Buy to Cover: Triggers an action to buy back and close a previously sold asset (ending a short trade).
- Sell Short: Triggers an action to sell borrowed assets with the expectation of buying them back at a lower price.
- Buy to Open: Triggers an action to initiate a new position by buying assets.
- Buy to Close: Triggers an action to exit and close an existing position.
- Sell to Open: Triggers an action to initiate a new position by selling assets.
- Sell to Close: Triggers an action to exit and close an existing short position.
- Close: Triggers an action to close an existing open position and exit the trade.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Note: You can also use the JSON field- quantity_type.
This is an optional field indicating the type of quantity being specified. We have three options - fixed, cash, and percent_of_equity.
Fixed (Default): The trade quantity will be set as a fixed quantity, such as “100” shares or “10” shares.
{
"quantity": 100,
"quantity_type": "fixed"
}
Cash: The trade quantity is represented by the available cash amount. For instance, if the quantity_type is set to "cash", and the trader specifies a value of 100, it means they are trading 100 units of the currency value, such as 100 USD or 100 GBP, depending on the currency locale of the trader.
{
"quantity": 100,
"quantity_type": "cash"
}
Percent_of_equity: The quantity is calculated as a percentage of the total equity (account balance, not including unrealized p/l). For instance, if the total equity is $50,000 and the quantity_type is set to “percent_of_equity” with the value of “2” then the trade quantity would be $50,000*0.02 = $1000.
{
"quantity": 2,
"quantity_type": "percent_of_equity"
}
Class
The Class is a field or property that identifies and categorizes financial instruments such as futures, options, warrants, bonds, CFDs, crypto, forex, stocks, and funds. Required to be specified for assets with time-limited contracts like Options.
EXAMPLE
I. Buy
{
"symbol": "AAPL 221121C00145000",
"action": "buy",
"quantity": 123,
"class": "option"
}
II. Sell
{
"symbol": "AAPL 221121C00145000",
"action": "sell",
"quantity": 123,
"class": "option"
}
III. Buy-To-Cover
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_cover",
"quantity": 123,
"class": "option"
}
IV. Sell-Short
{
"symbol": "AAPL 221121C00145000",
"action": "sell_short",
"quantity": 123,
"class": "option"
}
V. Buy-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_openl",
"quantity": 123,
"class": "option"
}
VI. Buy-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_closel",
"quantity": 123,
"class": "option"
}
VII. Sell-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_open",
"quantity": 123,
"class": "option"
}
VIII. Sell-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_close",
"quantity": 123,
"class": "option"
}
IX. Close
{
"symbol": "AAPL 221121C00145000",
"action": "close",
"class": "option"
}
Limit Order
The traders can write the webhook payload for setting up Limit orders using these five payload fields:
- Symbol
- Action
- Quantity
- Limit_price
- Class
Symbol
The ticker symbol of the asset. E-Trade uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Strike price, and Option type.
The format is as follows:
[Stock Ticker Symbol] [Expiration Date] [Strike Price] [Option Type]
For example
AAPL 221121C00145000
AMZN 230915P00056000
META 230825P00150000
- "AAPL", "AMZN", and "META" are the stock ticker symbols for Apple Inc., Amazon.com Inc., and Meta Platforms Inc., respectively.
- "221121" represents the expiration date of the options contract in the format of YYMMDD (2022, Nov,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145", "560", and "150" are the respective strike prices of the call or put options.
Action
The signal action indicates the type of trade to be executed. It can be one of the following.
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
- Buy to Cover: Triggers an action to buy back and close a previously sold asset (ending a short trade).
- Sell Short: Triggers an action to sell borrowed assets with the expectation of buying them back at a lower price.
- Buy to Open: Triggers an action to initiate a new position by buying assets.
- Buy to Close: Triggers an action to exit and close an existing position.
- Sell to Open: Triggers an action to initiate a new position by selling assets.
- Sell to Close: Triggers an action to exit and close an existing short position.
- Close: Triggers an action to close an existing open position and exit the trade.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Note: You can also use the JSON field- quantity_type.
This is an optional field indicating the type of quantity being specified. We have three options - fixed, cash, and percent_of_equity.
Fixed (Default): The trade quantity will be set as a fixed quantity, such as “100” shares or “10” shares.
{
"quantity": 100,
"quantity_type": "fixed"
}
Cash: The trade quantity is represented by the available cash amount. For instance, if the quantity_type is set to "cash", and the trader specifies a value of 100, it means they are trading 100 units of the currency value, such as 100 USD or 100 GBP, depending on the currency locale of the trader.
{
"quantity": 100,
"quantity_type": "cash"
}
Percent_of_equity: The quantity is calculated as a percentage of the total equity (account balance, not including unrealized p/l). For instance, if the total equity is $50,000 and the quantity_type is set to “percent_of_equity” with the value of “2” then the trade quantity would be $50,000*0.02 = $1000.
{
"quantity": 2,
"quantity_type": "percent_of_equity"
}
Limit_price
An optional field specifying the execution price for a “buy” or “sell” trade. If you specify the limit price the trade will be executed at the specified limit price. Or If you choose not to specify a limit price, the trade will be executed at the current market price.
Class
The Class is a field or property that identifies and categorizes financial instruments such as futures, options, warrants, bonds, CFDs, crypto, forex, stocks, and funds. Required to be specified for assets with time-limited contracts like Options.
EXAMPLE
I. Buy
{
"symbol": "AAPL 221121C00145000",
"action": "buy",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
II. Sell
{
"symbol": "AAPL 221121C00145000",
"action": "sell",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
III. Buy-To-Cover
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_cover",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
IV. Sell-Short
{
"symbol": "AAPL 221121C00145000",
"action": "sell_short",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
V. Buy-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_open",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
VI. Buy-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_close",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
VII. Sell-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_open",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
VIII. Sell-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_close",
"quantity": 123,
"limit_price": 123.98,
"class": "option"
}
IX. Close
{
"symbol": "AAPL 221121C00145000",
"action": "close",
"limit_price": 123.98,
"class": "option"
}
Stop Order
The traders can write the webhook payload for setting up Stop orders using these five payload fields:
- Symbol
- Action
- Quantity
- Stop_price
- Class
Symbol
The ticker symbol of the asset. E-Trade uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Strike price, and Option type.
The format is as follows:
[Stock Ticker Symbol] [Expiration Date] [Strike Price] [Option Type]
For example
AAPL 221121C00145000
AMZN 230915P00056000
META 230825P00150000
- "AAPL", "AMZN", and "META" are the stock ticker symbols for Apple Inc., Amazon.com Inc., and Meta Platforms Inc., respectively.
- "221121" represents the expiration date of the options contract in the format of YYMMDD (2022, Nov,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145", "560", and "150" are the respective strike prices of the call or put options.
Action
The signal action, indicates the type of trade to be executed. It can be one of the following.
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
- Buy to Cover: Triggers an action to buy back and close a previously sold asset (ending a short trade).
- Sell Short: Triggers an action to sell borrowed assets with the expectation of buying them back at a lower price.
- Buy to Open: Triggers an action to initiate a new position by buying assets.
- Buy to Close: Triggers an action to exit and close an existing position.
- Sell to Open: Triggers an action to initiate a new position by selling assets.
- Sell to Close: Triggers an action to exit and close an existing short position.
- Close: Triggers an action to close an existing open position and exit the trade.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Note: You can also use the JSON field- quantity_type.
This is an optional field indicating the type of quantity being specified. We have three options - fixed, cash, and percent_of_equity.
Fixed (Default): The trade quantity will be set as a fixed quantity, such as “100” shares or “10” shares.
{
"quantity": 100,
"quantity_type": "fixed"
}
Cash: The trade quantity is represented by the available cash amount. For instance, if the quantity_type is set to "cash", and the trader specifies a value of 100, it means they are trading 100 units of the currency value, such as 100 USD or 100 GBP, depending on the currency locale of the trader.
{
"quantity": 100,
"quantity_type": "cash"
}
Percent_of_equity: The quantity is calculated as a percentage of the total equity (account balance, not including unrealized p/l). For instance, if the total equity is $50,000 and the quantity_type is set to “percent_of_equity” with the value of “2” then the trade quantity would be $50,000*0.02 = $1000.
{
"quantity": 2,
"quantity_type": "percent_of_equity"
}
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.
Class
The Class is a field or property that identifies and categorizes financial instruments such as futures, options, warrants, bonds, CFDs, crypto, forex, stocks, and funds. Required to be specified for assets with time-limited contracts like Options.
EXAMPLE
I. Buy
{
"symbol": "AAPL 221121C00145000",
"action": "buy",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
II. Sell
{
"symbol": "AAPL 221121C00145000",
"action": "sell",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
III. Buy-To-Cover
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_cover",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
IV. Sell-Short
{
"symbol": "AAPL 221121C00145000",
"action": "sell_short",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
V. Buy-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_open",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
VI. Buy-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_close",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
VII. Sell-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_open",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
VIII. Sell-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_close",
"quantity": 123,
"stop_price": 123.98,
"class": "option"
}
IX. Close
{
"symbol": "AAPL 221121C00145000",
"action": "close",
"stop_price": 123.98,
"class": "option"
}
Stop-Limit Order
The traders can write the webhook payload for setting up Stop-Limit orders using these six payload fields:
- Symbol
- Action
- Quantity
- Limit_price
- Stop_price
- Class
Symbol
The ticker symbol of the asset. E-Trade uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Strike price, and Option type.
The format is as follows:
[Stock Ticker Symbol] [Expiration Date] [Strike Price] [Option Type]
For example
AAPL 221121C00145000
AMZN 230915P00056000
META 230825P00150000
- "AAPL", "AMZN", and "META" are the stock ticker symbols for Apple Inc., Amazon.com Inc., and Meta Platforms Inc., respectively.
- "221121" represents the expiration date of the options contract in the format of YYMMDD (2022, Nov,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145", "560", and "150" are the respective strike prices of the call or put options.
Action
The signal action indicates the type of trade to be executed. It can be one of the following.
- Buy: Triggers an action to purchase the asset.
- Sell: Triggers an action to sell the asset.
- Buy to Cover: Triggers an action to buy back and close a previously sold asset (ending a short trade).
- Sell Short: Triggers an action to sell borrowed assets with the expectation of buying them back at a lower price.
- Buy to Open: Triggers an action to initiate a new position by buying assets.
- Buy to Close: Triggers an action to exit and close an existing position.
- Sell to Open: Triggers an action to initiate a new position by selling assets.
- Sell to Close: Triggers an action to exit and close an existing short position.
- Close: Triggers an action to close an existing open position and exit the trade.
Quantity
The number of assets to be traded. If omitted, the quantity will be dynamically calculated or defaulted to 1.
Note: You can also use the JSON field- quantity_type.
This is an optional field indicating the type of quantity being specified. We have three options - fixed, cash, and percent_of_equity.
Fixed (Default): The trade quantity will be set as a fixed quantity, such as “100” shares or “10” shares.
{
"quantity": 100,
"quantity_type": "fixed"
}
Cash: The trade quantity is represented by the available cash amount. For instance, if the quantity_type is set to "cash", and the trader specifies a value of 100, it means they are trading 100 units of the currency value, such as 100 USD or 100 GBP, depending on the currency locale of the trader.
{
"quantity": 100,
"quantity_type": "cash"
}
Percent_of_equity: The quantity is calculated as a percentage of the total equity (account balance, not including unrealized p/l). For instance, if the total equity is $50,000 and the quantity_type is set to “percent_of_equity” with the value of “2” then the trade quantity would be $50,000*0.02 = $1000.
{
"quantity": 2,
"quantity_type": "percent_of_equity"
}
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.
Class
The Class is a field or property that identifies and categorizes financial instruments such as futures, options, warrants, bonds, CFDs, crypto, forex, stocks, and funds. Required to be specified for assets with time-limited contracts like Options.
EXAMPLE
I. Buy
{
"symbol": "AAPL 221121C00145000",
"action": "buy",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
II. Sell
{
"symbol": "AAPL 221121C00145000",
"action": "sell",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
III. Buy-To-Cover
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_cover",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
IV. Sell-Short
{
"symbol": "AAPL 221121C00145000",
"action": "sell_short",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
V. Buy-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_open",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
VI. Buy-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "buy_to_close",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
VII. Sell-To-Open
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_open",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
VIII. Sell-To-Close
{
"symbol": "AAPL 221121C00145000",
"action": "sell_to_close",
"quantity": 123,
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}
IX. Close
{
"symbol": "AAPL_221121C145",
"action": "close",
"limit_price": 123.98,
"stop_price": 123.98,
"class": "option"
}