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 Tradovate.
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 options. Tradovate uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Option Type, and Strike price.
The format is as follows:
[Stock Ticker][Expiration Date][Option Type][Strike Price]
For example
AAPL 221121C00145000
AMZN 221121C00250000
MSFT 221231P00220000
- "AAPL" are the stock ticker symbol for Apple IncAmazon.com Inc.
- "221121" represents the expiration date of the options contract in the format of YYMMDD(2022 November,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145",”250”,”220” are the respective strike prices of the call options.
Action
The signal action indicates the type of trade to be triggered. The action can be any 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.
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"
}
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 options. Tradovate uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Option Type, and Strike price.
The format is as follows:
[Stock Ticker][Expiration Date][Option Type][Strike Price]
For example
AAPL 221121C00145000
AMZN 221121C00250000
MSFT 221231P00220000
- "AAPL" are the stock ticker symbol for Apple IncAmazon.com Inc.
- "221121" represents the expiration date of the options contract in the format of YYMMDD(2022 November,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145",”250”,”220” are the respective strike prices of the call options.
Action
The signal action indicates the type of trade to be triggered. The action can be any 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 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"
}
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 options. Tradovate uses a specific format to represent them by the combination of the Stock ticker symbol, Expiration Date, Option Type, and Strike price.
The format is as follows:
[Stock Ticker][Expiration Date][Option Type][Strike Price]
For example
AAPL 221121C00145000
AMZN 221121C00250000
MSFT 221231P00220000
- "AAPL" is the stock ticker symbol for Apple IncAmazon.com Inc.
- "221121" represents the expiration date of the options contract in the format of YYMMDD(2022 November,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145",”250”,”220” are the respective strike prices of the call options.
Action
The signal action indicates the type of trade to be triggered. The action can be any 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.
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"
}
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 options. Tradovate uses a specific format to represent them by combining the Stock ticker symbol, Expiration Date, Option Type, and Strike price.
The format is as follows:
[Stock Ticker][Expiration Date][Option Type][Strike Price]
For example
AAPL 221121C00145000
AMZN 221121C00250000
MSFT 221231P00220000
- "AAPL" is the stock ticker symbol for Apple IncAmazon.com Inc.
- "221121" represents the expiration date of the options contract in the format of YYMMDD(2022 November,21).
- "C" indicates a call option, and "P" indicates a put option.
- "145",”250”,”220” are the respective strike prices of the call options.
Action
The signal action indicates the type of trade to be triggered. The action can be any 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 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.
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"
}